Error Codes

Multilanguage for errors

You can receive the error description by relying on localization features. To do this, you need to send the lang header in your integration, using any of the following languages in ISO 639-1 format.

Code	Language
`en`	English. This is the default language. If you don't send this header or set a non-existent language, you will receive errors in this language.
`es`	Spanish.
`pt`	Portuguese.

HTTP Codes

Code	Description	Usage
`200`	Ok	The request was processed successfully.
`400`	Bad Request	The request is malformed or missing some required parameter.
`401`	Unauthorized	Authentication failure.
`403`	Forbidden	You don't have permission to perform the requested operation.
`404`	Not Found	The resource requested was not found.
`405`	Method not Allowed	Incorrect request method (e.g., GET instead of POST).
`408`	Request Timeout	The request could not be completed within the configured maximum time.
`500`	Internal Server Error	An error occurred in the service.
`503`	Service Unavailable	The service is undergoing maintenance or experiencing access issues.

❗️
Error Code
The error code for unknown or undetermined errors is ERR999. In this case, contact Bamboo support for more information.

TK - Tokenization errors

Tokenization errors always starts with TK.

Code	Description	Possible solution
`TK001`	The card number entered is incorrect.	Ask your customer to check the card number and retry the transaction.
`TK002`	The CVV number entered is incorrect.	Ask your customer to check the validation code and retry the transaction.
`TK003`	The card expiration date is incorrect.	Ask your customer to check the expiration date and retry the transaction.
`TK004`	An invalid session ID was sent in a token request.	Regenerate the token and retry the transaction.
`TK005`	An email with incorrect format was entered.	Ask your customer to check the email address and retry the transaction.
`TK006`	The token (One-Time type) has already been used or is expired.	Regenerate the token and retry the transaction.
`TK007`	Error with the information of the payment method.	Check that the payment method ID used is valid for the selected country.
`TK008`	Issuer bank does not match the expected.	Validate the issuer bank of your customer's card.
`TK009`	Token activation code is invalid.	Contact support for more information.
`TK010`	Commerce Token is invalid.	Regenerate the token and retry the transaction.
`TK011`	The specified customer is not valid.	The customer used to create the token was not found or is invalid.
`TK012`	Error while activating token.	Contact support for more information.
`TK013`	Error in registration process.	Contact support for more information.
`TK014`	Payment method disabled.	Contact support for more information.
`TK015`	The payment method is not available for the commerce.	Verify that the selected payment method is enabled for your account.
`TK016`	Error registering the payment method.	Contact support for more information.
`TK017`	Invalid document.	The document provided is not valid according to the country rules.
`TK018`	Invalid document type.	The document type sent is not valid or does not belong to the country.
`TK019`	Invalid payment type.	The payment type selected is not valid or does not belong to the country.
`TK999`	Unknown error.	Contact support for more information.

TR - Transaction errors

Transaction errors always starts with TR.

Code	Description	Possible solution
`TR001`	Communication error with the acquiring service.	Contact support for more information.
`TR002`	Transaction state does not allow the requested operation.	Contact support for more information.
`TR003`	Problems with the merchant account at the Acquirer.	Contact support for more information.
`TR004`	Error sending transaction to the Acquirer via Proxy.	Contact support for more information.
`TR005`	Acquirer’s internal error.	Contact support for more information.
`TR006`	Duplicate order number at the Acquirer.	Contact support for more information.
`TR007`	Payment data errors (card number, CVV, or expiration date).	Ask your customer to verify the card information and retry.
`TR008`	Confirmed amount exceeds the original authorization.	Send an equal or lower amount than originally authorized.
`TR009`	Unknown Acquirer error.	Contact support for more information.
`TR010`	Invalid document number.	Ask your customer to verify the document and retry, or contact their bank.
`TR011`	Blocked or lost card.	Ask your customer to verify the card or contact their bank.
`TR012`	Credit limit exceeded.	Ask your customer to use a different card or free up available funds.
`TR013`	Transaction denied by Acquirer or Issuer.	Contact support for more information.
`TR014`	Transaction denied for possible fraud.	Contact the acquirer to review anti-fraud rules.
`TR015`	Manual review suggested.	Contact support for more information.
`TR016`	Incorrect or incomplete customer data.	Ask your customer to verify their information. Contact support if needed.
`TR017`	Invalid transaction type.	Contact support for more information.
`TR018`	Card registration denied by Acquirer.	Contact support for more information.
`TR019`	Transaction rejected.	Contact support for more information.
`TR020`	Issuer denied transaction; verbal auth possible.	Ask your customer to contact their bank to authorize the purchase.
`TR021`	Expired card or mismatched expiration date.	Ask your customer to verify the card's expiration date.
`TR022`	Invalid CVV.	Ask your customer to verify the card's CVV.
`TR023`	Card not enabled for online purchases.	Ask your customer to enable online purchases or verify regional availability.
`TR024`	Usage frequency or amount limit exceeded.	Ask your customer to contact their bank and try again later.
`TR025`	Invalid or unvalidated address data.	Contact support for more information.
`TR026`	Insufficient funds.	Ask your customer to try another card or free up funds.
`TR027`	Authorization required from issuer.	Ask your customer to contact their bank.
`TR028`	Mismatched payment amount.	Ask your customer to retry with the correct purchase amount.
`TR030`	Retry limit exceeded.	Ask your customer to use a different card.
`TR031`	Account closed.	Ask your customer to contact their bank or use a different card.
`TR032`	Declined – contact bank.	Ask your customer to contact their card issuer bank.
`TR033`	Installments not allowed for international cards.	Ask your customer to use a domestic card for installments.
`TR035`	Missing bank information for refund.	Refund could not be processed. Customer must complete bank data.
`TR036`	Invalid or mismatched bank data for refund.	Refund could not be processed. Bank data must be valid and match beneficiary.
`TR075`	3DSecure validation required.	Customer validation (e.g., Verified by Visa) is required.
`TR076`	3DSecure authentication failed.	Ask your customer to check 3DS configuration and retry the purchase.
`TR100`	General Acquirer rejection.	Contact support for more information.
`TR101`	Refund not supported by Acquirer.	Contact support for more information.
`TR301`	Rejected by anti-fraud system.	Contact support to review affected rule.
`TR302`	Invalid anti-fraud parameters.	Contact support to review affected rule.
`TR996`	Internal processing error.	Try again later. If it persists, contact support.
`TR997`	Error during process execution.	Contact support for more information.
`TR999`	Undetermined transaction error.	Contact support for more information.

PR - Purchase errors

Purchase errors always starts with PR.

Code	Description
`PR001`	The informed token is invalid, expired or does not correspond to the commerce.
`PR002`	The order number is invalid.
`PR003`	The provided amount is invalid. Ensure it is not null or empty, and in the case of refunds, ensure it does not exceed the original purchase amount.
`PR004`	Invalid Currency parameter for the Purchase.
`PR005`	The invoice number is invalid (it must be numeric).
`PR006`	Invalid Purchase Id for the Purchase.
`PR007`	Invalid `TransactionID` for the Purchase.
`PR008`	The requested purchase cannot be found.
`PR009`	The current purchase state does not allow the requested operation.
`PR010`	The `TaxableAmount` field is required.
`PR011`	The `Invoice` filed is required.
`PR012`	Capture of the card verification code is required.
`PR013`	The selected installments for the purchase are invalid for the card.
`PR014`	Invalid parameter length description.
`PR015`	`UserAgent` parameter is empty.
`PR016`	`CustomerIP` parameter is empty.
`PR017`	The field `TaxableAmount` cannot be greater than the purchase total amount.
`PR018`	To filter by dates, you must enter value for `From` and `To` parameters.
`PR019`	The search period exceeds the maximum number of days.
`PR020`	Invalid registered document.
`PR021`	Partial refunds are not allowed for the payment method used.
`PR034`	The value of the `TargetCountryISO` field sent in the purchase is invalid.

CS - Customer errors

Customer always starts with CS.

Code	Description
`CS001`	Invalid e-mail address.
`CS002`	Invalid address type.
`CS003`	Invalid customer identifier.
`CS004`	An error occurred in the token creation.
`CS005`	E-mail already registered.
`CS006`	The parameter `AdditionalData` was not sent correctly, it must be `key:value` separated by semicolon.
`CS007`	Invalid customer document number.
`CS008`	Invalid customer document type.
`CS009`	There was already a `CommerceToken` for the card.
`CS010`	Invalid Payment Profile.
`CS011`	Invalid Payment Profile Identifier.

LP - Loyalty Plan errors

Only for Puntos Santander Payment Method in Uruguay. (UY)
Loyalty plan errors always starts with LP.

Code	Description
`LP004`	The program does not exist.
`LP005`	The redemption center does not exist.
`LP006`	The branch does not exist.
`LP007`	The program is not active.
`LP008`	The redemption center is not enabled.
`LP009`	The redemption center does not belong to the program.
`LP010`	The redemption center is not active for the program.
`LP011`	The branch does not belong to the redemption center.
`LP012`	The user does not exist.
`LP013`	The user does not belong to the program.
`LP014`	The currency does not exist.
`LP015`	The quotation does not exist.
`LP016`	The document type does not exist.
`LP017`	The customer does not exist.
`LP018`	The balance does not exist.
`LP019`	Token not found.
`LP020`	Card not found.
`LP021`	Card expired.
`LP022`	Syntax error in the Program.
`LP023`	Syntax error in the Redemption Center.
`LP024`	Syntax error in the Branch.
`LP025`	Syntax error in the Currency.
`LP026`	Syntax error in the Import.
`LP027`	Syntax error in the user identification (`LoyaltyPlanUserIdentification`).
`LP028`	Syntax error in the masked card.
`LP029`	Syntax error in the Transaction Id.
`LP030`	Syntax error in the gateway Transaction Id.
`LP031`	Syntax error in the number of points.
`LP032`	Syntax error in the number of installments.
`LP033`	Syntax error in the token (Authorization).
`LP034`	The request has an invalid syntax. It is too big or it has an invalid format message.
`LP035`	Invalid credentials.
`LP036`	The logged user is not allowed to see the customer data.
`LP037`	The resource requested cannot be found.
`LP038`	The loyalty plan is mandatory.
`LP039`	The Customer Id of the loyalty plan is mandatory.
`LP040`	Input data error.
`LP041`	The customer is not authorized.
`LP042`	Insufficient balance.
`LP043`	The token has expired.
`LP044`	The movement is canceled.
`LP045`	The movement does not exist.
`LP046`	The number of points sent does not match the points in the movement.
`LP047`	The movement has already been refunded.
`LP048`	The movement is a refund.
`LP049`	The gateway does not exist.
`LP050`	`CustomerId` with the wrong format.
`LP051`	The point does not exist.
`LP052`	The amount sent does not match the amount in the movement.
`LP053`	The currency sent does not match the currency in the movement.
`LP054`	The customer does not exist or is not active.
`LP055`	Customer blocked.