OpenCart

Connect Peach Payments to your OpenCart store.

Peach Payments offers a payment extension for OpenCart which allows you to accept online payments using all the payment methods offered by Checkout.

Overview

ItemDescription
Payment methods and subscriptionsOnly once-off payments are supported for the OpenCart payment extension, the following are not supported:

- Payment subscriptions.
- One-click payments using stored cards.
RefundsDoes not support full or partial refunds. However, you can use the platform's offline refund feature to log the refund, and then either manually refund your customer or do so using the Peach Payments Console.
CurrenciesAll currencies that you are configured for.
PricingSee the Peach Payments website.
Account activationRequires review by Peach Payments South Africa. Our sales team is always here to help; contact support for assistance.

Register account

To connect Peach Payments to your OpenCart store, you must have a Peach Payments account.

Download the Peach Payments extension

  1. Navigate to the OpenCart Extension Store. The OpenCart versions that the extension is compatible with are listed on this page.
  2. Click DOWNLOAD in the upper right of the screen.
  3. Log in using your username and password and if requested, enter the PIN that you received, then click Continue.
  4. Download the Peach Payments OpenCart file.
Download the Peach Payments extension for OpenCart.Download the Peach Payments extension for OpenCart.

Download the Peach Payments extension for OpenCart.

  1. Extract the ZIP file that is downloaded.

Install the extension

  1. Navigate to your OpenCart Administration Panel and log in.
  2. In the leftmost navigation, click Extensions > Installer, then click Upload.
    For OpenCart 2, navigate to Extensions > Extension Installer.
Upload the extension.Upload the extension.

Upload the extension.

  1. In the folder that you extracted, navigate to the ..\plugin-opencart-a1l-master 2\plugin-opencart-a1l-master\zip, select the ZIP file for the version of OpenCart that you're running, and click Open.
    For OpenCart 2, click Continue.
    The extension is installed.
  2. Navigate to Extensions > Modifications and click Clear then Refresh in the upper right of the screen. This flushes and rebuilds the modification cache.

Configure the extension for testing

  1. In your OpenCart Administration Panel, navigate to Extensions > Extensions and select Payments from the Filter drop-down.
  2. Scroll down to Peach Payments and click Edit.
Edit the Peach Payments extension.Edit the Peach Payments extension.

Edit the Peach Payments extension.

  1. Select the General tab and enter the sandbox checkout channel (sometimes called the Entity ID) and sandbox secret token that you received from [email protected] into the relevant fields.
Configure the extension.Configure the extension.

Configure the extension.

  1. The callback URL that is provided in the Callback url field must be added in the Checkout > Webhooks section of the Peach Payments Console.
  2. Enter the merchant ID prefix into the relevant field. The merchant ID prefix is prepended to the order ID. For example, if you set the merchant ID prefix to test-shop, when an order is made on the store, if the order ID is 1234, test-shop-1234 appears on the customer's statement or in the transaction ID column in the Peach Payments Console.
  3. Ensure that Sandbox Mode is set to Yes.
  4. Depending on the currency that you have configured with Peach Payments, select the appropriate Peach Payments Currency.
  5. If you use more than one payment gateway, set the order in which the payment gateways should appear on checkout in the Sort Order field.
  6. Navigate to the Order status tab, ensure that your order status mappings are completed correctly, and then click Save in the upper right of the screen.
Order status tab.Order status tab.

Order status tab.

  1. Execute a number of test purchases to check the integration.

Go live

To go live, you'll need to request a live Checkout channel and secret token from support. When you've received those credentials complete the following steps:

In your OpenCart Administration Panel, navigate to Extensions > Extensions and select Payments from the Filter drop-down.

  1. Scroll down to Peach Payments and click Edit.
  2. Select the General tab and enter the live checkout channel and live secret token that you received from [email protected] into the relevant fields.
  3. Change Sandbox Mode to No and then click Save in the upper right of the screen.

Execute a number of live purchases to check the integration.

Audit logs (API traces)

The OpenCart extension includes an extensive auditing framework which provides a web tool to view all API interactions between your website and the Peach Payment APIs. The traces can be found as follows:

  1. In your OpenCart Administration Panel, navigate to Extensions > Extensions and select Payments from the Filter drop-down.
  2. Scroll down to Peach Payments and click Edit.
  3. Navigate to the Traces tab.

A full list of the traces appears with the option to view the detailed information related to each trace.