Overview
All international SWIFT payouts require compliance document submission before funds are processed. Payouts remain on hold until documents are submitted and approved by our compliance team.
Why document verification?
International transfers via SWIFT require additional compliance documentation to meet regulatory requirements. This verification process ensures all cross-border payments are properly documented and compliant with international banking standards.
Payout flow for SWIFT
When you create a SWIFT payout, the flow is:
- Payout created → Status is
on_hold - Waiting for documents →
tracking_documents.status: waiting_documents - Documents submitted →
tracking_documents.status: compliance_reviewing - Compliance approved → Payout proceeds to
processing, fiat is sent - Compliance rejected → Status returns to
waiting_documents, submit new documents
Providing documents upfront
You can skip the waiting step by providing documents when creating the quote:
When documents are provided upfront, the payout is created directly in compliance_reviewing status.
Submit payout documents endpoint
Fields:
| Field | Type | Required | Description |
|---|---|---|---|
transaction_document_type | string | Yes | invoice, contract, purchase_order, delivery_slip, customs_declaration, bill_of_lading, first_party, others |
transaction_document_id | string | Conditional | Document identifier (e.g., invoice number). Not required when transaction_document_type is first_party |
transaction_document_file | string | Conditional | URL to the uploaded document. Not required when transaction_document_type is first_party |
description | string | No | Payment description/memo (max 128 chars) |
Tracking documents field
All payout responses and webhooks now include tracking_documents:
Status values
| Status | Description |
|---|---|
waiting_documents | Awaiting document submission |
compliance_reviewing | Documents submitted, under review |
null | Documents approved, payout processing |
Step values
| Step | Description |
|---|---|
processing | Document verification in progress |
completed | Document verification complete |
Webhook examples
Documents submitted
Compliance approved
Compliance rejected
Timeouts
| Event | Timeout |
|---|---|
| Document submission | 30 days from payout creation |
| Compliance review | 8 days from document submission |
Accepted documents
- Invoice
- Contract
- Purchase Order
- Delivery Slip
- Customs Declaration
- Bill of Lading
- First Party
- Others
Important: Documents must show the relationship between the sender and the receiver. If the document doesn't clearly establish this relationship, the payment will be rejected.
First party payouts
If you are sending funds to your own bank account (i.e., the sender and the receiver are the same person or entity), use first_party as the transaction_document_type. When first_party is selected, transaction_document_id and transaction_document_file are not required.
This is common when consolidating funds across your own accounts internationally.