Response Codes and Variables
In this section, you find relevant data used during the integration process, such as the variable tables, languages, and currencies admitted in the PayU’s platform.
Response Codes for Transactions
| Response Code | Description |
|---|---|
ERROR |
General error. |
APPROVED |
The transaction was approved. |
ANTIFRAUD_REJECTED |
The transaction was rejected by the anti-fraud system. |
BANK_FRAUD_REJECTED |
The transaction was rejected due to suspected fraud at the financial institution. |
PAYMENT_NETWORK_REJECTED |
The financial network rejected the transaction. |
ENTITY_DECLINED |
The transaction was declined by the bank or financial network because of an error. |
INTERNAL_PAYMENT_PROVIDER_ERROR |
An error has occurred in the system trying to process the payment. |
INACTIVE_PAYMENT_PROVIDER |
The payment provider was not active. |
DIGITAL_CERTIFICATE_NOT_FOUND |
The financial network reported an authentication error. |
INVALID_EXPIRATION_DATE_OR_SECURITY_CODE |
The security code or expiration date was invalid. |
INVALID_RESPONSE_PARTIAL_APPROVAL |
Invalid response type. The entity response is a partial approval and should be automatically canceled by the system. |
INSUFFICIENT_FUNDS |
The account had insufficient funds. |
CREDIT_CARD_NOT_AUTHORIZED _FOR_INTERNET_TRANSACTIONS |
The credit card was not authorized for internet transactions. |
INVALID_TRANSACTION |
The financial network reported that the transaction was invalid. |
INVALID_CARD |
The card is invalid. |
EXPIRED_CARD |
The card has expired. |
RESTRICTED_CARD |
The card has a restriction. |
CONTACT_THE_ENTITY |
You should contact the bank. |
REPEAT_TRANSACTION |
You must repeat the transaction. |
ENTITY_MESSAGING_ERROR |
The financial network reported a communication error with the bank. |
BANK_UNREACHABLE |
The bank was not available. |
EXCEEDED_AMOUNT |
The transaction exceeds the amount set by the bank. |
NOT_ACCEPTED_TRANSACTION |
The transaction was not accepted by the bank for some reason. |
ERROR_CONVERTING_TRANSACTION_AMOUNTS |
An error occurred converting the amounts to the payment currency. |
EXPIRED_TRANSACTION |
The transaction expired. |
PENDING_TRANSACTION_REVIEW |
The transaction was stopped and must be revised, this can occur because of security filters. |
PENDING_TRANSACTION_CONFIRMATION |
The transaction is subject to confirmation. |
PENDING_TRANSACTION_TRANSMISSION |
The transaction is subject to be transmitted to the financial network. This usually applies to transactions with cash payment means. |
PAYMENT_NETWORK_BAD_RESPONSE |
The message returned by the financial network is inconsistent. |
PAYMENT_NETWORK_NO_CONNECTION |
Could not connect to the financial network. |
PAYMENT_NETWORK_NO_RESPONSE |
Financial Network did not respond. |
FIX_NOT_REQUIRED |
Transactions clinic: internal handling code. |
AUTOMATICALLY_FIXED_AND_SUCCESS_REVERSAL |
Transactions clinic: internal handling code. Query API. |
AUTOMATICALLY_FIXED_AND_UNSUCCESS_REVERSAL |
Transactions clinic: internal handling code. Query API. |
AUTOMATIC_FIXED_NOT_SUPPORTED |
Transactions clinic: internal handling code. Query API. |
NOT_FIXED_FOR_ERROR_STATE |
Transactions clinic: internal handling code. Query API. |
ERROR_FIXING_AND_REVERSING |
Transactions clinic: internal handling code. Query API. |
ERROR_FIXING_INCOMPLETE_DATA |
Transactions clinic: internal handling code. Query API. |
Response Codes Sent to the Response Page
| lap Transaction State | transaction State | pol Transaction State | lapResponseCode | pol Response Code | Description |
|---|---|---|---|---|---|
| APPROVED | 4 (Approved) | 4 (Approved) | APPROVED | 1 | Transaction approved |
| DECLINED | 6 (Declined) | 6 (Rejected) | PAYMENT_NETWORK_REJECTED | 4 | Transaction rejected by payment network |
| ENTITY_DECLINED | 5 | Transaction has been declined by the bank | |||
| INSUFFICIENT_FUNDS | 6 | Insufficient funds | |||
| INVALID_CARD | 7 | Invalid Card | |||
| CONTACT_THE_ENTITY | 8 | Please contact your financial entity | |||
| BANK_ACCOUNT_ACTIVATION _ERROR | 8 | Automatic debit not allowed | |||
| BANK_ACCOUNT_NOT_AUTHORIZED _FOR_AUTOMATIC_DEBIT | 8 | Automatic debit not allowed | |||
| INVALID_AGENCY_BANK_ACCOUNT | 8 | Automatic debit not allowed | |||
| INVALID_BANK_ACCOUNT | 8 | Automatic debit not allowed | |||
| INVALID_BANK | 8 | Automatic debit not allowed | |||
| EXPIRED_CARD | 9 | Expired card | |||
| RESTRICTED_CARD | 10 | Restricted card | |||
| INVALID_EXPIRATION_DATE_OR _SECURITY_CODE | 12 | Date of expiration or security code is invalid | |||
| REPEAT_TRANSACTION | 13 | Retry the transaction | |||
| INVALID_TRANSACTION | 14 | Transaction invalid | |||
| EXCEEDED_AMOUNT | 17 | Value exceeds maximum allowed by this entity | |||
| ABANDONED_TRANSACTION | 19 | Transaction abandoned by the payer | |||
| CREDIT_CARD_NOT_AUTHORIZED_FOR _INTERNET_TRANSACTIONS | 22 | Card is not authorized for internet purchases | |||
| ANTIFRAUD_REJECTED | 23 | Transaction has been rejected by the anti-fraud module | |||
| BANK_FRAUD_REJECTED | 23 | The transaction was rejected due to suspected fraud at the financial institution | |||
| DIGITAL_CERTIFICATE_ NOT_FOUND | 9995 | Digital certificate not found | |||
| BANK_UNREACHABLE | 9996 | Error trying to communicate with the bank | |||
| ENTITY_MESSAGING _ERROR | 9997 | Error communicating with the financial institution | |||
| NOT_ACCEPTED_ TRANSACTION | 9998 | Transaction not permitted to cardholder | |||
| INTERNAL_PAYMENT _PROVIDER_ERROR | 9999 | Internal error | |||
| INACTIVE_PAYMENT_ PROVIDER | 9999 | Internal error | |||
| ERROR | 104 (Error) | 6 (Rejected) | ERROR | 9999 | Internal error |
| ERROR_CONVERTING_TRANSACTION _AMOUNTS | 9999 | Internal error | |||
| BANK_ACCOUNT_ACTIVATION_ERROR | 9999 | Internal error | |||
| FIX_NOT_REQUIRED | 9999 | Internal error | |||
| AUTOMATICALLY_FIXED_AND_SUCCESS _REVERSAL | 9999 | Internal error | |||
| AUTOMATICALLY_FIXED _AND_UNSUCCESS _REVERSAL | 9999 | Internal error | |||
| AUTOMATIC_FIXED_ NOT_SUPPORTED | 9999 | Internal error | |||
| NOT_FIXED_FOR_ ERROR_STATE | 9999 | Internal error | |||
| ERROR_FIXING_AND _REVERSING | 9999 | Internal error | |||
| ERROR_FIXING_ INCOMPLETE_DATA | 9999 | Internal error | |||
| PAYMENT_NETWORK_ BAD_RESPONSE | 9999 | Internal error | |||
| PAYMENT_NETWORK_ NO_CONNECTION | 9996 | Unable to communicate with the financial institution | |||
| PAYMENT_NETWORK_ NO_RESPONSE | 9996 | No response from the financial institution | |||
| EXPIRED | 5 (Expired) | 5 (Expired) | EXPIRED_TRANSACTION | 20 | Transaction expired |
| PENDING | 7 (Pending) | 7 (Pending) | PENDING_TRANSACTION_ REVIEW | 15 | Transaction is pending approval |
| 14 (Pending) | PENDING_TRANSACTION_ CONFIRMATION | 25 | Receipt of payment generated. Pending payment | ||
| 7 (Pending) | PENDING_TRANSACTION_ TRANSMISSION | 9998 | Not permitted transaction | ||
| 14 (Pending) | PENDING_PAYMENT_IN_ENTITY | 25 | Receipt of payment generated. Pending payment | ||
| 15 (Pending) | PENDING_PAYMENT_IN_BANK | 26 | Receipt of payment generated. Pending payment | ||
| 10 (Pending) | PENDING_SENT_TO_FINANCIAL _ENTITY | 29 | |||
| 12 (Pending) | PENDING_AWAITING_PSE _CONFIRMATION | 9994 | Pending confirmation from PSE | ||
| 18 (Pending) | PENDING_NOTIFYING_ENTITY | 25 | Receipt of payment generated. Pending payment |
Response Codes Sent to the Confirmation Page
| state_pol | response_message_pol | response_code_pol | Description |
|---|---|---|---|
| 4 (Approved) | APPROVED | 1 | Transaction approved |
| 6 (Declined) | PAYMENT_NETWORK_REJECTED | 4 | Transaction rejected by financial institution |
| ENTITY_DECLINED | 5 | Transaction rejected by the bank | |
| INSUFFICIENT_FUNDS | 6 | Insufficient funds | |
| INVALID_CARD | 7 | Invalid card | |
| CONTACT_THE_ENTITY | 8 | Contact the financial institution | |
| BANK_ACCOUNT_ACTIVATION_ERROR | 8 | Automatic debit is not allowed | |
| BANK_ACCOUNT_NOT_AUTHORIZED _FOR_AUTOMATIC_DEBIT | 8 | Automatic debit is not allowed | |
| INVALID_AGENCY_BANK_ACCOUNT | 8 | Automatic debit is not allowed | |
| INVALID_BANK_ACCOUNT | 8 | Automatic debit is not allowed | |
| INVALID_BANK | 8 | Automatic debit is not allowed | |
| EXPIRED_CARD | 9 | Expired card | |
| RESTRICTED_CARD | 10 | Restricted card | |
| INVALID_EXPIRATION_DATE_OR _SECURITY_CODE | 12 | Invalid expiration date or security code | |
| REPEAT_TRANSACTION | 13 | Retry payment | |
| INVALID_TRANSACTION | 14 | Invalid transaction | |
| EXCEEDED_AMOUNT | 17 | The value exceeds the maximum allowed by the entity | |
| ABANDONED_TRANSACTION | 19 | Transaction abandoned by the payer | |
| CREDIT_CARD_NOT_AUTHORIZED_FOR _INTERNET_TRANSACTIONS | 22 | Card not authorized to buy online | |
| ANTIFRAUD_REJECTED | 23 | Transaction refused because of suspected fraud | |
| BANK_FRAUD_REJECTED | 23 | The transaction was rejected due to suspected fraud at the financial institution | |
| DIGITAL_CERTIFICATE_NOT_FOUND | 9995 | Digital certificate not found | |
| BANK_UNREACHABLE | 9996 | Error trying to communicate with the bank | |
| PAYMENT_NETWORK_NO_CONNECTION | 9996 | Unable to communicate with the financial institution | |
| PAYMENT_NETWORK_NO_RESPONSE | 9996 | No response was received from the financial institution | |
| ENTITY_MESSAGING_ERROR | 9997 | Error communicating with the financial institution | |
| NOT_ACCEPTED_TRANSACTION | 9998 | Transaction not permitted | |
| INTERNAL_PAYMENT_PROVIDER_ERROR | 9999 | Error | |
| INACTIVE_PAYMENT_PROVIDER | 9999 | Error | |
| ERROR | 9999 | Error | |
| ERROR_CONVERTING_TRANSACTION _AMOUNTS | 9999 | Error | |
| BANK_ACCOUNT_ACTIVATION_ERROR | 9999 | Error | |
| FIX_NOT_REQUIRED | 9999 | Error | |
| AUTOMATICALLY_FIXED_AND_SUCCESS _REVERSAL | 9999 | Error | |
| AUTOMATICALLY_FIXED_AND_UNSUCCESS _REVERSAL | 9999 | Error | |
| AUTOMATIC_FIXED_NOT_SUPPORTED | 9999 | Error | |
| NOT_FIXED_FOR_ERROR_STATE | 9999 | Error | |
| ERROR_FIXING_AND_REVERSING | 9999 | Error | |
| ERROR_FIXING_INCOMPLETE_DATA | 9999 | Error | |
| PAYMENT_NETWORK_BAD_RESPONSE | 9999 | Error | |
| 5 (Expired) | EXPIRED_TRANSACTION | 20 | Expired transaction |
Codes of the Payment Methods
The following codes applies for payment_method_type (Confirmation Page), payment_method_id (Confirmation Page), and polPaymentMethodType (Response Page).
| Code | lapPaymentMethodType (Response Page) |
Description |
|---|---|---|
| 2 | CREDIT_CARD | Credit Cards |
| 4 | PSE | PSE Bank transfers |
| 5 | ACH | ACH debits |
| 6 | DEBIT_CARD | Debit cards |
| 7 | CASH | Cash |
| 8 | REFERENCED | Referenced payment |
| 10 | BANK_REFERENCED | Payment in banks |
| 14 | SPEI | SPEI Bank transfers |
Commands Accepted by the Payments API
| Command | Description |
|---|---|
PING |
Used to ping the service. |
SUBMIT_TRANSACTION |
Used to send transactions of any kind. |
GET_PAYMENT_METHODS |
Used to query the shop’s available payment methods. |
GET_BANKS_LIST |
It is used to obtain the bank list for PSE transactions. |
Commands Accepted by the Query API
| Command | Description |
|---|---|
PING |
Used to ping the service. |
ORDER_DETAIL |
Used to query an order using its identifier. |
ORDER_DETAIL_BY_REFERENCE_CODE |
Used to query an order using its reference code. |
TRANSACTION_RESPONSE_DETAIL |
Used to check the response of a transaction. |
Accepted Currencies
| Currency | Name |
|---|---|
ARS |
Argentine Peso |
BRL |
Brazilian Real |
CLP |
Chilean Peso |
COP |
Colombian Peso |
CRC |
Costa Rican Colón |
GTQ |
Guatemalan Quetzal |
HNL |
Honduran Lempira |
MXN |
Mexican Peso |
PEN |
Peruvian Nuevo Sol |
SVC |
Salvadoran Colón |
USD |
US Dollar |
Order Status
| Status | Description |
|---|---|
NEW |
The order was created in the system |
IN_PROGRESS |
The order is being processed. |
AUTHORIZED |
The last transaction of the order is an approved authorization. |
CAPTURED |
The last transaction of the order is an approved capture. |
CANCELLED |
The last transaction of the order is an approved cancellation. |
DECLINED |
The last transaction of the order is declined. |
REFUNDED |
The last transaction of the order is an approved refund. |
CHARGEBACK |
The last transaction of the order is a Chargeback. Namely, corresponds to a lost Dispute. |
Transaction States
| State | Description |
|---|---|
APPROVED |
Approved transaction |
DECLINED |
Rejected transaction |
ERROR |
Error processing the transaction |
EXPIRED |
Expired transaction |
PENDING |
Pending transaction or in validation |
SUBMITTED |
Transaction sent to the financial institution but the processing did not finish. query API. |
Transaction Types
| Type | Description |
|---|---|
AUTHORIZATION |
Authorization transaction. |
AUTHORIZATION_AND_CAPTURE |
Charge transaction, Authorization and capture in one step. |
CAPTURE |
Capture Transaction. |
VOID |
Cancellation transaction of an authorization. |
REFUND |
Refund transaction or cancellation of a capture. |
Processing Countries
| Country Code | Country |
|---|---|
AR |
Argentina |
BR |
Brazil |
CL |
Chile |
CO |
Colombia |
CR |
Costa Rica |
GT |
Guatemala |
HN |
Honduras |
MX |
Mexico |
PA |
Panama |
PE |
Peru |
SV |
El Salvador |
Supported Languages
| ISO code 639 | Language |
|---|---|
en |
English |
es |
Spanish |
pt |
Portuguese |
Document Types
| ISO | Description | Country |
|---|---|---|
| CC | Citizenship card. | Colombia |
| CE | Foreign citizenship card. | Colombia, Peru |
| CEL | When identified by the mobile line. | Colombia |
| CEP | Electronic Payment Receipt | Mexico |
| CI | Identity Card. | Argentina, Chile |
| CNPJ | National Register of Legal Entities | Brazil |
| CPF | Registration of Individuals | Brazil |
| CUIL | Unique Labor Identification Code | Argentina |
| CUIT | Single Tax identification | Argentina |
| CURP | Unique Population Registry Code | Mexico |
| DE | Foreing Identifiaction Number | Peru |
| DL | Driver License | |
| DNI | National Identity Document | Argentina, Peru, Chile |
| DNIE | National Identity Document - Electronical | Argentina, Peru, Chile |
| EIN | Employer Identification Number | Peru |
| ID | Identification | |
| IDC | Client´s unique identifier, in the case of unique customer / utility consumer ID’s. | |
| IFE | Federal Electoral Institute | Mexico |
| LC | Civic Notebook | Argentina |
| LE | Book enlistment | Argentina |
| NIF | Tax identification number | |
| NIT | Tax identification number | Colombia |
| PP | Passport. | |
| RC | Birth certificate. | Colombia |
| RDE | RDE document type | |
| RE | RE document type | |
| RFC | Federal taxpayer registry | Mexico |
| RIF | Tax Information Registry | |
| RM | Commercial Register | |
| RMC | Consular Registration | |
| RNC | National Taxpayers Registry | |
| RUC | Unique Taxpayer Registration | Peru |
| RUN | Unique National Role | Chile |
| RUT | Unique Tributary Role | Chile |
| SC | Safe Passage | |
| SIEM | Mexican Business Information System | Mexico |
| SSN | Social Security Number | |
| TI | Identity Card. | Colombia |
Banks for Payouts
Send the exact value displayed in the Code column in the variable transfers[n].bankAccount.bankCode. Refer to Payouts for more information.
Colombia
| Code | Bank name |
|---|---|
001 |
BOGOTA |
002 |
POPULAR |
006 |
ITAU CORPBANCA |
007 |
BANCOLOMBIA |
009 |
CITIBANK COLOMBIA |
012 |
GNB SUDAMERIS |
014 |
ITAU |
013 |
BBVA |
019 |
SCOTIABANK |
023 |
BANCO DE OCCIDENTE |
031 |
BANCOLDEX |
032 |
BCSC |
040 |
BANCO AGRARIO |
041 |
JPMORGAN |
042 |
BNP PARIBAS |
047 |
MUNDOMUJER |
051 |
DAVIVIENDA |
052 |
AV VILLAS |
053 |
BANCO WWB |
059 |
BANCAMIA |
060 |
PICHINCHA |
061 |
BANCOOMEVA |
062 |
FALABELLA |
063 |
FINANDINA |
065 |
BCO SANTANDER DE NEGOCIOS |
066 |
COOPCENTRAL |
067 |
COOMPARTIR |
069 |
BANCO SERFINANZA |
070 |
LULO BANK |
071 |
BANCO JP MORGAN COLOMBIA |
083 |
COMPENSAR |
084 |
APORTES EN LINEA (GESTION Y CONTACTO) |
086 |
ASOPAGOS |
087 |
FEDECAJAS |
088 |
SIMPLE |
089 |
ENLACE OPERATIVO |
090 |
CORFICOLOMBIANA |
121 |
JURISCOOP |
283 |
COOPERATIVA FINANCIERA DE ANTIOQUIA |
289 |
COTRAFA |
292 |
CONFIAR COOPERATIVA FINANCIERA |
370 |
COLTEFINANCIERA S.A. - COMPANIA DE FINANCIAMIENTO |
507 |
NEQUI |
550 |
DECEVAL |
558 |
CREDIFINANCIERA S.A. |
683 |
DGCPTN |
685 |
DGCPTN-REGALIAS |
801 |
MOVII |
1062 |
BANCO FALABELLA S.A. |
1063 |
BANCO FINANDINA S.A. |
1069 |
BANCO SERFINANZA S.A. |
1283 |
COOPERATIVA FINANCIERA DE ANTIOQUIA |
1291 |
COOFINEP |
1292 |
CONFIAR COOPERATIVA FINANCIERA |
1303 |
GIROS Y FINANZAS |
1637 |
IRIS |
Last modified
September 30, 2024:
Documentation Updates (a1e8dbe3c)