Cross-border remittances

​

How it works

​

Step-by-step

1. Onboard the sender — Create a customer with identity documents for KYC verification.
2. Create a Virtual Bank Account — Call POST /virtual-bank-account with your business wallet_id and the customer_id. For NGN, the account activates instantly. For USD, GBP, and EUR, wait for the virtual_account.ready webhook before sharing the account details. See the Virtual Bank Accounts guide for currency-specific prerequisites.
3. Collect funds — The sender deposits money into the Virtual Bank Account. The collection method depends on the source currency:
   • CAD: Sender pays via Interac — no API call needed, you receive a collection.completed webhook when funds arrive.
   • NGN, USD, GBP, EUR: Sender transfers to your Virtual Bank Account — you receive a collection.completed webhook when funds settle.
   • Card: You initiate a card charge via POST /collection (card collections only, must be enabled for your business).
4. Preview the cost — Call the Fee breakdown endpoint to calculate the exchange rate, fees, and the exact amount the recipient will receive.
5. Payout to recipient — Create a payout specifying the destination currency, bank account, and amount. Use to_amount to guarantee the recipient receives an exact amount, or from_amount to send from a fixed debit.
6. Track status — Listen for payout.completed or payout.failed webhooks to update your user in real time.

​

Supported corridors

​

APIs used

• Create customer
• Create Virtual Bank Account
• Create payout
• Fee breakdown
• Webhook events