If you are getting an error that you cannot solve when trying to create transactions, please get in touch with our Support team with the JSON body of the request you have sent.
API Errors
The following list includes the primary errors that can be received when a request is not accepted because it failed basic validation, such as authentication, required fields, or formatting rules.
In most of these cases, the transaction is not created, and the request must be corrected before retrying.
| Error Code | Description |
|---|---|
| 001_VALIDATION_ERROR | The transaction cannot be processed due to restrictions on the specified user. Contact Merchant Support for details. |
| BLOCKED_BY_CUSTOMER_LIMIT_RULE | The payout cannot be processed because the user has reached a risk prevention limit. |
| CUSTOMER_INVALID_AGE | The customer does not meet the minimum age requirement (underaged). |
| CUSTOMER_INVALID_ID | The provided personal identification number is invalid or does not match official records. |
| CUSTOMER_INVALID_STATUS | This message indicates that the customer's personal ID has been cancelled or invalidated by the government. |
| CUSTOMER_IS_IN_INTERNATIONAL_LISTS | This message indicates that the customer appears on international watchlists for Money Laundering and/or Terrorism Financing. |
| CUSTOMER_NOT_ALIVE | The provided identification number is associated with a deceased individual. |
| CUSTOMER_SUSPENDED | The document number has been suspended by the government due to suspected illegal activities. |
| INVALID_AMOUNT | The value sent for "amount" is not a valid integer. |
| PAYMENT_METHOD_NOT_ALLOWED | The payment method ID used in the request is not active or enabled and cannot be used. Please contact Merchant Support for more details. |
| PAYMENT_PSP_ERROR | Generic error message received from the PSP, normally originating from a timeout on the provider side during high-traffic instances. |
| TRANSACTION_CREATION_ERROR | The payment method used in the request is not active or shop credentials have been disabled. Contact Merchant Support. |
| TRANSACTION_INVALID_FIELD_COUNTRY | The "Country" field contains an unsupported or invalid country value. |
| TRANSACTION_INVALID_FIELD_CURRENCY | The "Currency" field contains an unsupported or invalid currency value. |
| TRANSACTION_INVALID_FIELD_LANGUAGE | The "Language" field of the request contains an invalid or unsupported language value. |
| TRANSACTION_MAX_AMOUNT | The "Amount" field contains a value that exceeds the maximum limit allowed for the requested payment method. |
| TRANSACTION_MIN_AMOUNT | The "Amount" field contains a value that is below the minimum limit allowed for the requested payment method. |
| TRANSACTION_NOT_FINISHED_BY_LANDING_INFO | The Transaction ID for GET Landing Info is not in PENDING status. |
| TRANSACTION_REQUIRED_COUNTRY | The "Country" field of the request contains an invalid or unsupported language value. |
| TRANSACTION_REQUIRED_CURRENCY | The "Country" field of the request contains an invalid or unsupported currency value. |
Processing Errors
The following list includes the primary errors that may occur after the transaction has been successfully created and is being processed with local providers or banking networks.
| Error Code | Description |
|---|---|
| 3DS_VERIFICATION_FAILED | The 3D Secure authentication failed. This usually occurs when the customer provides an incorrect OTP (One-Time Password) or fails the bank's security challenge. |
| ABORTED_PAYMENT | The payment process was terminated unexpectedly before reaching a final state, often due to a technical interruption or session timeout. |
| AUTHENTICATION_STEP_REQUIRED | The transaction requires additional identity verification from the user to be authorized. |
| BLOCKED_BANK_ACCOUNT | The payment could not be processed because the customer's bank account is restricted, frozen, or currently inactive. |
| CANCELLED_BY_USER | The transaction was manually cancelled by the customer before completion (e.g., closing the checkout window or clicking "Cancel"). |
| CORPORATE_BANK_ACCOUNT_PAYMENT_NOT_ALLOWED | The transaction was paid from a corporate bank account (CNPJ), which is not permitted for this operation. Applies to PIX payments in Brazil. |
| DECLINED_BY_RISK_VALIDATOR | The transaction was not completed because it did not pass the local provider's risk validation processes. |
| INPUT_INVALID | One or more details provided by the user during the payment process are incorrect or do not meet the required format. |
| INSUFFICIENT_FUNDS | The transaction was declined because the customer does not have enough balance or available credit to cover the payment amount. |
| INVALID_BANK_ACCOUNT | The bank account details entered for the payment are invalid. The account could not be found, does not exist in the bank's records, or has not been enabled for transactions. |
| INVALID_CARD_DATA | The transaction was declined due to incorrect or mismatched card information. |
| INVALID_PHONE_NUMBER | The phone number provided is invalid. It may be missing required digits, contain unsupported characters, or the country is not valid. |
| MAX_ATTEMPTS_EXCEEDED | The transaction was blocked because the maximum number of allowed attempts or the velocity limit for the card, IP address, or user has been exceeded. |
| NOT_ALLOWED | The transaction was declined due to security restrictions, unsupported operations, or invalid card status. |
| PAYER_ACCOUNT_NOT_REGISTERED | The payer account does not match the registered accounts enabled for this operation. Applies exclusively to the Brazil regulated market. |
| PAYER_CPF_NOT_EQUAL | The payer's personal ID (CPF) does not match the buyer's document number. Applies to PIX payments in Brazil. |
| PAYER_INVALID_ACCOUNT | The registered account details are invalid or incorrect. Applies exclusively to the Brazil regulated market. |
| PAYER_INVALID_ACCOUNT_DIGIT | The digit from the registered account details is invalid or incorrect. Applies exclusively to the Brazil regulated market. |
| PAYMENT_AMOUNT_NOT_EQUAL | The paid amount differs from the transaction amount. |
| PROCESSING_ERROR | The transaction could not be processed due to an internal system failure, provider unavailability, or a lack of confirmation from the financial institution. |
| REQUEST_TIMEOUT | Connection timed out during the transaction process. |
| TRANSACTION_MAX_AMOUNT | The payment amount exceeds the maximum limit allowed for the specific payment method or the merchant's current configuration. |
| TRANSACTION_MIN_AMOUNT | The payment amount is below the minimum required limit for the selected payment method. |
| UNEXPECTED_ERROR | An internal error occurred at the provider level while processing the transaction. Please ask the user to try again; if the issue persists, contact Merchant Support. |
| THIRD_PARTY_PAYMENT_NOT_ALLOWED | The payer's document number does not match the buyer's registered document number. |