---
updatedAt: 2025-09-01T07:02:34.000Z
agentTools:
  siteIndex: https://merchants.westpac.com.au/llms.txt
  projectIndex: https://merchants.westpac.com.au/onlinepay/llms.txt
---

# WooCommerce integration setup

Configure the Verifone Hosted Cart plugin settings to accept payments on your WooCommerce store

## Overview

After you have installed the Verifone Hosted Cart plugin in your WordPress site, you need to configure the plugin with your OnlinePay credentials. This guide provides instructions on how to configure the plugin to integrate with your OnlinePay account and start accepting payments on your WooCommerce store.

You can configure the plugin automatically using the WooCommerce setup wizard or manually by entering the required settings in the WooCommerce settings page.

## Automatic setup using the WooCommerce setup wizard

The WooCommerce setup wizard guides you through the process of setting up your WooCommerce store, including configuring the Verifone Hosted Cart plugin. The wizard will prompt you to enter the required settings to connect your WooCommerce store to your OnlinePay account.

1. In your WordPress admin dashboard, navigate to **WooCommerce > Settings**, then click the **Payments** tab.

2. Locate the **Verifone Hosted Cart** payment method plugin and click **Manage**.

   ![Verifone Hosted Cart payment method](https://files.readme.io/9261536caf9185e63603cc22e2ae521cbad684c249820110bd915b9151a27a59-wc-settings-payments-plugin.png)

3. Click **Auto setup** under **Verifone account settings** to start the WooCommerce setup wizard.

4. In the **Auto Setup Tool** wizard, select **Production** mode to connect to your OnlinePay production account.

5. Provide your OnlinePay [`User Id`](https://merchants.westpac.com.au/onlinepay/docs/user-id) and [`API Key`](https://merchants.westpac.com.au/onlinepay/docs/api-key) in the respective fields. You can find out more about where to obtain these credentials in [Authentication and environment variables](https://merchants.westpac.com.au/onlinepay/docs/authentication-and-environment-variables).
   <Callout icon="⚠️" theme="warn">
     The Merchant Supervisor role is required to create and manage API keys for plugins.
   </Callout>

6. In the **Region** drop-down list, select `AU (Australia)`.

   ![Completed Auto Setup wizard](https://files.readme.io/70013f22a555f875b0c89ddc97386c4baf30c5f9e27f8c736f365354c2d5d618-wc-auto-setup.png)

<Callout icon="📘" theme="info">
  If you have an OnlinePay sandbox account and would like to use it for testing the plugin, select **Sandbox** and provide your sandbox API Key and User ID.
</Callout>

7. Click **Continue** to complete the setup process.

## Manual setup using the WooCommerce settings page

If automatic setup fails, or you prefer to configure the plugin manually, you can enter the required settings in the WooCommerce settings page.

1. In your WordPress admin dashboard, navigate to **WooCommerce > Settings**, then click the **Payments** tab.

2. Locate the **Verifone Hosted Cart** payment method plugin and click **Manage**.

3. Provide your OnlinePay [`User Id`](https://merchants.westpac.com.au/onlinepay/docs/user-id), [`API Key`](https://merchants.westpac.com.au/onlinepay/docs/api-key), and [`Organisation ID`](https://merchants.westpac.com.au/onlinepay/docs/org-id) in the respective fields. You can find out more about where to obtain these credentials in [Get started with the OnlinePay API](https://merchants.westpac.com.au/onlinepay/docs/get-started-with-the-onlinepay-api#environment-variables).

   <Callout icon="⚠️" theme="warn">
     The Merchant Supervisor role is required to create and manage API keys for plugins.
   </Callout>

   <Callout icon="📘" theme="info">
     If you have an OnlinePay sandbox account and would like to use it for testing the plugin, select **Enable test mode** and provide your sandbox API Key and User ID.
   </Callout>

4. In the **Verifone account region** drop-down list, select `AU (Australia)`.

5. Click **Save changes** to apply the settings.

## Card payment settings

Configure your card payment settings in the Verifone Hosted Cart plugin to accept card payments on your WooCommerce store. These settings include your Payment provider contract ID, which is required to process card payments, and your 3DS contract ID, which is required for 3D Secure transactions. These IDs can be obtained from your OnlinePay account. See [Get started with the OnlinePay API](https://merchants.westpac.com.au/onlinepay/docs/get-started-with-the-onlinepay-api#environment-variables) for more information.

1. In your WordPress admin dashboard, open the **Verifone Hosted Cart** payment plugin under **WooCommerce > Settings > Payments**.

2. Click the **Card payment settings** tab.

3. Check the `Enable card payments` checkbox to enable card payments on your WooCommerce store.

4. Provide [`Payment provider contract ID`](https://merchants.westpac.com.au/onlinepay/docs/ppc-id), obtained from your OnlinePay account.

5. Check the `Enable card 3DS` checkbox to enable 3D Secure card transactions, applying an additional layer of security to card payments.

6. Provide [`3DS Contract ID`](https://merchants.westpac.com.au/onlinepay/docs/3ds-id), obtained from your OnlinePay account.

7. The remaining settings are not applicable to OnlinePay users and can be left as default.

   ![Card payment settings](https://files.readme.io/9b106a0c1b63f8ab8f183428e91501a054a4b8a7e4484a91504accc6b0e62eef-wc-card-payments.png)

8. Click **Save changes** to apply the settings.