Disburse marketplace earnings to global sellers via the Airwallex Payouts API
domain: airwallex.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate by calling POST /api/v1/authentication/login with your client ID and API key to obtain a JWT token.
Create a Beneficiary via POST /api/v1/beneficiaries supplying bank details (account number, routing codes) and the beneficiary's entity type and address.
Create a Payment via POST /api/v1/payments/create referencing the beneficiary ID, amount, currency, source currency, and a unique request_id for idempotency.
For FX payments, Airwallex converts at the prevailing rate; optionally lock an FX rate first using the FX rate lock endpoints if your contract includes that feature.
Monitor payment status via GET /api/v1/payments/{payment_id} or subscribe to payment webhooks for status transitions (PENDING, PROCESSING, PAID, FAILED).
Retrieve settlement and fee details from the Airwallex reporting endpoints for reconciliation.
Known gotchas
Beneficiary validation rules vary significantly by country and currency — Airwallex returns specific field-level errors; build a validation layer using Airwallex's beneficiary schema documentation before submitting.
Some corridors require additional beneficiary information (e.g., purpose of payment, source of funds) — check corridor-specific requirements before launch.
FX rates are applied at processing time unless locked; high-value payouts should use rate locking to avoid slippage between quote and settlement.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp