---
updatedAt: 2026-06-24T01:26:41.000Z
agentTools:
  siteIndex: https://merchants.westpac.com.au/llms.txt
  projectIndex: https://merchants.westpac.com.au/onlinepay/llms.txt
---

# OpenCart

## Overview

OpenCart is an open-source e-commerce platform.

Before installing the Verifone Hosted cart for OnlinePay, you must meet the following requirements:

## Prerequisites

### OpenCart tools:

* Install the OpenCart plugin, not older than v3+ you can download the latest plugin version from <https://www.opencart.com>.

  > 📘 OpenCart 4 is not supported.

* OpenCart server must be using an officially supported version of PHP.

### OnlinePay tools:

* The merchant user must have a `Merchant Supervisor` role in the OnlinePay dashboard.
* The related organisation must have a `Secure Card Capture Key` in the OnlinePay dashboard. This key is used to encrypt sensitive card data.

## Installation

1. Download the OpenCart plugin ZIP file from the link below:

   <HTMLBlock>{`
   <div><span id="download" class="icon-chevron-rightward"></span> <i class="fa-solid fa-file-zipper"></i> <a href="https://3085512782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyw34t0Oefjx0nEVMOjo2%2Fuploads%2FkYnSXwoGhOXKtGjhyxFv%2Fverifone-2.4.1.ocmod_.zip?alt=media&token=23dcbf7d-30b9-4942-847f-0d24b827f85e">OpenCart plugin</a></div>
   `}</HTMLBlock>

2. After you download the file, rename it to remove `__0` (for example, from `verifone-2.1.1.ocmod__0.zip` to `verifone-2.1.1.ocmod.zip`).

3. Log in to your OpenCart admin panel and navigate to **Extensions > Installer**.

4. On the **Extension Installer** page, click **Upload** to upload your extension files.

5. Go to **Extensions > Choose the extension type**, then select the `Payments` extension type.

6. From the **Extensions** list, click **Install** next to the **Verifone Hosted** extension.

When installation is complete, configure the OpenCart plugin with your OnlinePay settings.

## Configuration

1. In your OpenCart **Extensions** page click **Edit** on the **Verifone Hosted** extension.
2. The following **Account Settings** are mandatory:
   1. **Status**: Select `Enabled` to enable the plugin.
   2. **Choose environment**: Select `Production` to connect to your OnlinePay production account. If you have an OnlinePay sandbox account and would like to use it for testing the plugin, select `Test mode (CST)`.
   3. **User Id**: Your OnlinePay User ID.
   4. **API Key**: Your OnlinePay API Key.
   5. **Organisation Id**: Your OnlinePay Organisation ID/Site ID.
   6. **Region**: Select `AU (Australia)` from the drop-down list.
3. Configure the display settings to customise the look and feel of your checkout.
   1. Select **Hosted Payment Page (HPP)** for your OnlinePay hosted checkout page.
   2. Select **iFRAME** for your OnlinePay hosted checkout page as an iFrame.
   3. Define value totals and payment statuses for OpenCart orders.
   4. Provide your **Theme ID**. This is a custom theme that you have created in the OnlinePay dashboard. See [Customise your Checkout](https://merchants.westpac.com.au/onlinepay/docs/customise-checkout) for more information.
4. Provide your payment settings:
   1. **PPC ID**: Your OnlinePay [Payment Provider Contract](https://merchants.westpac.com.au/onlinepay/docs/ppc-id)ppc ID.
   2. **3DS**: Your 3D Secure ID.
5. Configure alternative payment methods if your Payment Provider Contract has been configured with Google Pay or Apple Pay. You must provide your Payment Provider Contract ID for Google Pay and Apple Pay.
6. In the **Advanced Options** tab, change the default transaction type to `Sale` or `Preauth`. `Auth` is not supported by OnlinePay.
7. Click **Save** to apply the settings.