When creating a transaction, if the value of one of the mandatory fields of the request is wrong you will receive an error message in the response that will explain the reason of the error. This page lists the different possible errors you can get when creating transactions with their associated meaning.
If you are getting an error that you cannot solve when trying to create transactions, please get in touch with our Tech Support team with the JSON body of the request you have sent.
Error Message | Description |
|---|---|
PAYMENT_METHOD_NOT_ALLOWED | The payment method ID used in the request is not active or enabled, and cannot be used. |
PAYMENT_PSP_ERROR | Generic error message received from the PSP, normally originated from a timeout on the PSP side in high traffic instances. |
TRANSACTION_INVALID_FIELD_LANGUAGE | The "Language" field of the request contains an invalid language value. |
TRANSACTION_INVALID_FIELD_CURRENCY | The "Currency" field contains an unsupported or invalid currency value. |
TRANSACTION_INVALID_FIELD_COUNTRY | The "Country" field contains an unsupported or invalid country value. |
TRANSACTION_MIN_AMOUNT | The “Amount” field contains a value that is below the minimum limit for the requested payment method. |
TRANSACTION_MAX_AMOUNT | The “Amount” field contains a value that exceeds the maximum limit for the requested payment method. |
INVALID_AMOUNT | The value sent for “amount” is not an integer. |
TRANSACTION_REQUIRED_COUNTRY | The "Country" parameter is empty. |
TRANSACTION_REQUIRED_CURRENCY | The "Currency" parameter is empty. |
TRANSACTION_NOT_FINISHED_BY_LANDING_INFO | The TransactionID for GET Landing Info is not in PENDING status. |
TRANSACTION_BLOCKED BY_CUSTOMER_LIMIT_RULE | The daily/monthly limit of transaction attempts for this customer has been reached, and no transactions can be generated for the customer until the next day/week/month. |
PAYMENT_PSP_ERROR | Generic error message received from the payment partner PSP, usually comes from a timeout on PSP’s side in high traffic instances. |
TRANSACTION_CREATION_ERROR | The payment method used in the request is not active and cannot be used. Shop credentials have been disabled. |
PAYMENT_AMOUNT_NOT_EQUAL | The paid amount differs from the original amount or QR amount |
PAYER_CPF_NOT_EQUAL | The payer's document number(CPF) does not match the buyer's document number |
CORPORATE_BANK_ACCOUNT_PAYMENT_NOT_ALLOWED | The transaction was paid from a corporate bank account. |
CUSTOMER_INVALID_AGE | Underaged. |
CUSTOMER_INVALID_STATUS | This message indicates that the customer CPF has been cancelled by the government. |
CUSTOMER_IS_IN_INTERNATIONAL_LISTS | This message indicates that the customer is in international lists for Money Laundering and/or Terrorism Financing. |
CUSTOMER_SUSPENDED | Document number suspend by government triggered/criminal illegal activities. |
CUSTOMER_INVALID_ID | This message means that the provided personal identification number (cédula de identidad) is invalid or does not match the records. |
Additionally, you may receive an error message that is unique to a specific country or payment solution. Below is a breakdown of these error messages.
Argentina
| Error Message | Description |
|---|---|
| CUSTOMER_INVALID_AGE | This message indicates that the customer does not meet the minimum age requirement to perform the transaction. |
| CUSTOMER_NOT_ALIVE | This message states that the customer has been recorded as deceased, preventing the approval of the transaction. |
| CUSTOMER_INVALID_ID | This message means that the provided identification number for the customer is invalid or does not match the records. |
| CUSTOMER_IS_IN_INTERNATIONAL_LISTS | This message indicates that the customer is on international risk lists, which could associate them with illicit activities such as money laundering or terrorist financing. |
| CUSTOMER_NOT_FOUND | This message indicates that the customer is can not be found in order to make an identity or risk check. |
Brazil
| Error Mesage | Description |
|---|---|
| CUSTOMER_INVALID_AGE | This message indicates that the customer does not meet the minimum or maximum age requirement to perform the transaction. |
| CUSTOMER_NOT_ALIVE | This message indicates that the provided identification number for the customer belongs to a decesed individual. |
| CUSTOMER_INVALID_ID | This message means that the provided identification number for the customer is invalid or does not match the records. |
| CUSTOMER_IS_IN_INTERNATIONAL_LIST | The person is included in international lists for Money Laundering and/or Terrorism Financing. |
| CUSTOMER_SUSPENDED | This message indicates that the customer has a suspended CPF. |
| CUSTOMER_INVALID_STATUS | This message indicates that the customer CPF has been cancelled by the government. |
| PAYMENT_AMOUNT_NOT_EQUAL | The paid amount is different from the original amount in the transaction. |
| THIRD_PARTY_PAYMENT_NOT_ALLOWED | The payer 's document number does not match the buyer's document number. |
| PAYER_CPF_NOT_EQUAL | The payer 's document number does not match the buyer's document number. |
| PAYER_CNPJ | The transaction was paid by a corporate bank account |
Brazil Account Related Errors
| Error Message | Description |
|---|---|
| PAYER_ACCOUNT_NOT_REGISTERED | The payer account doesn't match with the registered accounts enabled for this operation |
| PAYER_INVALID_ACCOUNT | The account details registered are invalid or incorrect. |
| PAYER_INVALID_ACCOUNT_DIGIT | The digit from the registered account details are invalid or incorrect. |
Costa Rica
| Error Message | Description |
|---|---|
| CUSTOMER_INVALID_AGE | This message indicates that the customer does not meet the minimum age requirement to perform the transaction. |
| CUSTOMER_NOT_ALIVE | This message indicates that the customer has been recorded as deceased, which prevents the approval of the transaction. |
| CUSTOMER_INVALID_ID | This message means that the provided personal identification number (cédula de identidad) is invalid or does not match the records. |
| CUSTOMER_IS_IN_INTERNATIONAL_LISTS | This message indicates that the customer is in international lists for Money Laundering and/or Terrorism Financing. |
Mexico
| Error Message | Description |
|---|---|
| CUSTOMER_INVALID_AGE | This message indicates that the customer does not meet the minimum or maximum age requirement to perform the transaction. |
| CUSTOMER_NOT_ALIVE | This message indicates that the provided identification number for the customer belongs to a decesed individual. |
| CUSTOMER_IS_IN_INTERNATIONAL_LIST | This message indicates that the customer is in international lists for Money Laundering and/or Terrorism Financing. |
Mexico SPEI Related Errors
| Error Message | Description |
|---|---|
| THIRD_PARTY_PAYMENT_NOT_ALLOWED | The payer 's document number does not match the buyer's document number. |
| PAYMENT_AMOUNT_NOT_EQUAL | The paid amount is different from the original amount in the transaction. |