Skip to main content
Ctrl+K
FraudTwin documentation is versioned. Check the version selector before copying an API example.

FraudTwin

  • Quickstart
  • Installation and support
  • Choose your path
  • Getting started with FraudTwin
  • Visualization and exploration
    • Core workflows
    • Production ML and reliability
    • Graph analytics
    • Streaming and Kafka reliability
    • Operations and observability
    • Advanced experiments
    • Build and evaluate
    • Integrate and serve
    • Operate and repair
    • Extend and release
    • Core concepts
    • Determinism and reproducibility
    • Data model and lifecycle
    • Point-in-time data and labels
    • Fraud, graphs, and data quality
    • Architecture and trust boundaries
    • Python API reference
    • Configuration parameter reference
    • CLI reference
    • Data contracts
    • Verified capabilities
    • Glossary
    • Troubleshooting
    • Migration guides
    • Compatibility and support policy
    • Development guide
    • References and related work
    • FraudTwin documentation
  • GitHub
  • Quickstart
  • Installation and support
  • Choose your path
  • Getting started with FraudTwin
  • Visualization and exploration
  • Core workflows
  • Production ML and reliability
  • Graph analytics
  • Streaming and Kafka reliability
  • Operations and observability
  • Advanced experiments
  • Build and evaluate
  • Integrate and serve
  • Operate and repair
  • Extend and release
  • Core concepts
  • Determinism and reproducibility
  • Data model and lifecycle
  • Point-in-time data and labels
  • Fraud, graphs, and data quality
  • Architecture and trust boundaries
  • Python API reference
  • Configuration parameter reference
  • CLI reference
  • Data contracts
  • Verified capabilities
  • Glossary
  • Troubleshooting
  • Migration guides
  • Compatibility and support policy
  • Development guide
  • References and related work
  • FraudTwin documentation
  • GitHub

Documentation

  • Getting started

    • Quickstart
    • Installation and support
    • Choose your path
  • Tutorials

    • Getting started with FraudTwin
      • Getting Started with FraudTwin
      • Configure a Simulation
      • Explore Payments and Lifecycle Events
      • Explore Fraud and Delayed Labels
    • Visualization and exploration
      • Visualize payment time, space, and lifecycle behavior
      • Compare Fraud Scenarios, Difficulty, and Camouflage
      • Explore ML-ready distributions, correlation, and embeddings
    • Core workflows
      • From Events to a Trustworthy ML Dataset
      • Investigate and Stress-Test Fraud Scenarios
      • Build a Reproducible Fraud Benchmark
    • Production ML and reliability
      • Build a Simple Fraud Scoring Model
      • Train, evaluate, and track a fraud model
      • Promote and serve a model locally
      • Detect data, domain, and concept shift
      • Promote, reject, and roll back model versions
      • Measure drift by operational segment
    • Graph analytics
      • Investigate fraud with temporal graph exports
      • Build and evaluate point-in-time graph features
    • Streaming and Kafka reliability
      • Publish contracts and inspect Kafka delivery semantics
      • Recover from Kafka outages and duplicate delivery
      • Test Avro compatibility and schema evolution
    • Operations and observability
      • Audit quality faults and build observable projections
      • Materialize a lakehouse snapshot and verify it
      • Resume a scale run from a checkpoint
      • Repair damaged data and replay a bounded interval
      • Persist PostgreSQL rows idempotently
      • Verify Iceberg projections and catalog health
    • Advanced experiments
      • Calibration and counterfactual fraud experiments
      • Campaign dynamics and observable/oracle graph investigation
      • External predictions, temporal backtesting, and feature shift
      • Scale benchmarking, payment reconciliation, and experiment packaging
  • How-to guides

    • Build and evaluate
      • Configuration
      • Data and evaluation workflows
      • ML evaluation methodology
      • Model lifecycle: from simulation to service
      • Data, domain, and concept shift
    • Integrate and serve
      • Production serving reference
      • Integration runbooks
      • Kafka reliability and event-time correctness
      • Spark Structured Streaming
    • Operate and repair
      • Data-quality incidents and replay
      • Graph and benchmark workflows
      • Scale operations
    • Extend and release
      • Extension SDK
      • FraudTwin — Release Readiness & Integration Roadmap
      • Release and benchmark evidence
  • Explanation

    • Core concepts
    • Determinism and reproducibility
    • Data model and lifecycle
    • Point-in-time data and labels
    • Fraud, graphs, and data quality
    • Architecture and trust boundaries
  • Reference

    • Python API reference
      • Typed API cookbook
      • Generation
      • Configuration
      • Data and machine learning
      • Graph
      • Advanced simulation
      • Integrations
      • Benchmarks, quality, and observability
      • Module API reference
    • Configuration parameter reference
    • CLI reference
    • Data contracts
    • Verified capabilities
  • Resources

    • Glossary
    • Troubleshooting
    • Migration guides
    • Compatibility and support policy
    • Development guide
    • References and related work
  • References and related work

References and related work#

Level: Expert

You will: find the standards, libraries, papers, and projects that inform

FraudTwin’s design without treating them as runtime dependencies. Before you start: the Architecture guide.

