Payment GatewaysAirwallex

Airwallex

Connect Airwallex to PayLexer to accept multi-currency payments across Asia Pacific, Europe, North America, and beyond.

Airwallex is a global payments and financial platform headquartered in Singapore. It operates across APAC, Europe, the UK, and the US, providing multi-currency wallets and a comprehensive suite of financial services to support global business operations.

  • Supported Regions (Merchant Accounts): Asia Pacific, Europe & UK, North America, Middle East & Africa, and other regions - view full list

  • Supported Currencies: 130+ currencies for payment acceptance, 90+ currencies for local payouts - view full list

Supported Features

  • One-time payments

  • Refunds

  • Real-time payment status updates

  • Multi-currency support

Before You Start

Make sure you have:

Looking for a different payment processor? View all supported gateways →

Configuring Airwallex

You need a Client ID, API Key, and Account ID from Airwallex for this integration.

Getting API Credentials

Log in to Airwallex

Log in to your Airwallex Dashboard.

Navigate to API Keys

Go to Settings → Developers → API Keys and click + New scoped API key.

Create and copy your key

Enter an API key name, select account-level permission and the relevant account(s), then click Create. Copy the Client ID and API Key.

Find your Account ID

In the Airwallex sidebar, go to Settings and scroll down to the Accounts section. Click on the account whose ID you need - a panel will slide open from the right displaying the Account ID. Copy it.

Airwallex provides separate credentials for Test and Live modes. Make sure to copy the correct credentials for your environment.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Log in to your PayLexer dashboard and navigate to Payment Gateways → Airwallex.

Enter your credentials

Paste the Client ID, API Key, and Account ID you copied from Airwallex.

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / Production (Mandatory)Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)Used for testing only. No real money is processed.

How PayLexer selects credentials:

  • Debug/Test mode ON → Test credentials are used

  • Debug/Test mode OFF → Live credentials are used

Test and save

Click Test Connection to verify your credentials, then click Save Configuration.

Configuring Webhooks (Mandatory)

Webhooks are essential for processing refunds, chargebacks, and subscription events. Make sure to configure them in your Airwallex dashboard.

Benefits of Webhooks:

  • Instant payment status updates

  • Automatic refund processing

  • Chargeback and dispute notifications

  • Subscription event handling

Open Airwallex Webhooks

Log in to Airwallex and go to Settings → Developers → Webhooks. Click + New webhook.

Configure the webhook

Enter a Webhook name, select account-level permissions, then copy the Webhook URL from PayLexer and paste it into the Notification URL field. Click Create.

Copy Webhook Secret

Copy the Webhook Secret that Airwallex generates.

Save in PayLexer

Paste the Webhook Secret into PayLexer, then click Save Configuration.

Payment Method Display Settings

Choose which payment method icons appear on your checkout page to indicate accepted payment methods.

  • Select up to 4 icons from the available options (Visa, Mastercard, American Express, Discover, JCB, UnionPay, and more).

  • Click Reset to Default to restore the original selection.

  • The Live Checkout Preview at the bottom of the section shows exactly how the icons will appear under the Airwallex option on your checkout page.

Click Save Configuration after making your selection.

Integrate Airwallex to Your Website

If you have already added and configured your site, you can enable Airwallex in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Enable Airwallex

Click the checkbox to enable Airwallex for the website.

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Best Practices

  • Test in sandbox before enabling Production mode

  • Validate the first live transaction

  • Confirm webhooks are working

  • Monitor the gateway dashboard for failed payments

  • Keep API keys and secrets secure

  • Use separate Test and Production credentials

  • Use only official Airwallex test cards during testing

FAQs

Still Have Questions?

Was this page helpful?