Integrate AbanteCart and Culqi

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

Culqi and AbanteCart 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 AbanteCart you need Trexle API keys

To install Trexle extension to your AbanteCart, go to Administrator Dashboard and click on the Extensions link in the left menu.

In the drop-down menu, click on the Get Extensions to open AbanteCart Extensions Marketplace

In the popup window, enter the credentials of your AbanteCart Marketplace account and click on the button Connect.

Find Trexle extension and click on its icon in the Marketplace. In the new window, click on the button Get Now.

Follow the checkout steps and click on the Confirm Order button.

Congratulations, Trexle extension is now successfully installed to your AbanteCart.

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

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 AbanteCart 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 AbanteCart 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 AbanteCart

AbanteCart is a free eCommerce application that is designed, built and supported by experienced enthusiasts who are passionate about their work and contributions to the project. Considering that it is not a commercial endeavor, AbanteCart is one of the most state-of-the-art free eCommerce platforms available. It operates based on donations and other contributions, marketplace proceeds and financial support from advertisers.