Payment GatewaysAirwallex
Payment Gateways

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 an API Key and Client 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 API Key and Client ID.

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 API Key and Client 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 enable real-time payment updates and significantly improve reliability.

Benefits of Webhooks:

  • Instant payment status updates

  • Automatic refund processing

  • Dispute notifications

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.

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?