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.

Account configuration

• Contact your Airwallex Account Manager to configure your Airwallex demo account for the required issuing capability:
  • Enable Issuing APIs
  • Enable Automatic Conversions
  • Configure your home (primary) currency
  • Enable Refunds in billed currency
  • Enable allowed card type, options include: PREPAID, DEBIT, GOOD_FUNDS_CREDIT or DD_OTA
  • 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 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/
• Create cards: See tutorials for creating business cards and individual cards. Note that for individual cards, when you create a cardholder in the demo 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 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

• If you have webhooks configured on the demo 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 demo 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/