Install the WooCommerce plugin
This page describes how to install the Airwallex Online Payments plugin for your WooCommerce store.
- 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.
Follow these steps to install the Airwallex Online Payments app for your WooCommerce store.
- Go to the Airwallex Online Payments plugin and click Download.
- From your WordPress dashboard, choose Plugins > Add New.
- Click Upload Plugin at the top of the page.
- Click Choose File, locate the plugin .zip file, then click Install Now.
- After the installation is complete, click Activate Plugin to activate the plugin.
After installing and activating the plugin, click Airwallex API settings to configure the authentication details.
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.
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.
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.
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.
To set it up:
- Select Enable Airwallex Payments to enable this method.
- Enter the payment method name and description to be displayed on the payment page in the Title and Description fields.
- 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.
- Select which payment method Icons to display and choose which Payment methods to enable on your WooCommerce store checkout.
- 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.
- 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).
- Click Save changes to save your configuration.
At checkout, your customer will see the payment method appear with the title, payment method logos, and description you configured.
Once the payer selects this payment method and clicks Place order they can select a payment method and proceed.
When the payer is checking out while logged in, they can select Save my card for future payments box to save their card details.
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.
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.
To set it up:
- Select Enable Airwallex Card Payments to enable card payments.
- Enter the payment method to be displayed on the payment page in the Title field.
- Select the checkout form as Embedded capture immediately to capture the amount as soon as the shopper pays.
- Fill in any other relevant configuration. Click Save changes to save your configuration.
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.
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.
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.
Configure webhooks for your WooCommerce plugin custom callbacks.
- Log in to Airwallex Webapp > Developer > Webhooks.
- 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.
Configure risk for your business using these steps.
- Log in to your Airwallex Webapp > Payments > Risk.
- Alter the risk score threshold to trigger risk assessments for suspicious transactions.