Airwallex Integration

What is this page about: How to connect your Airwallex account to Light so you can send domestic and international payments straight from your Airwallex virtual bank accounts, and how to manage that connection once it's live.

On this page

• Integration capabilities
• Prerequisites
• Set up the integration
• Manage your connection
• Make a payment and retry a failed one
• Fees
• Troubleshooting
• Related articles

Airwallex is a multi-currency payments platform. Light connects to it so you can pay bills directly from your Airwallex virtual bank accounts, without leaving Light.

No fees from Light. Light charges nothing to set up or use the Airwallex integration. Airwallex's own fees still apply. See the Airwallex pricing page.

# Integration capabilities

• Outgoing payments. Send domestic and international (SWIFT) payments from your Airwallex virtual bank accounts.
• Multiple accounts. Link one Airwallex bank account per currency.
• Automatic status checks. Light checks payment status every 15 minutes.

# Prerequisites

Before you connect Airwallex, have these ready:

1. An active Airwallex account.
2. Your Client ID and API key, from the Airwallex dashboard.
3. An API key with access to the Airwallex entity that matches the Light company entity of the bank accounts you're mapping. Light recommends an Admin key. A Scoped key works too, but may not cover the permissions the connection needs.
4. At least one Airwallex bank account already set up in Light (steps below).

# Add an Airwallex bank account in Light

1. In Light, go to Settings (gear icon) → Bank accounts.

2. Click + Add account.

3. Fill in:

   • Entity: the entity that owns the account.
   • Bank Country: the account's country.
   • Name: the display name shown when you pick this account.
   • Bank provider: set to Airwallex.
   • Currency: the account's currency. Confirm it matches your Airwallex account balance now: Airwallex validates the currency when a payment goes out, and rejects a mismatch with an ACCOUNT_CURRENCY_MISMATCH error.

4. Click Add.

# Set up the integration

1. In Light, go to Settings (gear icon) → Integrations → Add Integration → Airwallex.

2. Enter your Client ID and API key.

3. Under Bank Accounts, link the Light accounts you want on this connection:

   • One account per currency.
   • Toggle each account Active or Inactive.
   • Click + Add another bank account for more.

4. Click Create.

Light validates your credentials against Airwallex immediately. Once that check passes, the connection is ready to use.

# Manage your connection

Find all your Airwallex connections under Settings (gear icon) → Integrations → Airwallex.

Rotate your API key or change bank account mappings:

1. Select the connection.
2. To rotate the key, click the Edit API key pencil icon, enter the new key, and click Save.
3. To change bank account mappings, add or remove accounts, then click Save Changes.

Disable a bank account (stop payments without deleting the connection):

1. Toggle the account to Inactive.
2. Click Save Changes.

This blocks new payments, including scheduled ones that haven't reached their payment date yet. The connection and its history stay intact, and you can reactivate the account any time.

If you disable an account right after a payment goes out, Light can't retrieve that payment's status. Wait for status confirmation before disabling, where you can.

Delete a connection entirely:

1. Select the connection.
2. Click Delete Connection.
3. Confirm by clicking Delete.

This removes every bank account mapping tied to that connection. The same status-retrieval limit applies to any payment still in flight when you delete.

# Make a payment and retry a failed one

On a bill's payment details page, select the Airwallex connection from Pay from Account.

Light checks for a status update every 15 minutes after the payment goes out.

If a payment fails after Airwallex has already accepted the transfer, the bill returns to Unpaid with a failure indicator, and a Retry payment action appears in the three-dot menu on the bill details page.

1. Click Retry payment. Light warns that funds may already have left your account before the failure was reported.
2. Check with your bank that no funds moved before you retry. Retrying a payment that already went out sends it twice.
3. Once confirmed, click I have verified, retry. Light resubmits the payment and shows a confirmation toast.

# Fees

Light doesn't charge integration or transaction fees for Airwallex. Airwallex's own fees apply on top. Check the Airwallex pricing page for current rates.

# Troubleshooting

"Invalid credentials" error. Check your Client ID and API key against the Airwallex dashboard. Confirm the key hasn't expired or been revoked.

"Bank account not valid" error. The account needs to be a virtual bank account with Airwallex set as the provider. Contact support if you need help setting one up.

Payments not processing. Check the bank account mapping is Active, confirm your Airwallex account has enough funds, and check the beneficiary details are correct.

# Related articles

• Integrations overview
• Bank integrations overview
• Stripe integration
• Multi-currency revenue recognition
• Scheduling and Releasing Payments
• Multi-Currency Payments

Also searched as: Connect Airwallex to Light, Airwallex API key setup, SWIFT payments from Light, Airwallex currency mismatch, retry failed Airwallex payment, disable or delete Airwallex connection, Airwallex fees.