# WooCommerce plugin installation guide

This guide will walk you through installing the [Antom Payments](https://docs.antom.com/ac/plugins/woocommerce.md) plugin for your WooCommerce store.

## Install the plugin

You can download and install plugins from your WordPress or WooCommerce website:

### Through the WordPress website

1.  Log in to WordPress as an administrator.
2.  In the left menu, go to **Plugins** > **Add New**.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/94363dbb-78ba-45ed-aab6-fbdea5b13ab7.png)

3.  Search for **Antom Payments** in the search bar on the right and select **Antom Payments by Atom**.
4.  After reading the relevant information of the plug-in, click **Install and activate**. The system displays that the download is complete, which indicates that the plug-in is installed successfully.

### Through the WooCommerce website

1.  Log in to [WooCommerce](http://woocommerce.com/my-dashboard/) website, click on **Extensions** and select **WooCommerce Marketplace.**

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/56e997c3-1be0-4af0-89b1-64eec0c50b43.png)

2.  In the search bar, type Antom Payments and click on the plugin.
3.  Follow the instructions to install the Antom plugin. Once installed, go to the Antom Dashboard to [Register an account](#884g6).

## Create an Antom account

Follow the steps below to register your Antom account for WooCommerce business. 

> **Note**: Antom account for WooCommerce business has to be created by clicking the **Register new account** button. Account registered in other channels cannot be used for WooCommerce business.

### Step 1: Register an account

After installing and activating the plugin, click **Register new account** on the **Payments** page of the plugin to register an account, or click on this [registration link](https://dashboard.antom.com/global-payments/account/register?bizMode=ISV&isvBizScene=ISO_COMMON&registrationSource=WooCommerce) to register directly.

![1.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2025/png/e8aff72b-13d5-4857-82b4-54b748d3124a.png)

### Step 2: Submit KYC and activate your account

1.  After registering your account, log in to Antom Dashboard，click the **Start** button on the homepage, and follow the on-screen instructions to complete and submit your KYC information. Wait for approval to activate your account.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/fc878466-5016-4e32-89ad-8edbf81a7615.png)

> **Note:** The activation approval process usually takes 1–2 days. Before your account is activated, Antom Dashboard cannot be switched to production mode. You may first test your plugin in the sandbox environment. For details, please refer to [Test the plugin in sandbox](#Dsnpg).

2.  After the account activation is approved, click **Generate key** to obtain the required information for plugin configuration. For detailed steps, refer to [Generate keys](https://docs.antom.com/ac/merchant_service/antom_dashboard.md#D584U).

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/f4e30118-c2e3-4bb3-8133-6d602fab4f3b.png)

### Step 3: Enable payment method

1.  When you receive the account onboarding approval email, log in to the Antom Dashboard and click **Go to Enable** to start configuring your desired payment methods.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/9bf5fd6c-8bcf-4cf7-81ed-2185cd48f3e1.png)

2.  On the Payment method management page, search for your preferred payment methods.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/fcd09730-e54c-4093-9e4e-f22a9a074f61.png)

3.  After selecting the payment method, click **Enable** to activate it. Once you have read the payment method configuration notes, click **Enable** again to confirm activation of the payment method.

| ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/21674ddd-322f-4831-b7dd-f1c53d924d3a.png) | ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/3ad799ab-38c6-4ed1-904b-a8e9046cb64c.png) |
| --- | --- |

4.  Return to the plugin configuration page and enable the corresponding payment methods as needed.

#### Tab: All-in-one payments

Click **Complete setup** on the right side of **Antom Payments** to enter the configuration page. Enable the approved payment method, then click **Save changes** to confirm activation.

| ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/31d2f8bb-b260-483f-bfaf-35b65d9a33a2.png) | ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/bb6d3419-fd84-4432-bbde-0d6c9c239943.png) |
| --- | --- |

Based on the configuration in the WooCommerce admin panel, the checkout page displayed to customers is as follows:

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/7b25933b-480a-47ce-b097-5ba0b5a6df2e.png)

#### Tab: Embedded credit card payments

Click **Complete setup** on the right side of **Credit Card by Antom** to enter the configuration page. Enable the approved payment method, then click **Save changes** to confirm activation.

| ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/f2298f5f-725f-40f4-9d13-6bd18c607b33.png) | ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/0649cf39-144f-4e9a-b6fc-4851a1479063.png) |
| --- | --- |

Based on the configuration in the WooCommerce admin panel, the checkout page displayed to customers for the embedded credit card plugin is as follows: ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/5e2c6996-6348-47f2-9947-6693139b594f.png)

#### Tab: Tiled display capability

Go to the plugin settings page, select the payment methods to be displayed in tile view, and enter the configuration page. Enable the approved payment method, then click **Save changes** to confirm activation.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/c27c56c5-e77c-46c1-8f06-66a181659bda.png)

Based on your actual situation, for the payment methods that have been successfully activated in Antom, go to the WooCommerce admin panel, click **Complete setup**, check **Enable**, and configure them one by one to display as tiled payment options on the checkout page.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/81b9e258-b2cd-4def-84c8-2ec4d300a4ee.png)