Services: None.

FraudTwin is released under the Apache License 2.0.

These references informed FraudTwin’s design. The repository does not bundle copied proprietary source code or external datasets; generated records are synthetic and produced by FraudTwin. Third-party dependencies and referenced works remain subject to their own licenses and terms.

  • Mothilal, Sharma & Tan, Explaining Machine Learning Classifiers through Diverse Counterfactual Explanations (design reference only) - informed proximity, feasibility, and constrained counterfactual search; no source code, data, or models are copied.

  • DiCE reference implementation (design reference only) - informed pluggable distance and feasibility concepts; FraudTwin does not import or depend on the repository.

Synthetic data and fraud workflows#

  • Fraud Detection Handbook simulator (handbook) - informed deterministic customer profiles, temporal payment behavior, rule-based fraud scenarios, and the legitimate baseline used for hard negatives.

  • Fraud Detection Handbook validation strategies (handbook) - informed point-in-time features, delayed-label gaps, future-only evaluation windows, and rolling backtests.

  • Vasquez et al., The Hidden Cost of Fraud (paper) - motivated positive-unlabeled handling for fraud that remains undetected.

  • He et al., Identifying Labeling Mechanism in Positive-Unlabeled Learning under Unknown Class Prior (paper) - informed selection-dependent labeling controls.

  • PaySim (repository and simulator) - provided comparison points for synthetic mobile-money behavior and aggregate calibration without importing its schemas or data.

  • SynthFin Core (repository) - provided practical comparison points for behavioral enrichment, fraud scenarios, and fraud-pattern generation.

Payment and financial references#

  • TigerBeetle financial accounting and two-phase transfers (technical references) - informed double-entry ledger invariants and authorization-hold, post, and void semantics.

  • Stripe manual capture, PaymentIntent lifecycle, and disputes (public API documentation) - informed the card authorization, capture, reversal, refund, and chargeback lifecycle abstractions.

  • Banco Central do Brasil Pix initiation standards, Pix/SPI technical documents, and the Pix timing manual (official standards) - informed the Pix-like lifecycle and timing model without claiming to reproduce proprietary SPI internals.

Graph fraud and research papers#

  • Santander Gen-Fraud-Graph (repository) - informed reproducible financial graph generation, fraud-ring patterns, graph exports, and benchmark-oriented scale considerations.

  • NumPy parallel random generation and SeedSequence (technical references) - informed hierarchical deterministic streams for independent scale workers.

  • IBM AMLSim (repository) - provided a comparison point for multi-agent synthetic banking graphs and known AML/fraud patterns.

  • Haghighi et al., Beyond pairwise relationships: a transformer-based hypergraph learning approach for fraud detection (paper) - motivated higher-order graph relations and the separation of observable structure from latent fraud truth.

  • Prasetya et al., A multi-rounded adversarial scenario for graph-based promo fraud detection (paper) - informed evolving, multi-round difficulty and adversarial graph stress controls.

  • Fan et al., Fraud learns too (paper) - informed strategic drift and changing fraud-network structure as future-facing stress dimensions.

  • GRAD: Guided Relation Diffusion Generation for Graph Augmentation in Graph Fraud Detection (paper) - informed relation-level augmentation and benign-looking graph support events.

  • Fraud detection based on GNNs with local augmentation and adaptive relation aggregation (paper) - informed the distinction between feature camouflage and relation camouflage controls.

  • FRAUDAR: Graph-based fraud detection in the face of camouflage (paper) - provided the foundational relation-camouflage threat model for making fraudulent structure resemble legitimate activity.

Engineering references#

  • scikit-learn model evaluation - informed ranking, threshold, calibration, and classification metrics.

  • MLflow Tracking - informed optional experiment lineage and model-artifact logging.

Reference calibration#

  • SDV data quality reports and SDMetrics quality reports - informed aggregate distribution, pair-trend, cardinality, and fidelity-report concepts. FraudTwin stores deterministic summaries rather than source rows.

  • PaySim - informed aggregate calibration of simulation parameters while retaining domain-specific causal payment rules.

Advanced Campaign Dynamics references#

  • Prasetya et al., A multi-rounded adversarial scenario for graph-based promo fraud detection - evolving campaign structure.

  • Fan et al., Fraud learns too - structural drift and perturbation concepts.

  • Haghighi et al., Beyond pairwise relationships - higher-order fraud relationships.

  • Python Packaging User Guide, Pydantic documentation, and pytest documentation - informed package layout, typed configuration validation, and deterministic regression testing.

Next#

Return to Architecture to connect these references to the design, or use Integrate and serve for implementation routes.

Related#

  • Development

  • Compatibility

  • Release evidence

previous

Development guide

next

FraudTwin documentation

On this page
  • Synthetic data and fraud workflows
  • Payment and financial references
  • Graph fraud and research papers
  • Engineering references
  • Reference calibration
  • Advanced Campaign Dynamics references
  • Next
  • Related
Edit on GitHub

© Copyright 2026, FraudTwin contributors.

Created using Sphinx 8.2.3.

Built with the PyData Sphinx Theme 0.21.0.