CS-Cart

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 .

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

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