Based on the tiled wallet display configuration in the WooCommerce admin panel, the checkout page displayed to customers is as follows:

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/dd2e1921-3abb-4b2b-9006-01a4b59a1cdd.png)

5.  In production mode, you can change your settlement currency and bind your settlement card. For details, please refer to [View settlement info](https://docs.antom.com/ac/merchant_service/antom_dashboard.md#is5Ad).


## Test the plugin in sandbox

Before you officially open the plugin to users, we recommend testing the plugin in sandbox mode, according to the following steps. If you do not need to integrate the sandbox test, please skip this step and proceed to the [Configure the plugin](#wTSND) section.

1.  Click **Connect your account** or **Settings** to access the plugin configuration page.![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/eec9b4f0-459e-4c0f-a19c-28264bcca3e6.png)
2.  Check the **Enable Test Mode** box.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/b63ecb68-44dc-4550-996c-ea584be5e7da.png)

3.  Click **Antom Dashboard** to obtain configuration information in test mode. Refer to [Sandbox configuration](https://docs.antom.com/ac/merchant_service/antom_dashboard.md#kZRFb) for the detailed process.

-   **Test Mode Antom ClientId**: The unique ID assigned to your account in test mode.
-   **Test** **Mod****e Antom Public Key**: The public key provided to you in test mode.
-   **Test** **Mode Your Private Key**: The key used for authentication that matches the public key you configured on Antom Dashboard.

> **Note**: Enable the test mode on Antom Dashboard to obtain configuration information for the test mode.
>
> ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/da35cdc1-30b1-4d2b-9dd4-2f00792fa890.png)

4.  Configure the [Notification URL](https://dashboard.alipay.com/global-payments/developers/iNotify) in test mode to receive payment notifications.
5.  Go to your store and add a product to your cart.
6.  Proceed to checkout.
7.  Enter the required billing details. We recommend using a real email address so that you can receive the order confirmation.
8.  Select the wallet payment provided by the Antom Payments plugin and check the terms and conditions box.
9.  Click **Place order**. You'll be redirected to the code-scanning page. Use the wallet app scan the code and complete the payment.
10.  Sign in to your WordPress account as an administrator. Select WooCommerce in the left menu. Your test order is displayed with a **Processing** status. You can also view this order payment request in Antom Dashboard.

## Configure the plugin

1\. After your Antom account is successfully activated, log in to WordPress website and click the **Settings** button under the **Antom Payments** plugin to enter the plugin configuration page.

| ![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/899d8844-b6b2-44f3-a3f5-47364bd5801e.png) | ![111.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/e305f9c5-5c1c-4574-9ae3-75a68be6f6c7.png) |
| --- | --- |

2.  Click **Antom Dashboard** to obtain the following configuration information. For detailed steps, please refer to [Go live](https://docs.antom.com/ac/merchant_service/antom_dashboard.md#to4qC).

-   **Live Mode Antom ClientId**: The unique ID assigned to your account in live mode.
-   **Live Mode Antom Public Key**: The public key provided to you in live mode.
-   **Live Mode Your Private Key**: The key used for authentication that matches the public key you configured on Antom Dashboard.

![222.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/09165f17-4bc1-4caf-80e8-07fbad6f147b.png)

3.  View the bound settlement card and settlement currency on the [Settlement overview](https://dashboard.alipay.com/global-payments/finance/overview) page.

> **Note**: Before initiating a transaction in live mode, ensure that you have completed the settlement card binding in Antom Dashboard and specified the corresponding currency on the plugin configuration page.

### Configure the notification URL

After setting up the plugin configuration information, you need to configure the notification URL in live mode to receive payment notifications as following steps.

1.  Obtain the notification URL in the **Notify Url** option of the Antom Payments plugin.
2.  Set **alipay.ams.payments.payNotify** and **alipay.ams.payments.captureNotify** on [Notification URL](https://dashboard.alipay.com/global-payments/developers/iNotify) page in live mode.

![333.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/eb032c35-7e7f-4504-ad7a-19b362f026e6.png)

### Test notification URL in live

In order to test whether you can receive the notification correctly in the live mode, you can initiate a payment request (such as AlipayHK). If you do not have an AlipayHK wallet to pay, you can wait until the payment expires (The default is 15 minutes; when you set the inventory expiration time, the payment expiration time is equal to your inventory expiration time). At this time, Antom will send a notification to your WordPress, setting the order status to FAIL.

-   If your notification configuration is correct, the order status will be set to FAIL after the deadline.
-   If the order status remains pending payment, it indicates that your notification may not be configured correctly. You need to check whether the notification URL, public/private key, and clientId on the plugin configuration page are consistent with those on the Antom Dashboard.

## Go live

Before going live, please review the following checklist. After completing these checks, you will be ready to process real transactions with the plugin.

-   Ensure you have completed a payment in sandbox and the order status has been successfully updated.
-   Ensure the Enable Test option is unenabled on the plugin setting page.
-   Ensure the payment method has been activated on Antom Dashboard [Payment methods](https://dashboard.alipay.com/global-payments/pay-methods) page.
-   Ensure the notification address has been configured on Antom Dashboard [Notification URL](https://dashboard.alipay.com/global-payments/developers/iNotify) page.