# Fin.com

- [Welcome](https://developer.fin.com/index.md): Fin.com's Orchestration API: move money between fiat and stablecoin, across borders, through one integration.
- [Glossary](https://developer.fin.com/guides/get-started/glossary.md): The core concepts behind the Fin.com API: customers, virtual accounts, beneficiaries, webhooks, coverage, and catalogue data.
- [Fin.com Setup Guide](https://developer.fin.com/guides/get-started/fin-com-setup-guide.md): How to get onboarded, sign in to the Orchestration Dashboard, and issue your first API keys.
- [Coverage & Capabilities](https://developer.fin.com/guides/coverage/coverage-and-capabilities.md): Fin.com supports payouts and payins (on-ramps and off-ramps) across several global corridors, and is moving fast to add new corridors and increase our reach.
- [Supported Rails and Currencies](https://developer.fin.com/guides/coverage/supported-rails-and-currencies.md): Stablecoin and blockchain network pairs, fiat rails and currencies, and the supported combinations for on-ramp (Payin) and off-ramp (Payout) transfers.
- [Onboarding Individual Customers](https://developer.fin.com/guides/customers-and-compliance/onboarding-individuals.md): Complete guide to onboarding individual customers with personal details, financial profiles, and identity verification
- [Onboarding Business Customers](https://developer.fin.com/guides/customers-and-compliance/onboarding-businesses.md): Complete guide to onboarding business clients with company details, financial profiles, addresses, and associated parties.
- [Responding to RFIs](https://developer.fin.com/guides/customers-and-compliance/responding-to-rfis.md): How Fin.com requests additional customer information, where the RFI payload appears, and how to submit a response with the Patch Customer RFI endpoint.
- [Entity-Wise Document Requirement](https://developer.fin.com/guides/customers-and-compliance/entity-wise-document-requirement.md)
- [Individual Identifying Documents](https://developer.fin.com/guides/customers-and-compliance/individual-identifying-documents.md): Document requirements for individual customers and for the associated parties of a business customer.
- [Individual Tax ID Documents](https://developer.fin.com/guides/customers-and-compliance/individual-tax-id-documents.md): The following lists tax ID types that Fin.com will accept for Individuals and associated parties by region.
- [Business Tax ID Documents by Region](https://developer.fin.com/guides/customers-and-compliance/business-tax-id-documents-by-region.md): The following lists tax ID types that Fin.com will accept for businesses by region.
- [Business Industry Codes](https://developer.fin.com/guides/customers-and-compliance/business-industry-codes.md)
- [High Risk Activities](https://developer.fin.com/guides/customers-and-compliance/high-risk-activities.md): Understanding disclosure requirements and prohibited activities for business customers
- [Guidance on Nested Payments & Onboarding](https://developer.fin.com/guides/customers-and-compliance/nested-payments-and-onboarding.md): How Fin handles nested payments & onboarding
- [SLAs for Compliance](https://developer.fin.com/guides/customers-and-compliance/sla-for-compliance.md): Onboarding · Support availability · Query response · RFI handling. Version 2.0 · September 2026
- [Beneficiary Onboarding Guide](https://developer.fin.com/guides/beneficiaries/beneficiary-onboarding.md)
- [Bank Account & Routing Number Validation Rules](https://developer.fin.com/guides/beneficiaries/bank-account-and-routing-validation-rules.md): Allowed values for bank account and routing schemes when creating a beneficiary.
- [Sender & Receiver Relationships](https://developer.fin.com/guides/beneficiaries/sender-and-receiver-relationships.md): Understanding relationship types between senders and beneficiaries for compliant transactions
- [Sending Your First Payout](https://developer.fin.com/guides/beneficiaries/sending-your-first-payout.md): Understand the payout modalities Fin.com supports, how each one works, and which one applies to the beneficiary you onboarded.
- [Creating a Virtual Account](https://developer.fin.com/guides/virtual-accounts/creating-a-virtual-account.md): How to issue a virtual account for a customer, follow it to ACTIVE, and receive the first deposit as stablecoin.
- [Receiving the First Deposit](https://developer.fin.com/guides/virtual-accounts/receiving-the-first-deposit.md): How to share a virtual account's deposit instructions, what arrives at your destination wallet, and how to reconcile it.
- [Verifying Webhooks](https://developer.fin.com/guides/webhooks/verifying-webhooks.md): Learn how to verify webhook signatures to ensure authenticity and security
- [Event Structure](https://developer.fin.com/guides/webhooks/event-structure.md): The shape of every Fin.com webhook payload, the events you can subscribe to, and the status values each one carries.
- [Funding Your Balance](https://developer.fin.com/guides/move-money/funding-your-balance.md): Learn how to fund your Fin.com balance to enable transfers and payouts to beneficiaries on behalf of your customers
- [How USD Features Work for a Customer](https://developer.fin.com/guides/move-money/how-usd-features-work-for-a-customer.md)
- [Processing Windows & Cutoff Times](https://developer.fin.com/guides/operations/processing-windows-and-cutoffs.md): Cutoff times and settlement windows across fiat and crypto rails.
- [Bank Holidays 2026](https://developer.fin.com/guides/operations/bank-holidays-2026.md): Banking partner holiday schedule for US and Singapore rails in 2026.
- [Getting Started](https://developer.fin.com/guides/orchestration-dashboard/get-started.md): Guide on getting started with the Fin.com Orchestration Dashboard.
- [Creating a Virtual Account and Receiving Your First Deposit](https://developer.fin.com/guides/orchestration-dashboard/creating-a-virtual-account.md): How to set up a virtual account for a customer in the Dashboard, share the deposit details, and watch the first payment settle.
- [Creating Your First Beneficiary and Payout](https://developer.fin.com/guides/orchestration-dashboard/creating-your-first-beneficiary.md): How to add a beneficiary in the Dashboard, whether you are paying out to a bank account or an e-wallet, and how the payout then works.
- [Introduction - Fin Crypto Orchestration](https://developer.fin.com/guides/crypto-orchestration/introduction.md)
- [Legends & Concepts](https://developer.fin.com/guides/crypto-orchestration/legends-and-concepts.md)
- [Transit Payment Webhooks](https://developer.fin.com/guides/crypto-orchestration/transit-payment-webhooks.md)
- [Definition of Statuses](https://developer.fin.com/guides/crypto-orchestration/definition-of-statuses.md)
- [ByBit](https://developer.fin.com/guides/crypto-orchestration/integration-types/bybit.md)
- [Pass Through](https://developer.fin.com/guides/crypto-orchestration/integration-types/pass-through.md)
- [Kraken](https://developer.fin.com/guides/crypto-orchestration/integration-types/kraken.md)
- [OKX](https://developer.fin.com/guides/crypto-orchestration/integration-types/okx.md)
- [Issue a Token](https://developer.fin.com/api-reference/authentication/issue-a-token.md): Generate an access token using client credentials
- [Refresh a Token](https://developer.fin.com/api-reference/authentication/refresh-a-token.md): Generate a new token pair based on a refresh token.
- [Create Individual Customer](https://developer.fin.com/api-reference/customers/create-individual-customer-v2.md): Create a new individual customer with verification details, basic info, address, and financial profile.
- [Attach Documents to Individual Customer](https://developer.fin.com/api-reference/customers/attach-documents-to-individual-customer-v2.md): Attach identifying and address documents to an existing individual customer, using separate identifying_documents and address_documents arrays. Documents are processed asynchronously.
- [Create Business Customer](https://developer.fin.com/api-reference/customers/create-business-customer-v2.md): Create a new business customer with full KYB profile, associated parties (UBOs/directors), compliance data, and optionally holding structure and public listing details.
- [Attach Documents to Business Customer](https://developer.fin.com/api-reference/customers/attach-documents-to-business-customer-v2.md): Attach formation, ownership, and supporting documents to an existing business customer. Documents are categorised into three arrays: formation_documents, ownership_documents, and supporting_documents.
- [Attach Documents to Associated Party](https://developer.fin.com/api-reference/customers/attach-documents-to-associated-party-v2.md): Attach identifying documents and address documents for one or more associated parties of a business customer, using separate identifying_documents and address_documents arrays. Multiple ID documents are allowed per party.
- [Get Customer Details](https://developer.fin.com/api-reference/customers/get-customer-details-v2.md): Retrieve detailed information for a specific customer
- [List Customers](https://developer.fin.com/api-reference/customers/list-customers-v2.md): Retrieve a list of customers filtered by type
- [Get Customer Capabilities](https://developer.fin.com/api-reference/customers/get-customer-capabilities.md): Returns the on-ramp and off-ramp capabilities available for a customer, including the supported rails and their activation status for each currency and corridor.
- [Upload Document](https://developer.fin.com/api-reference/customers/upload-document.md): Upload customer documents using multipart/form-data. Files can be uploaded with arbitrary field names (e.g., poa, poi, passport, file1, etc.)
- [Patch Customer RFI](https://developer.fin.com/api-reference/customers/patch-customer-rfi.md): Submit an RFI response for an individual or business customer. You must pass only the fields and documents specified in the RFI. Submitting data that was not requested will trigger an error.
- [Create Beneficiary V3](https://developer.fin.com/api-reference/beneficiaries/create-beneficiary-v3.md): Create a new beneficiary for payments and transfers. Supports bank accounts and e-wallets as destination types.
- [Create Beneficiary V2](https://developer.fin.com/api-reference/beneficiaries/create-beneficiary-v2.md): Create a new beneficiary account for payments and transfers
- [List Available Countries](https://developer.fin.com/api-reference/beneficiaries/list-available-countries.md): Retrieve a list of countries supported for beneficiary creation with available payment methods and phone validation rules
- [List Bank Identifiers](https://developer.fin.com/api-reference/beneficiaries/list-bank-identifiers.md): Retrieve a list of available banks or e-wallet providers for a specific country and method type
- [List Bank Branch Identifiers](https://developer.fin.com/api-reference/beneficiaries/list-bank-branch-identifiers.md): Retrieve a list of available branches for a specific bank or payment method
- [Fetch Beneficiary Details](https://developer.fin.com/api-reference/beneficiaries/fetch-beneficiary-details-v2.md): Retrieve detailed information for a specific beneficiary. Returns structured data for bank accounts, e-wallets, and external crypto wallet destinations.
- [List Beneficiaries For a Customer](https://developer.fin.com/api-reference/beneficiaries/list-beneficiaries-for-a-customer.md): Retrieve all beneficiaries associated with a specific customer
- [Update Beneficiary Active Status](https://developer.fin.com/api-reference/beneficiaries/update-beneficiary-active-status.md): Update the active status of a beneficiary to enable or disable it
- [Upload Beneficiary Documents](https://developer.fin.com/api-reference/beneficiaries/upload-beneficiary-documents.md): Upload one or more documents for a specific beneficiary using multipart/form-data
- [Create Virtual Account V3](https://developer.fin.com/api-reference/virtual-accounts/create-virtual-account-v3.md): Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created. V3 adds `source.bank` so you can choose the banking partner that issues the account, and returns the desti…
- [Create Virtual Account V2](https://developer.fin.com/api-reference/virtual-accounts/create-virtual-account-v2.md): Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created.
- [List Virtual Accounts](https://developer.fin.com/api-reference/virtual-accounts/list-virtual-accounts-v3.md): Retrieve a paginated list of all virtual accounts belonging to a specific customer.
- [Get Virtual Account Details](https://developer.fin.com/api-reference/virtual-accounts/get-virtual-account-details.md): Retrieve the full record for a single virtual account, including the deposit instructions the customer funds the account with and the crypto destination the deposits settle to.
- [Fetch Virtual Account Transactions](https://developer.fin.com/api-reference/virtual-accounts/fetch-virtual-account-transactions.md): Retrieve a paginated list of all transactions for a specific virtual account
- [Create a Transfer V3](https://developer.fin.com/api-reference/transactions/create-a-transfer-v3.md): Initiate a transfer payout to a beneficiary.
- [Create a Transfer](https://developer.fin.com/api-reference/transactions/create-a-transfer.md): Initiate a transfer payout to a beneficiary.
- [Create a Transfer V2](https://developer.fin.com/api-reference/transactions/create-a-transfer-v2.md): Initiate a transfer payout to a beneficiary.
- [Settle a Transfer V3](https://developer.fin.com/api-reference/transactions/settle-a-transfer-v3.md): Settle a transfer payout created with `POST /v3/transactions/transfer-payout`.
- [Settle a Transfer](https://developer.fin.com/api-reference/transactions/settle-a-transfer.md): Settle a previously created transfer payout
- [Settle a Transfer V2](https://developer.fin.com/api-reference/transactions/settle-a-transfer-v2.md): Settle a transfer payout created with `POST /v2/transactions/transfer-payout`.
- [Upload Beneficiary Documents](https://developer.fin.com/api-reference/transactions/upload-beneficiary-documents.md): Upload one or more documents for a specific beneficiary using multipart/form-data
- [Execute Batch Transfer V3](https://developer.fin.com/api-reference/transactions/execute-batch-transfer-v3.md): Execute multiple transfer payouts in a single batch operation.
- [Execute Batch Transfer](https://developer.fin.com/api-reference/transactions/execute-batch-transfer.md): Execute multiple transfer payouts in a single batch operation.
- [Fetch Batch Details](https://developer.fin.com/api-reference/transactions/fetch-batch-details.md): Retrieve detailed information about a batch transaction including all items and their statuses
- [Create Quote V3](https://developer.fin.com/api-reference/transactions/create-quote-v3.md): Returns fee and receivable amount estimations for a crypto withdrawal from a Fin.com internal wallet to a customer's external crypto wallet.
- [Create Quote](https://developer.fin.com/api-reference/transactions/create-quote.md): Returns fee and receivable amount estimations for a crypto withdrawal from a Fin.com internal wallet to a customer's external crypto wallet.
- [Execute Quote V3](https://developer.fin.com/api-reference/transactions/execute-quote-v3.md): Executes a quote returned from the Create Quote endpoint, initiating a crypto withdrawal to the beneficiary's external wallet.
- [Execute Quote](https://developer.fin.com/api-reference/transactions/execute-quote.md): Executes a quote returned from the Create Quote endpoint, initiating a crypto withdrawal to the beneficiary's external wallet.
- [List Customer Transactions V3](https://developer.fin.com/api-reference/transactions/list-customer-transactions-v3.md): Returns a paginated list of transactions for a customer, optionally filtered by transaction type.
- [List Customer Transactions](https://developer.fin.com/api-reference/transactions/list-customer-transactions.md): Returns a paginated list of transactions for a customer, optionally filtered by transaction type.
- [List Beneficiary Transactions](https://developer.fin.com/api-reference/transactions/list-beneficiary-transactions.md): Retrieve a paginated list of all transactions for a specific beneficiary
- [Fetch Transaction Details V3](https://developer.fin.com/api-reference/transactions/fetch-transaction-details-v3.md): Returns full details for a transaction by ID, including status, amounts, fees, and settlement data. The populated fields vary based on the transaction type.
- [Fetch Transaction Details](https://developer.fin.com/api-reference/transactions/fetch-transaction-details-v2.md): Returns full details for a transaction by ID, including status, amounts, fees, and settlement data. The populated fields vary based on the transaction type.
- [Fetch Prefunded Balance](https://developer.fin.com/api-reference/balances/fetch-prefunded-balance.md): Retrieve the current prefunded wallet balances
- [Fetch Exchange Rates](https://developer.fin.com/api-reference/fees-and-fx-rates/fetch-exchange-rates.md): Retrieve exchange rates for a specific country or currency.
- [Calculate Exchange Rates](https://developer.fin.com/api-reference/fees-and-fx-rates/calculate-exchange-rates.md): Calculate exchange rates and applicable fees for a transaction.
- [List Occupations](https://developer.fin.com/api-reference/catalogue/list-occupations.md): Retrieve a list of available occupations
- [List Source of Funds](https://developer.fin.com/api-reference/catalogue/list-source-of-funds.md): Retrieve a list of available source of funds
- [List Source of Wealth](https://developer.fin.com/api-reference/catalogue/list-source-of-wealth.md): Retrieve a list of available source of wealth options
- [List Account Purposes](https://developer.fin.com/api-reference/catalogue/list-account-purposes.md): Retrieve a list of available account purposes
- [List Generic Country Codes](https://developer.fin.com/api-reference/catalogue/list-countries.md): Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard
- [List Subdivision Codes: ISO 3166-1 alpha-2](https://developer.fin.com/api-reference/catalogue/list-subdivisions.md): Retrieve a list of subdivision codes for a specific country following ISO 3166-2 standard
- [List Transaction Purposes](https://developer.fin.com/api-reference/catalogue/list-transaction-purposes.md): Retrieve a list of available transaction purposes
- [Create a crypto payment quote](https://developer.fin.com/api-reference/crypto-orchestration/create-a-crypto-payment-quote.md): Generate a fee estimation quote for a transit payment
- [Create a Payment](https://developer.fin.com/api-reference/crypto-orchestration/create-a-payment.md): Create a new payment order for a supported integration type (ByBit, Kraken, OKX, Pass Through)
- [Fetch a Payment](https://developer.fin.com/api-reference/crypto-orchestration/fetch-a-payment.md): Retrieve payment details by payment ID
- [Customer Created](https://developer.fin.com/api-reference/webhooks/customer-created.md): Triggered when a customer is successfully created.
- [Customer Status](https://developer.fin.com/api-reference/webhooks/customer-status.md): Triggered when a customer's status changes during verification.
- [Customer RFI](https://developer.fin.com/api-reference/webhooks/customer-rfi.md): Triggered when the compliance team requests additional information or documents from a customer. Sets the customer status to ACTION_REQUIRED. The payload includes a structured list of what is missing, invalid, or expired, scoped to either the customer or a specific associated party.
- [Beneficiary Created](https://developer.fin.com/api-reference/webhooks/beneficiary-created.md): Triggered when a new beneficiary is created in the system.
- [Beneficiary Status](https://developer.fin.com/api-reference/webhooks/beneficiary-status.md): Triggered when a beneficiary's status changes.
- [Virtual Account Created V2](https://developer.fin.com/api-reference/webhooks/virtual-account-created-v2.md): Triggered when a new V2 virtual account is created for a customer.
- [Virtual Account Status V2](https://developer.fin.com/api-reference/webhooks/virtual-account-status-v2.md): Triggered when a V2 virtual account’s status changes.
- [Transaction Status](https://developer.fin.com/api-reference/webhooks/transaction-status.md): Triggered when a transaction's status changes.
- [Beneficiary Liquidation Deposit](https://developer.fin.com/api-reference/webhooks/beneficiary-liquidation-deposit.md): Triggered when any transfer hits a beneficiary's liquidation address.
- [Batch Transaction Item Status](https://developer.fin.com/api-reference/webhooks/batch-transaction-item-status.md): Triggered when a batch transaction item's status changes after committing a batch.
- [Transit Payment Status](https://developer.fin.com/api-reference/webhooks/transit-payment-status.md): Triggered when a transit payment's status changes through the payment and settlement flow.
- [October 9, 2026](https://developer.fin.com/changelogs/2026-10-09.md): Changelog for October 9, 2026
- [October 2, 2026](https://developer.fin.com/changelogs/2026-10-02.md): Changelog for October 2, 2026
- [September 9, 2026](https://developer.fin.com/changelogs/2026-09-09.md): Changelog for September 9, 2026
- [August 16, 2026](https://developer.fin.com/changelogs/2026-08-16.md): Changelog for August 16, 2026
- [July 14, 2026](https://developer.fin.com/changelogs/2026-07-14.md): Changelog for July 14, 2026
- [June 16, 2026](https://developer.fin.com/changelogs/2026-06-16.md): Changelog for June 16, 2026
- [June 10, 2026](https://developer.fin.com/changelogs/2026-06-10.md): Changelog for June 10, 2026
- [May 01, 2026](https://developer.fin.com/changelogs/2026-05-01.md): Changelog for May 01, 2026
- [April 20, 2026](https://developer.fin.com/changelogs/2026-04-20.md): API Migration Guide — deprecation deadline May 20, 2026
- [April 13, 2026](https://developer.fin.com/changelogs/2026-04-13.md): Changelog for April 13, 2026
- [February 16, 2026](https://developer.fin.com/changelogs/2026-02-16.md): Changelog for February 16, 2026
- [February 11, 2026](https://developer.fin.com/changelogs/2026-02-11.md): Changelog for February 11, 2026
- [February 10, 2026](https://developer.fin.com/changelogs/2026-02-10.md): Changelog for February 10, 2026
- [February 03, 2026](https://developer.fin.com/changelogs/2026-02-03.md): Changelog for February 03, 2026
- [January 25, 2026](https://developer.fin.com/changelogs/2026-01-25.md): Changelog for January 25, 2026
- [January 19, 2026](https://developer.fin.com/changelogs/2026-01-19.md): Changelog for January 19, 2026
- [January 09, 2026](https://developer.fin.com/changelogs/2026-01-09.md): Changelog for January 09, 2026
- [January 02, 2026](https://developer.fin.com/changelogs/2026-01-02.md): Changelog for January 02, 2026
- [December 31, 2025](https://developer.fin.com/changelogs/2025-12-31.md): Changelog for December 31, 2025
- [FAQs](https://developer.fin.com/faqs/index.md): FAQs regarding API integration, sandbox testing, technical capabilities, and others.

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)

## Optional

- [Main Site](https://fin.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.