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, others |
transaction_document_id | string | Yes | Document identifier (e.g., invoice number) |
transaction_document_file | string | Yes | URL to the uploaded document |
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
- 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.