# Vouch

## Docs

- [Introduction to the Vouch Trust Infrastructure SDK](https://vouch-sdk.vercel.app/docs/introduction.md): Discover how Vouch's identity verification, fraud detection, and escrow modules help you build safer, more trusted digital marketplaces.
- [Quickstart — Up and Running with Vouch SDK in 5 Minutes](https://vouch-sdk.vercel.app/docs/quickstart.md): Install vouch-sdk, provision an API key, and make your first identity verification and fraud assessment call in under five minutes.
- [Authentication — Vouch API Keys and Request Security](https://vouch-sdk.vercel.app/docs/authentication.md): Learn how Vouch API keys work, how to generate and rotate them, and how to keep them secure in server-side and client-side environments.
- [Understanding the Vouch Platform: Core Concepts](https://vouch-sdk.vercel.app/docs/concepts/overview.md): Learn how Vouch's three modules — Identity Verification, Fraud Detection, and Escrow — work together to build end-to-end trust in your product.
- [Identity Verification: Documents, Biometrics & Liveness](https://vouch-sdk.vercel.app/docs/concepts/identity-verification.md): Understand how Vouch verifies real-world identity using OCR document parsing, ArcFace face matching, and multi-frame liveness detection.
- [Fraud Detection: Real-Time Risk Scoring & Signals](https://vouch-sdk.vercel.app/docs/concepts/fraud-detection.md): Understand how Vouch scores transactions in real time using device fingerprinting, behavioral signals, and identity data to return a GREEN, AMBER, or RED risk flag.
- [Escrow: Milestone-Based Trust for Buyer & Seller](https://vouch-sdk.vercel.app/docs/concepts/escrow.md): Learn how Vouch holds funds in trust between a buyer and seller, provisions virtual bank accounts, and disburses on milestone confirmation.
- [Installing and Initializing the Vouch SDK in Your App](https://vouch-sdk.vercel.app/docs/sdk/installation.md): Install vouch-sdk via npm, pnpm, or yarn, then initialize the client with your API key to access identity, fraud, and escrow in one place.
- [Vouch SDK Identity Verification: Modal and File Upload](https://vouch-sdk.vercel.app/docs/sdk/identity.md): Use the Vouch SDK to verify user identity through a hosted iframe modal or direct file upload, with liveness detection and document match scoring.
- [Vouch SDK Fraud Assessment: Score and Flag Transactions](https://vouch-sdk.vercel.app/docs/sdk/fraud.md): Score transactions and user sessions for fraud risk using device signals, VPN detection, and impossible travel analysis before processing payments.
- [Vouch SDK Escrow: Create and Manage Payment Agreements](https://vouch-sdk.vercel.app/docs/sdk/escrow.md): Create milestone-based escrow agreements, run fraud checks before payment, confirm deliverables, and track agreement status through the full lifecycle.
- [Vouch SDK Device Fingerprinting for Fraud Detection](https://vouch-sdk.vercel.app/docs/sdk/fingerprinting.md): Learn how Vouch automatically collects device fingerprints for fraud detection, and how to call getDeviceFingerprint or mock it during testing.
- [Vouch SDK TypeScript Types and Interface Reference](https://vouch-sdk.vercel.app/docs/sdk/typescript-types.md): Complete TypeScript interface reference for vouch-sdk, covering identity, fraud, escrow, configuration types, and all exported SDK interfaces.
- [Implementing a Complete KYC Identity Verification Flow](https://vouch-sdk.vercel.app/docs/guides/kyc-flow.md): Learn how to integrate identity verification into your app using the Vouch SDK modal or a custom UI, and handle verification results correctly.
- [Integrating Real-Time Fraud Assessment into Payment Flows](https://vouch-sdk.vercel.app/docs/guides/fraud-assessment.md): Learn how to call fraud.assess() before payments and escrow funding, interpret risk flags, and implement step-up verification for AMBER-risk transactions.
- [Managing the Full Milestone-Based Escrow Agreement Lifecycle](https://vouch-sdk.vercel.app/docs/guides/escrow-lifecycle.md): Walk through creating a milestone-based escrow agreement, funding it safely, confirming delivery, and handling disbursement from start to finish.
- [Testing Your Vouch SDK Integration From End to End](https://vouch-sdk.vercel.app/docs/guides/testing.md): Use simulation flags and mock utilities to test fraud detection, identity verification, and escrow flows without real documents or live transactions.
- [Error Handling in the Vouch SDK: Codes and Patterns](https://vouch-sdk.vercel.app/docs/resources/error-handling.md): Learn how to handle HTTP errors, identity rejection reasons, and fraud engine edge cases when integrating the Vouch SDK into your application.
- [Nomba Webhook Events & Payment Reconciliation](https://vouch-sdk.vercel.app/docs/resources/webhooks.md): How Vouch uses Nomba webhooks to reconcile payments, handle partial and over-payments, and advance escrow agreements automatically.
- [Nomba Payment Infrastructure](https://vouch-sdk.vercel.app/docs/resources/changelog.md): How Vouch uses Nomba virtual accounts, webhook reconciliation, and automatic overpayment refunds to power escrow funding.
- [Verify User Identity with Document and Selfie](https://vouch-sdk.vercel.app/docs/api/identity/verify.md): Submit a government ID and selfie frames to verify a user's identity. Returns a match score, liveness result, and verified status.
- [Assess Fraud Risk for a Transaction or User](https://vouch-sdk.vercel.app/docs/api/fraud/assess.md): Evaluate the fraud risk of a transaction in real time. Returns a risk score, flag color, triggered signals, and a recommended action.
- [Create an Escrow Agreement — Vouch API](https://vouch-sdk.vercel.app/docs/api/escrow/create-agreement.md): Create a new escrow agreement between a buyer and seller, defining the total amount and milestone breakdown for structured fund release.
- [Assess Payment Risk for an Agreement — Vouch API](https://vouch-sdk.vercel.app/docs/api/escrow/assess-payment.md): Run a fraud and risk check on a funding attempt before releasing a virtual bank account number for buyer payment into escrow.
- [Confirm a Milestone Completion — Vouch API](https://vouch-sdk.vercel.app/docs/api/escrow/confirm-milestone.md): Register a buyer or seller confirmation on a milestone. When both parties confirm, the milestone is marked complete and disbursement is triggered automatically.
- [Retrieve an Escrow Agreement — Vouch API](https://vouch-sdk.vercel.app/docs/api/escrow/get-agreement.md): Fetch the full state of an escrow agreement, including its current status, virtual account number, and the confirmation state of every milestone.
- [Provision a Developer Account — Vouch API](https://vouch-sdk.vercel.app/docs/api/developer/provision.md): Create a new Vouch developer account with an email and password. This is the first step to accessing the API and generating authentication keys.
- [Generate an API Key — Vouch API](https://vouch-sdk.vercel.app/docs/api/developer/api-keys.md): Generate a new API key for your developer account. The full key is shown only once — store it securely in your environment variables before leaving the page.