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 recurring paymentsThe OpenCart payment extension supports once-off payments, but not the following:

- Recurring payments.
- One-click payments using stored cards.
RefundsDoes not support full or partial refunds. 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 Dashboard.
CurrenciesAll currencies configured for your account.
PricingSee the Peach Payments website.
Account activationRequires review by Peach Payments South Africa. 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. Go to the OpenCart Extension Store. This page lists the OpenCart versions that the extension is compatible with.

  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.

  5. Extract the downloaded ZIP file.

Install the extension

  1. Go to your OpenCart Administration Panel and log in.

  2. In the left navigation menu, click Extensions > Installer, then click Upload. For OpenCart 2, go to Extensions > Extension Installer.

    Upload the extension.

    Upload the extension.

  3. In the folder that you extracted, go to ..\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. This installs the extension.

  4. Go 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, go 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.

  3. 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.

  4. Send the callback URL from Checkout > Webhooks > Callback url to support to configure the webhook for you.

  5. Enter the merchant ID prefix into the relevant field. This prepends the merchant ID prefix to the order ID. For example, if you set the merchant ID prefix to test-shop, when a customer places an order on the store, if the order ID is 1234, test-shop-1234 appears on the customer's statement or in the merchant order ID column in the Peach Payments Dashboard.

  6. Select Yes for Sandbox Mode.

  7. Depending on the currency that you have configured with Peach Payments, select the appropriate Peach Payments Currency.

  8. 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.

  9. Go to the Order status tab, ensure that your order status mappings are correct, and then click Save in the upper right of the screen.

    Order status tab.

    Order status tab.

  10. Execute test purchases to check the integration.

Go live

To go live, request a live Checkout channel and secret token from [email protected]. When you've received those credentials complete the following steps:

In your OpenCart Administration Panel, go 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 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. Find the traces as follows:

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

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

FAQ

How do I show a Mobicred instalment calculator on my store? Follow their documentation.