Integration checklist

Set up your sandbox account and get started with testing.

API keys

• Log into the sandbox 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 sandbox API keys for each account.

Account configuration

• Contact your Airwallex Account Manager to configure your Airwallex sandbox account for the required issuing capability:
  • Enable Issuing APIs
  • Enable Automatic Conversions
  • Configure your home (primary) currency
  • Enable Refunds in billed currency
  • Enable allowed program type, options include: PREPAID, DEBIT, CREDIT or DEFERRED_DEBIT
  • Configure card creation limit
  • Enable PCI access to access endpoints that retrieve sensitive card data
  • Configure spending transaction limits for the supported currencies

Web app configuration

• Optionally, configure webhooks on the sandbox Airwallex web app . Follow the getting started with webhooks guide and review the webhook events you can listen to.

Integration

• Use sandbox API endpoints for your integration: https://api-demo.airwallex.com/api/v1/
• Create cards: See tutorials for creating commercial cards and consumer cards. Note that for individual cards, when you create a cardholder in the sandbox environment, the cardholder status will be PENDING until Airwallex manually approves the cardholder.
• Issuing transaction tests: See Simulate issuing transactions
• Webhook tests: Ensure your subscribed webhook events are received and managed in your integration.

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
• You can retrieve transactions processed on Airwallex-issued cards using Transactions API.
• If you decide to download reports programatically, use sandbox 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

• If you have webhooks configured on the sandbox account, 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 sandbox API endpoints to point to the production URLs: https://api.airwallex.com/api/v1/
• Create cards in the production environment
• Issuing transaction tests: We highly recommend you replicate the issuing transaction tests in the production environment to ensure your integration is working correctly. You can transact for nominal amounts for live testing.
• Webhook tests: Ensure your subscribed webhook events are received and managed in your integration.

Reporting

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