Need help?


The Telr OpenCart Extension allows merchants who use the OpenCart system to take payments via the Telr Hosted Payment Pages. No card details are captured by or stored within the OpenCart system, so there are no PCI requirements for the store.

When the customer clicks on the ‘Process Order’ button at the end of the OpenCart checkout screen, they will be taken to the Telr secure server to enter their card details. The result of the purchase attempt (authorized or otherwise) is sent back to the OpenCart system to update the order details. The customer is also returned to the store.

Version Requirements

The module has been tested with OpenCart versions 2.3.x and 3.x.x

You must have PHP version 5.5 or later, and the cURL PHP library must be installed and enabled.



Transfer this to the server that is running your OpenCart store.This contains two components. These are the items used for the store when it catalogue mode (when a customer is making a purchase) and for when the system is in admin mode.

You should take a back-up of your system before installing the extension.

The contents of the catalog directory from the zip file should be copied into the catalog directory from your store.

The contents of the admin directory from the zip file should be copied into the admin directory from your store. You may have renamed the admin directory as part of your original OpenCart installation process, so you should ensure that this is copied to the correct location.

Once the files have been copied to the correct place, you should log in to the OpenCart administration system to configure the payment module.

Configuring OpenCart

From the Administration System, select Payments from the Extensions menu. This will present you with a list of available payment methods. Locate the entry for Telr and click on the plus icon in order to enable it.

You then need to edit the settings for the payment method. Your Telr Store ID is displayed in the top right of the Telr Merchant Administration System. The authentication key can be found in Telr Merchant Administration System in Hosted Payment Page V2 configuration page, under the Integrations menu. The Order Status section allows you to set which status values are used when creating or updating the order within OpenCart based on the transaction results.

Payment page customisation

You can customize the payment page by using a CSS file. The core page display is based on the BootStrap 3 responsive layout. Before making any CSS changes, ensure that you are familiar with the underlying styles used within Bootstrap. For more details, please refer to the Hosted Payment Page integration guide.

Verified by Visa and MasterCard SecureCode

After the consumer enters their card details, the payment gateway will check to see if that card is enrolled as part of the Verified by Visa or MasterCard SecureCode authentication systems (known as 3D-Secure).

If the card is part of one of these authentication systems, then an additional page is displayed which requires the relevant authentication details to be entered. This is usually in the form of a password that has been assigned by the consumer or via a one-time code sent to the customers mobile.

The actual data entry section is presented directly by the card issuer and cannot be customised. It is generally displayed on a white background. Where possible the 3D-Secure authentication form is displayed over the payment page, allowing the customer to see that it is clearly part of the payment process.

Live Transactions

Before processing live transactions, ensure that the IP details of your server are entered into the Payment Page V2 configuration in the Telr Merchant Administration System.