Integration checklist

Set up your demo Airwallex account using the following guidelines and get started with testing.

API keys

• Log into the demo Airwallex web app and generate test API keys and obtain the unique client ID to make API calls. Note that if you have multiple accounts, you will need demo API keys for each account.

Web app configuration

• Configure webhooks on the demo Airwallex web app . Follow the getting started with webhooks guide and review the webhook events you can listen to.

Integration

• Use demo API endpoints for your integration: https://api-demo.airwallex.com/api/v1/
• Deposit tests (see Simulate deposits to your Global Account).
• Micro-deposit tests for Linked Accounts: Call POST /api/v1/linked_accounts/{id}/verify_microdeposits and use 0.01 and 0.02 in the amounts parameter to successfully verify the Linked Account.
• Webhook tests: Ensure your subscribed webhook events are received and managed in your integration.
• Test calling Payouts, Beneficiaries, and Payers endpoints. To learn more about simulating payout transitions, see Simulate payout status transition to learn more about how to push forward payout statuses in demo environment to test more scenarios.
• Test the APIs for onboarding connected accounts. See Simulate connected account status transition.

Reporting

• Download reports from Airwallex to learn about what data is available for your reporting. Learn more about our financial reports API and balance activity reports API
• Download Global Account statements from Airwallex, see Account statements API
• If you decide to download reports programatically, use demo endpoints https://api-demo.airwallex.com/api/v1/

Set up your production Airwallex account using the following guidelines and get started with transacting live.

API keys

• Log into the production Airwallex web app to generate production API keys and obtain the unique client ID to make API calls. Note that if you have multiple accounts, you will need production API keys for each account.

Web app configuration

• Configure webhooks on the production Airwallex web app . Follow the getting started with webhooks guide and review the webhook events you can listen to.

Integration

• Update demo API endpoints to point to the production URLs: https://api.airwallex.com/api/v1/
• Deposit tests: We highly recommend you replicate the demo deposit tests in the production environment to ensure your integration is working correctly. You can use nominal transaction amounts (> $10) for live testing.
• Webhook tests: Ensure your subscribed webhook events are received and managed in your integration.
• Payout tests: We highly recommend you perform production testing for the endpoints you wish to use to ensure your integration is working correctly.

Reporting

• If you are downloading reports programmatically, update to production endpoints https://api.airwallex.com/api/v1/