OpenCart

Last updated: October 30, 2026

Overview

Streamline your OpenCart store’s transactions with our payment plugin, ensuring secure and efficient payment processing.

Please note - Full functionality is tested in  test environment (UAT) and production functional testing is pending. 

Our OpenCart payment extension helps you launch or expand your business rapidly. If you are launching your business first time on OpenCart, we can help you to quickly roll out through our configuration capabilities. If you are already on OpenCart and thinking of expansion, we offer a wide variety of secure local and global payment options.

Our OpenCart extension which is built on Payments Orchestration Platform delivers a competitive advantage over payment gateways including payment processing optimization and advanced analytics through a single integration. We help you manage payments across multiple P2Ps, acquirers and banks across all channels — online, mobile or recurring — using a strategic, streamlined approach.

Looking for the step-by-step journey (prepare, install, configure, test, go live)? See the OpenCart overview on the Shop Plugins page. This page contains the detailed reference.

↑ Back to top


Compatibility

Our plugin supports the following versions:

  • 4.0.2.3

Important

It is strongly recommended that the plugin installation is first completed and validated in a non‑production environment (for example, a QA or staging environment) before proceeding with installation in production.

This plugin is designed to work with the out‑of‑the‑box (OOTB) native OpenCart checkout.

If your store uses a custom checkout implementation or heavily modified checkout flow, additional customization by the merchant or their implementation partner (agency/integrator) may be required to ensure compatibility with the plugin.

↑ Back to top


Configure

You need the Entity ID, API key and webhook decryption key from the Onboard section.

Open the plugin settings

In the admin panel, access the payment settings:

  1. Navigate to the Admin Panel.
  2. Navigate to Extensions > Extensions, and choose Payments as the extension type (You will find two extensions listed):
    • Tryzens_Ignite
    • ACI_Payments
  3. Edit the ACI_Payments Extension
    Click the Edit button next to the ACI_Payments extension.

Figure 1: Open the plugin settings

OpenCart: Open the plugin settings

Field reference

General Setting

Field Name in OpenCart  Configuration Mandatory/Optional/ConditionalPossible ValuesComments
EnabledMandatoryEnabled or DisabledConfigure this to enable or disable the payment plugin
EnvironmentMandatoryTest or Live

Test - For test environment Configuration

Live - for Live environment Configuration

Entity ID (Test)MandatoryEntity ID of your Channel or Merchant from the Open Payment PlatformRefer to onboarding configuration.
 API Key (Test)MandatoryAPI of your Channel or Merchant from the Open Payment PlatformRefer to onboarding configuration.
Entity ID (Live)MandatoryEntity ID of your Channel or Merchant from the Open Payment PlatformRefer to onboarding configuration.
API Key (Live)MandatoryAPI of your Channel or Merchant from the Open Payment PlatformRefer to onboarding configuration.
Test ModeMandatoryINTERNAL or EXTERNAL 

Connector test mode 

  • EXTERNAL causes test transactions to be forwarded to the processor's test system for 'end-to-end' testing
  • INTERNAL causes transactions to be sent to our simulators.
Webhook URLMandatory
The value will be auto-populated to configure the webhook URL in Open Payment Platform
JavascriptConditional

Use this option to customize the payment widget, while using Google Pay, providing gatewayMerchantId is mandatory. 

{
"googlePay": {
       "gatewayMerchantId" : "ValueOfYourEntityID"
   } } 

Additional information - Advanced Options

Google Pay

CSSOptional
CSS helps to customize the default checkout payment page experience, possible examples, and options on Google Pay
Webhook Decryption KeyMandatory
Fill in the Secret for the encryption value generated during webhook endpoint creation in the Open Payment Platform.

Figure 2: General Setting

OpenCart: General Setting

Card Settings

  • Enabled - Yes/No
  • Title - Any Text (It will be displayed on the checkout payment page)
  • Charge Type – Authorization (PA)/Sale (DB)
  • Supported Card Types - Authorization/Sale (Ex, VISA, MASTER, AMEX). You will get the brand codes - Customization – options & brands
  • Card Type Icons – Multiple brand image upload
  • Save Payment Option – Yes/No - Allow the consumer to save the card details for future use

Figure 3: Card Settings

OpenCart: Card Settings

Alternative payment settings

  • Enabled - Yes/No - If No, the payment method will not display in the storefront event it is enabled in the APM payment method settings.

This has a button called “Add Payment”. The APM payment config form will display if clicking on this button.

  • Enabled - Yes/No
  • Title - Any Text (It will be displayed on the checkout payment page)
  • Charge Type – Authorization (PA)/Sale (DB) – As applicable for APM brand
  • APM Icon - Single Image Upload
  • Payment Key – Payment Method Key – You will get the Payment Key from Customization – options & brands

Note - Currently certified payment methods and its payment keys are -

  • Google Pay – GOOGLEPAY
  • Apple Pay – APPLEPAY
  • Klarna - KLARNA_PAYMENTS_ONE
  • PayPal – PAYPAL

Other APM’s and Payment methods can work out of the box as we do support all basic request parameters.

Figure 4: Alternative payment settings

OpenCart: Alternative payment settings

Please refer to Configuration Guide for additional details. 

↑ Back to top


Onboard

After plugin installation, please follow the instructions to configure the extension in OpenCart and in Open Payment Platform using configuration details.

You will need to configure merchant accounts and brands in Open Payment Platform which needs to work with checkout using plugins.

You will need to do the respective card or APM connector merchant account configuration in Open Payment Platform as per the respective connector configuration details for brands to work with your shop.

Credentials from the Open Payment Platform

