Initiate multi-currency global payouts via the Airwallex Payouts API

Steps

1. Create an Airwallex account and enable the Payouts API in your developer settings; obtain a client ID and API key from the Airwallex Dashboard under Developers > API keys.
2. Authenticate via POST /api/v1/authentication/login using your client ID and API key to receive a JWT token valid for a fixed duration — store it securely and refresh before expiry.
3. Create a beneficiary for each payee via POST /api/v1/beneficiaries specifying bank_details (account number, routing code type appropriate for the destination country), entity_type (INDIVIDUAL or COMPANY), and address details.
4. Initiate a payout via POST /api/v1/payments/pay specifying beneficiary_id, source_currency (from your Airwallex wallet), payment_currency (destination currency), amount, and a unique request_id for idempotency.
5. Airwallex performs FX conversion if source and destination currencies differ — check the applicable FX rate via GET /api/v1/rates/retrieve before submitting to confirm margin; Airwallex settles from your source currency wallet.
6. Poll GET /api/v1/payments/{payment_id} or subscribe to payment.created and payment.status_updated webhook events to track payout status through PENDING, PROCESSING, PAID_OUT, or FAILED states.