Integrate osCommerce and Culqi

Trexle connects osCommerce to Culqi and 100+ other payment gateways using a single plugin for one time annual fee

Culqi and osCommerce Integration Guide

Production and integration environments
Each account created in Culqi is divided into two environments: one to perform test transactions and another to carry out transactions with real cards. All API requests will be routed to one of the two environments and will depend on the type of key you are using.

The production and testing environments were designed to work exactly the same but only with a few small differences:

In the test environment, transactions are not processed by bank networks and only test cards can be used .

Each of the environments of your account (production and testing), work only with a set of keys that have been created exclusively for each environment and in this way Culqi realizes with what environment you want to interact. The keys corresponding to your account can be found in the Culqi Panel.

To get Keys APIs of the environment you want to use, you must enter the Environment Panel and go to the Development section – API Keys:

Environment URL
Integration https://integ-panel.culqi.com/#/desarrollo/llaves
Production https://panel.culqi.com/#/desarrollo/llaves
In addition to Keys APIs related to integration and production environments, there are two types of Keys APIs: public and secret.

The public keys are designed only to identify your account with Culqi and they are not a secret. In other words, they can be published securely in your Culqi.JS, JavaScript code or in your Android or iOS application. Public keys only have the power to create tokens .

Instead, private keys should be stored on your servers in a confidential manner. This type of keys can make any request to the Culqi API without any restriction.
If you want to renew both keys immediately you can do it through the Panel and they will be deactivated at the moment. When your set of keys are deactivated, you will not be able to use them again.

Activating your account
Before activating your account , you will only be able to interact with the Culqi testing environment. Do not worry. All the functionalities of the production environment are also available in the test environment, the only difference is that you can not create transactions with real cards until you activate your account.

Take the credentials you just obtained from Culqi and navigate to Trexle dashboard, click Payments Gateways and select Culqi from the drop down menu as shown below.

Fill into your Culqi credential and click Add Gateway. Click the Activate button next to Culqi, and it will give you a success message and the button will turn into green. You should see something like below.

To integrate Culqi and osCommerce you need Trexle API keys

How to install Trexle extension to osCommerce


  1. Log in to your osCommerce admin panel

  1. On the left menu in the Admin panel, click on the ‘Modules’ tab

  1. Under the ‘Modules’ tab, click on the link ‘Payment’ and then on the button ‘Install Module’

  1. Find the ‘Trexle’ extension after clicking on the ‘Install Module’

  1. Click on ‘Trexle’ and then on the ‘Install Module’ button

  1. Trexle plugin should now be successfully installed

To ensure the integration works seamlessly, create a test product, logout from your admin session and perform a checkout as a regular customer.

Here is a video tutorial on both installation and order testing.

Test Cards
Culqi provides you with the following test cards so you can validate your integration and make the best possible development.

  1. Test Cards
    Cards with specific answers and errors
  2. Test cards
    Actual information of credit or debit cards can not be used to perform tests in the integration environment. Use any of these cards to make a successful charge.

Brand Number Month year cvv Description
Visa 4111 1111 1111 1111 09/2020 123 Successful sale
Master Card 5111 1111 1111 1118 06/2020 039 Successful sale
American Express 3711 1111 1111 114 11/2017 2841 Successful sale
Diners Club 361111 1111 1111 04/2018 964 Successful sale
Cards with specific answers and errors
The following cards can be used to create errors and specific answers, this is useful to test in different scenarios and with the most common error codes.

Brand Number Month year cvv Denial codes
Visa 4000 0100 0000 0019 11/2015 496 expired_card
Visa 4000 0200 0000 0000 10/2019 354 stolen_card
Visa 4000 0300 0000 0009 08/2018 836 lost_card
Visa 4000 0400 0000 0008 03/2021 295 insufficient_funds
MasterCard 5400 0000 0000 0005 01/2022 492 contact_issuer
MasterCard 5400 0100 0000 0004 02/2020 784 invalid_cvv
MasterCard 5400 0200 0000 0003 07/2022 203 incorrect_cvv
American Express 3700 010000 00000 06/2019 1701 too_many_attempts_cvv
American Express 3700 010000 00000 04/2021 2511 issuer_not_available
American Express 3700 020000 00008 05/2022 1810 issuer_decline_operation
Diners Club 3600 000000 0008 09/2019 683 invalid_card
Diners Club 3600 010000 0007 12/2018 820 processing_error
Diners Club 3600 020000 0006 01/2020 230 fraudulent

Culqi Supported Countries

Culqi Supported Payment Processing Actions

✔ Purchase
✔ Authorize
✔ Capture
✔ Void
✔ Credit
✔ Recurring
✖ Card Store

Key Features

Credit Card Vault: securely store your customers sensitive credit card data using tokens.
Instant PCI-DSS Compliance: your customers credit card data never touches your site or server.
Multiple Gateway Support: Connect your osCommerce site to 100+ payment gateway

About Trexle

Trexle is a powerful online recurring subscription billing platform that integrate Culqi and other +100 payment gateways with osCommerce and other dozen of e-commerce platforms.

About Culqi

Culqi is a Peru based payment gateway using the best of practices for a payment gateway meeting international standards. Culqi employs anti-fraud engine feeds on each of the transactions that are carried out daily, fine-tuning the detection of future frauds. Culqi uses redundant hardware spread across multiplie locations across the globe to minimize risk of downtime. Culqi has a dedicated support team for the merchants using its gateway.

About osCommerce

Being in the fintech business for 18 years, osCommerce platform enables merchants to create their very own online store and start selling products and services to customers worldwide. The tools they offer to merchant owners are free, available under Open Source license. osCommerce also has a large community of store owners, developers, and service providers who help each other during the many stages of maintaining an online business.