To start processing with plugins, plugin configuration in the Open Payment Platform needs to be enabled for your PSP or merchant. Without this configuration, you won’t be able to send transaction requests from the plugin platform to the payment platform for processing.

Please contact your account manager or project team to enable plugin usage from the Open Payment Platform.

You will need the following information from the Open Payment Platform to configure and onboard with the payment plugin:

Field Name in OpenCart Configuration Open Payment Platform Field NameMandatory/OptionalComments
Entity IDEntityIdMandatory

From the Merchant or Channel level, according to the Open Payment Platform configuration setting of Merchant accounts

In Open Payment Platform - Administration→ Account data

API KeyAccess TokenMandatory

From Open Payment Platform at the Merchant or Channel level, according to the Open Payment Platform configuration setting of Merchant accounts

In Open Payment Platform - Administration→ Account data → Merchant Info/Channel Info

Figure 5: Credentials from the Open Payment Platform

OpenCart: Credentials from the Open Payment Platform

Webhook configuration

The webhooks are HTTP-based callbacks that notify your plugin platform of all the events you subscribed for on an entity. Instead of constantly polling for updates, a webhook is set up once and only sends data when a specific event occurs. The events can be about tokens, payments, payment schedules, risks, or any transaction state updates related to payments or transactions connected to a payment, it is necessary to configure webhooks for seamless communication and transaction updates. 

Merchant/PSP to configure webhooks and generate the webhook decryption key in the Open Payment Platform for
webhook handling.

Steps:

  1. Login to merchant dashboard (Open Payment Platform)
  2. Select your division (here OPP_Division)
  3. Go to Administration - Webhooks
  4. Click on the “Add New Webhook” button

Figure 6: Webhook configuration

OpenCart: Webhook configuration

Follow further steps below to configure Webhook

  1. URL: Get the webhook URL from OpenCart plugin admin configuration page.
  2. Notification types: Select the notification types as required by the merchant
  3. Fields to include: Select the option as required by the merchant
  4. Secret for encryption: (Copy the value and add in the “Webhook Decryption Key” field under general settings in OpenCart check Sample Configuration)
  5. Wrapper for encrypted notification: JSON
  6. Emails: Enter email IDs to receive a notification alert
  7. Save

Figure 7: Webhook configuration (continued)

OpenCart: Webhook configuration (continued)

↑ Back to top


Features

Payment types

Payment TypeSupportedComments 
Authorization (PA)✔
Debit (DB)✔
Credit (CD)–

Capture (CP)

Full✔
Partial

✔


Multiple✔

Refund (RF)

Full✔
Partial✔
Multiple✔

Reversal (RV)

Full✔
Partial–
Multiple–
Receipt (RC)–
Rebill (RB)–

Note - Some functionalities available in the plugin might not be supported by the connector in use. Please refer to the respective connector integration sheet for details.

Features

We have standard plugin integration with OpenCart using our Open Payment Platform Integration option, that give you access across all the features and uses the COPYandPAY to present payment options to your shoppers 

FeatureSupportedComments
Supported Brands✔

ALL

Note - VISA, Mastercard, Amex, PayPal, Klarna, Apple and Google Pay are the brands certified internally, Plugin integration can adopt other card and APM brands, for any additional field support specific to APM or card please contact your account manager. 

Supported Payment Methods✔

Credit Card, Virtual Account

Countries✔ALL (if OpenCart  is in countries)
Authorization Currencies✔ALL
Late Notification✔

Payment Facilitator

–
Recurring/Subscription ✔To be enabled in production on demand.
Reference ID✔
Timeout Autoreversal✔
TLS 1.2✔
Internal Tokenization
–
Omni Tokenization–
External Tokenization–
Zero Authorization/ Account Verification–
Digital Wallet✔Apple Pay, GooglePay
3D Secure ✔Using our MPI
Airline Data–
Settlement Reporting–

Settlement reporting is as per the specific brand connector in use. 

COPYandPAY OneClick Checkout (Save Card)✔
COPYandPAY widget or full page redirect✔
Customization through standard COPYandPAY JS✔using wpwlOptions
Customization through standard COPYandPAY CSS✔using wpwlOptions
PayByLink–
Manage Saved Card in User Profile–
Download Audit Log✔Enable this through OpenCart Support
Guest Checkout ✔
Transaction identifier ✔merchantTransactionID
Fast Checkout–
Fraud with Payment✔
Standalone Fraud–
PCI DSS 4✔

↑ Back to top


Supported fields

As part of the integration with the plugin platform we have integrated the below fields, Please note this is only informational, you don't need to worry about how to send these fields or integrate them. Plugin extension takes care of it. 

Note - the below fields are supported as standard, if any specific fields need to be supported for APM for Card brand please get in touch with your account manager. 

  • entityId
  • amount
  • currency
  • integrity
  • merchantTransactionId
  • testMode
  • paymentType
  • customer.givenName
  • customer.surname
  • customer.email
  • customer.merchantCustomerId
  • customer.ip
  • billing.street1
  • billing.street2
  • billing.city
  • billing.state
  • billing.postcode
  • billing.country
  • shipping.street1
  • shipping.street2
  • shipping.city
  • shipping.state
  • shipping.postcode
  • shipping.country
  • shipping.customer.email
  • shipping.customer.givenName
  • shipping.customer.surname
  • cart.items[n].name
  • cart.items[n].merchantItemId
  • cart.items[n].quantity
  • cart.items[n].price
  • cart.items[n].currency
  • cart.items[n].totalTaxAmount
  • cart.items[n].tax
  • cart.items[n].totalAmount

↑ Back to top


Resources

↑ Back to top


See also