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