International Transfer API
International transfers route by corridor, currency, purpose, sanctions policy, and payout partner. High-risk corridors can be held for review before final settlement.
Endpoints
| Endpoint | Method | Auth | Headers | Notes |
|---|---|---|---|---|
Create international beneficiary/payment/api/v1/international/beneficiaries/Save a cross-border payout destination. |
POST | User JWT Authenticated caller |
Authorization: Bearer <user-jwt>Content-Type: application/json |
Sandbox: Supported with sandbox keys and adapters. Production: Available subject to verification, country activation, and provider support. Rate limits: Standard authenticated rate limits |
Create international transfer/payment/api/v1/international/transfers/Initiate a routed cross-border payout after eligibility and risk checks. |
POST | User JWT Authenticated caller |
Authorization: Bearer <user-jwt>Content-Type: application/json |
Status lifecycle: created, pending, processing, successful, failed, reversed, under_review Sandbox: Supported with sandbox keys and adapters. Production: Available subject to verification, country activation, and provider support. Rate limits: Standard authenticated rate limits |