Log inGet started
Airwallex logo
Home
Online Payments
Treasury
Transactional FX
Payouts
Issuing
Scale
Open Banking
Developer Tools
API Reference
Home
Online Payments
Overview
Starting with paymentsTransaction and settlement modelPricing model
Integration options
Integration OverviewPayment LinksPayment Links APIHosted Payment PageEmbedded ElementsDrop-in ElementMobile SDKNative APIPlugins
ShopifyMagentoWooCommerce
Install the WooCommerce plugin
Spreedly

Install the WooCommerce plugin

This page describes how to install the Airwallex Online Payments plugin for your WooCommerce store.

Before you begin

  • If you have not done so already, submit information about your online store via the Airwallex web app > Payments page to enable Online Payments capabilities and apply for certain payment methods to be enabled on your account.
  • Fill in all the required fields and send the PCI-SAQ-A form to your Airwallex Account Manager. If you are completing the process by yourself, please email the signed version to [email protected].
  • Obtain your Client ID and secret API Key from the Airwallex web app > Developer > API Keys page for your installation configuration. Please make sure you obtain keys for the correct account if you have multiple accounts. For more information, see Manage API keys.

Step 1: Install the plugin

Follow these steps to install the Airwallex Online Payments app for your WooCommerce store.

  1. Go to the Airwallex Online Payments plugin and click Download. Install WooCommerce - Step 1
  2. From your WordPress dashboard, choose Plugins > Add New.Install WooCommerce - Step 2
  3. Click Upload Plugin at the top of the page. WooCommerce - Step 3
  4. Click Choose File, locate the plugin .zip file, then click Install Now.
  5. After the installation is complete, click Activate Plugin to activate the plugin.

Step 2: Configure API settings

After installing and activating the plugin, click Airwallex API settings to configure the authentication details. Install WooCommerce - Step 2

Enter your Client ID and API Key from the Airwallex web app > Developer > API keys page. We recommend that you use a restricted API key to authenticate to the WooCommerce plugin. For information on restricted API keys and how to create them, see Restricted API keys. Install WooCommerce - Step 5a

If you’d like to subscribe to our webhook events, enter the webhook secret key as well. Note that not subscribing to webhooks events won’t impact your plugin experience. See webhook configuration.

Step 3: Enable and configure payment methods

Click Payments or Back to payment overview to see the different ways you can configure your checkout experience. Choose which one to configure based on the payment methods you want to support and the checkout experience you want to provide. WooCommerce - Step 3 - methods

Airwallex - All Payment Methods

This method allows you to provide all the payment methods enabled on your Airwallex account on your WooCommerce store checkout, including cards, Apple Pay, Google Pay, and other local payment methods. It also enables your customers to save a card number on file for future checkouts.

This is the most recommended method if you want to offer payment methods other than just cards and want to offer a speedy checkout for repeat customers.

Woocommerce - step 3 - all payment methods

To set it up:

  1. Select Enable Airwallex Payments to enable this method.
  2. Enter the payment method name and description to be displayed on the payment page in the Title and Description fields.
  3. Once you have configured your API key authentication details, you will see the list of payment methods activated on your account show up in both the Icons to display and Payment methods sections.
  4. Select which payment method Icons to display and choose which Payment methods to enable on your WooCommerce store checkout.
  5. If you are enabling Apple Pay and Google Pay for the first time, please follow the additional set up instructions in the Airwallex web app > Payments > Settings > Apple Pay or Google Pay.
  6. Select the Payment page template for how you would like the checkout module to appear on your checkout page (either side by side to or below your cart information).
  7. Click Save changes to save your configuration.

Checkout experience

At checkout, your customer will see the payment method appear with the title, payment method logos, and description you configured.

Woocommerce - step 3 - all payment methods - checkout exp

Once the payer selects this payment method and clicks Place order they can select a payment method and proceed.

Woocommerce - step 3 - all payment methods - checkout exp - second page

When the payer is checking out while logged in, they can select Save my card for future payments box to save their card details.

Woocommerce - step 3 - all payment methods - check exp - save card

The next time they checkout, they will see the saved card as a payment method. They can skip the step of re-entering their card details and checkout faster by only entering their CVC number.

Woocommerce - step 3 - all payment methods - check exp - CIT

Airwallex - Cards

This method allows you to provide debit and credit card payment methods on your WooCommerce store checkout in an embedded manner. This is recommended for people who only want to offer cards and don’t want an additional click involved in the checkout process.

Install WooCommerce - Step 6a

To set it up:

  1. Select Enable Airwallex Card Payments to enable card payments.
  2. Enter the payment method to be displayed on the payment page in the Title field.
  3. Select the checkout form as Embedded capture immediately to capture the amount as soon as the shopper pays.
  4. Fill in any other relevant configuration. Click Save changes to save your configuration.

Checkout experience

When checking out, your payer will see the Credit card option with all the logos of card schemes enabled on your Airwallex account including Visa, Mastercard, American Express, and UnionPay.

The payer can enter their card number, expiration date, and CVC to pay. Woocommerce - step 3 - credit card - checkout exp

Test mode (Sandbox)

Select Enable sandbox when you configure payment methods to use a demo Airwallex account to test transactions on the WooCommerce store.

Note that you must use your demo account details (Client ID and API key) in your API settings for sandbox testing.

Airwallex provides a sandbox testing account on an as-needed basis. Please contact [email protected] to request a demo account for testing. Provide your Airwallex registered company name and the payment methods you want to test using the demo account.

If you encounter any unexpected behavior, first check your configuration against these steps and retry. Contact [email protected] if you need any help.

Step 4: Test the plugin

You can simulate an end-to-end payment experience by submitting a test transaction in your WooCommerce store. To process live transactions, please ensure you have turned off the test mode (sandbox) environment.

Additional configuration

Webhook configuration

Configure webhooks for your WooCommerce plugin custom callbacks.

  1. Log in to Airwallex Webapp > Developer > Webhooks.
  2. Add a webhook by specifying your notification URL and selecting the relevant webhook events for your business operation. We recommend that you subscribe to the following webhook events as shown below.WooCommerce - webhooks

Risk configuration

Configure risk for your business using these steps.

  1. Log in to your Airwallex Webapp > Payments > Risk. WooCommerce - risk config Step 1
  2. Alter the risk score threshold to trigger risk assessments for suspicious transactions. WooCommerce - risk config Step 2
On this page