Install the XPay WooCommerce plugin

Install and configure the XPay payment gateway in a WooCommerce store. The current published plugin package is version 1.0.7.

Before you begin#

You need:

• A WordPress site with WooCommerce installed.
• WordPress administrator access that allows you to upload and activate plugins.
• The XPay WooCommerce plugin ZIP provided by XPay.
• The XPay account ID and publishable key for the environment you want to use.

Install the plugin#

1. In WordPress Admin, open Plugins → Add New Plugin.
2. Select Upload Plugin.
3. Choose the XPay plugin ZIP file.
4. Select Install Now.
5. When installation finishes, select Activate Plugin.

If an earlier version is already installed, WordPress may update the existing plugin during this process. Activate the plugin after the upload completes.

Open the XPay settings#

1. In WordPress Admin, open Plugins → Installed Plugins.
2. Find WooCommerce XPay Gateway.
3. Select Configure.

Configure card payments#

Save the settings after completing the form. Keep the mode, SDK URL, account ID, and publishable key from the same XPay environment.

Register the webhook URL in XPay#

The XPay settings page in WooCommerce displays a webhook URL for the store. XPay must use this URL to notify WooCommerce about payment results.

1. In the WooCommerce XPay settings, copy the displayed webhook URL.
2. In the XPay Merchant Portal, open the webhook configuration for the same store.
3. Add the WooCommerce webhook URL and save the configuration.
4. Confirm that the saved URL exactly matches the value displayed by the WooCommerce plugin.

Use the store-specific URL generated by the plugin. For shared webhook concepts and verification requirements, see Integrate XPay webhooks.

Test the checkout#

1. Add a product to the WooCommerce cart and proceed to checkout.
2. Confirm that the configured XPay payment-method title appears.
3. Complete a payment using credentials appropriate for the selected environment.
4. Confirm that XPay sends the payment result to the registered WooCommerce webhook URL.
5. Verify the payment result in WooCommerce and the XPay Merchant Portal before fulfilling the order.

Next steps#

• Return to Platform integrations.
• Review Test your integration before accepting live payments.