Configure Airwallex settings
Enter your API credentials and configure payment features in the Airwallex settings page in Business Manager.
To connect the Airwallex Payments Cartridge to your Airwallex account and control which payment features are available at checkout, configure the Airwallex settings page in Business Manager.
Before you begin
- You have configured SFCC to enable the cartridge.
- You have your Airwallex API credentials (Client ID and API key) for the target environment. To find your credentials, log in to the Airwallex web app and go to Settings > Developer > API keys.
Access the settings page
-
In Business Manager, go to Merchant Tools > Site Preferences > Airwallex Settings.
-
You should see the Airwallex configuration interface.
Configure your credentials
The cartridge supports the Airwallex sandbox and production environments. Configure the credentials for the environment you want to use.
| Setting | Description |
|---|---|
| Environment | Select Sandbox or Production. |
| Client ID | Your Airwallex API Client ID for the selected environment. |
| API Key | Your Airwallex API key for the selected environment. |
| Webhook Secret | The webhook signing secret from your Airwallex account (see Configure webhooks). |
Where to find your credentials
Log in to the Airwallex web app and go to Settings > Developer > API keys. Generate a new API key pair if you do not have one.
Configure payment features
| Setting | Default | Description |
|---|---|---|
| Auto Capture | Enabled | When enabled, payments are automatically captured when the order is placed. Disable for manual capture (for example, capture at fulfillment). |
| Enable Credit Card | Disabled | Enable credit and debit card payments at checkout. |
| Enable Apple Pay | Disabled | Enable Apple Pay express checkout. Requires Apple Pay to be configured in your Airwallex account. |
| Enable Google Pay | Disabled | Enable Google Pay express checkout. Requires Google Pay to be configured in your Airwallex account. |
| Enable Airwallex Analytics | Disabled | When enabled, diagnostic logs are sent to Airwallex to help troubleshoot integration issues. |
Activate payment methods in Airwallex first
Payment methods must be activated in your Airwallex account before enabling them in the cartridge. Log in to the Airwallex web app and go to Payments > Payment methods > Other available payment methods to activate the desired payment methods.
Airwallex environments
| Environment | URL | Usage |
|---|---|---|
| Sandbox | demo.airwallex.com | Pre-production testing with sandbox credentials. |
| Production | airwallex.com | Live transactions with real payment methods. |
We recommend starting with the sandbox environment for initial setup and testing, then switching to production when you are ready to go live.
Next steps
Now that you have configured your Airwallex credentials and payment features, set up webhooks to keep order statuses in sync: