---
updatedAt: 2026-10-26T18:17:04.000Z
agentTools:
  projectIndex: https://docs.bamboopayment.com/llms.txt
---

# 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.<br />*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.                                                                                                                                           |

<br />

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

<Callout icon="❗️" theme="error">
  ### Error Code

  The error code for unknown or undetermined errors is `ERR999`. In this case, contact [Bamboo support](mailto:support@bamboopayment.com)  for more information.
</Callout>

<br />

## 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.                              | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> 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.                                  | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information. |
| `TK013` | Error in registration process.                                 | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information. |
| `TK014` | Payment method disabled.                                       | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> 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.                                                 | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information. |

<br />

<br />

## TR - Transaction errors

Transaction errors always starts with `TR`.

| Code    | Description                                                                                                                                                 | Possible solution                                                                                                                                      |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `TR001` | Communication error with the acquiring service.                                                                                                             | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR002` | Transaction state does not allow the requested operation.                                                                                                   | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR003` | Problems with the merchant account at the Acquirer.                                                                                                         | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR004` | Error sending transaction to the Acquirer via Proxy.                                                                                                        | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR005` | Acquirer’s internal error.                                                                                                                                  | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR006` | Duplicate order number at the Acquirer.                                                                                                                     | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR007` | Payment data errors, including card details (card number, CVV, or expiration date) or payment-method-specific verification data, such as an OTP for an APM. | Ask your customer to verify the payment information or the verification code required by the selected payment method, then 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.                                                                                                                   | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support </Anchor> 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.                                                                                                                                   | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR018` | Card registration denied by Acquirer.                                                                                                                       | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR019` | Transaction rejected.                                                                                                                                       | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> 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.                                                                                                                        | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> 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.                                                                                           |
| `TR029` | Transaction declined. Try again later                                                                                                                       | Ask your customer to try again later. If it persists, <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> |
| `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.                                                                          |
| `TR038` | Missing or invalid phone number for an alternative payment method (APM) that requires a valid phone number.                                                 | Missing or invalid phone number required to complete the transaction.                                                                                  |
| `TR039` | Subscription cancelled by the user.                                                                                                                         | Subscription cancelled by the user.                                                                                                                    |
| `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.                                                                                                                                 | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR101` | Refund not supported by Acquirer.                                                                                                                           | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR301` | Rejected by anti-fraud system.                                                                                                                              | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> to review affected rule.                              |
| `TR302` | Invalid anti-fraud parameters.                                                                                                                              | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> to review affected rule.                              |
| `TR996` | Internal processing error.                                                                                                                                  | Try again later. If it persists, <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">contact support.</Anchor>                     |
| `TR997` | Error during process execution.                                                                                                                             | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |
| `TR999` | Undetermined transaction error.                                                                                                                             | <Anchor target="_blank" href="mailto:merchantsupport@bamboopayment.com">Contact support</Anchor> for more information.                                 |

<br />

<br />

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

<br />

<br />

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

<br />

<br />

## LP - Loyalty Plan errors

Only for Puntos Santander Payment Method in Uruguay. (UY)<br />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.                                                                     |