Error messages in Rebill
Learn about the possible causes of rejected payments in the Rebill gateway, understanding their error messages and each solution.
When collecting payments using Rebill, as with any other payment gateway, you will have to establish support processes and ways to face payment rejections.
It is indeed way easier to do so if you have information about the reason why a particular payment is being rejected and how to solve it.
What is a rejected payment?
It's a transaction that, for some reason (for example: error in the data entered, insufficient funds or fraud alert), could not be completed successfully.
Understanding their respective reason and how to drive the solution proactively will allow you to reduce the number of rejected payments in the future.
Errors un multiple languages
You may obtain the description of an error messages in several languages using the location codes. To do so, you must send the header langin your integration, using one of the following languages in ISO 639-1 format.
| Code | Language |
|---|---|
EN | English. This is the default language. If you do not send a header or send an unsupported language in the header, you will receive error messages in this language. |
ES | Spanish |
PT | Portuguese |
Error messages: Rebill
All the reasons, error messages and solutions for rejected payments when processing payments with Rebill.
Tokenization service errors
| Code | Error message | Meaning | Solution |
|---|---|---|---|
| TK001. | INVALID_CARD_PAN | Invalid card number | Verify card number or try with a different payment method |
| TK002 | INVALID_CVV | Invalid cvv number | Verify card cvv or try with a different payment method |
| TK003 | INVLALID_EXPIRATION_DATE | Invalid expiration date | Verify card expiration date or try with a different payment method |
| TK004 | INVALID_SESSION_IDENTIFIER | An invalid session identifier was sent in the token request | Try with again or try with a different payment method |
| TK005 | INVALID_EMAIL | Invalid email | Verify the used email address or try with a different one |
| TK007 | INVALID_PAYMENT_MEDIA | Payment method not matching the expected one | Verify payment method and try again |
| TK008 | ISSUER_BANK_NOT_MATCH | Issuer Bank not matching the expected one | Verify payment method and try again |
| TK009 | INVALID_ACTIVATION_CODE | Invalid activation token | Try with a different payment method |
| TK010 | INVALID_COMMERCE_TOKEN | Invalid merchant token | Try with a different payment method |
| TK011 | CUSTOMER_NOT_FOUND | The specified customer was not found | Verify the customer entity exists in the system |
| TK012 | TOKEN_ACTIVATION_ERROR | Error when activating token | Try with a different payment method |
| TK013 | TOKEN_REGISTRY_VOID_ERROR | Error during the registry process | Try with a different payment method |
| TK014 | TOKEN_PAYMENT_MEDIA_DISABLED | Disabled payment method | Try with a different payment method |
| TK015 | TOKEN_PAYMENT_MEDIA_UNAVAILABLE | Payment method not available for this merchant | Try with a different payment method |
| TK016 | PAYMENT_MEDIA_REGISTRY_FAILS | An error ocurred during the payment method registry process | Try transaction again |
| TK017 | INVALID_DOCUMENT_NUMBER | Invalid personal identification number | Verify personal identification number and try transation again |
| TK018 | INVALID_DOCUMENT_TYPE | Invalid personal identification type | Verify personal identification type and try transaction again |
| TK999 | UNKNOWN_ERROR | Error not identified | Verify details of provided payment method and try transaction again or try with a different payment method |
Purchase service errors
| Code | Error message | Meaning | Solution |
|---|---|---|---|
| PR001 | INVALID_TOKEN | Informed token is not valid or it has expired | Update your merchant token |
| PR002 | INVALID_ORDER | Invalid order number | Try with a different value for the order |
| PR003 | INVALID_AMOUNT | Informed amount is not valid | Try with a different amount |
| PR004 | INVALID_CURRENCY | Informed currency is not valid | Try with a valid currency |
| PR005 | INVALID_INVOICE | Invoice number is not valid (Must be numeric) | Verify invoice number only contains numbers |
| PR006 | INVALID_PURCHASE_IDENTIFIER | Purchase identifier could not be found | Verify purshase identifier and try transaction again |
| PR007 | INVALID_TRANSACTION_IDENTIFIER | Transaction identifier could not be found | Verify transaction identifier and try transaction again |
| PR008 | PURCHASE_NOT_FOUND | Purchase identifier could not be found | Verify purshase identifier and try transaction again |
| PR009 | INVALID_PURCHASE_STATE | The current status of the purchase does not allow to do the required action | Verify the purchase has a valid status for the required action and try transaction again |
| PR010 | TAXABLE_AMOUNT_REQUIRED | The taxable amount is required | Specify the taxable amount and try transaction again |
| PR011 | INVOICE_REQUIRED | Invoice number is required | Specify an invoice number and try transaction again |
| PR012 | INVALID_CAPTURED_CVV_REQUIRED | The cvv capture is required | Specify the capture of the cvv and try transaction again |
| PR013 | INVALID_INSTALLMENTS | The selected installment plan is not supported for the payment method provided by the customer | Try with a card that supports the desired instalment |
| PR014 | INVALID_DESCRIPTION_LENGTH | The length of the description parameter is invalid | Use a valid description length |
| PR015 | INVALID_CUSTOMER_USER_AGENT_EMPTY | The UserAgent parameter is empty | Specify an UserAgent parameter and try transaction again |
| PR016 | INVALID_CUSTOMER_IP_EMPTY | User IP parameter is empty | Specify an IP parameter and try transaction again |
| PR017 | TAXABLE_AMOUNT_GREATER_THAN_AMOUNT | Taxable amount is greater than transaction amount | Verify the taxable amount and try transaction again |
| PR018 | PR_DATE_NEEDED | In order to filter by time periods you need to complete From and To fields | Complete From and To fields with valid values and try transaction again |
| PR019 | EXCEED_DATE_RANGE | The specified search period must not be greater than the following amount of days | Use a valid search period and try transaction again |
| PR020 | INVALID_DOCUMENT_NUMBER | The provided personal identification is not valid | Provide a valid personal identification and try transaction again |
| PR021 | NOT_ALLOW_PARTIAL_REFUND | Partial reimbursements ar not supported by the customer payment method | Try reimbursing the full amount of the transaction and charge the customer back the desired amount aftewards |
Customer service errors
| Code | Error message | Meaning | Solution |
|---|---|---|---|
| CS001 | INVALID_EMAIL | Invalid email | Verify the used email address or try with a different one |
| CS002 | INVALID_ADDRESS_TYPE | Invalid address type | Verify the used address type or try with a different one |
| CS003 | INVALID_CUSTOMER_IDENTIFIER | Invalid customer ID | Verify customer ID and try transaction again |
| CS004 | TOKEN_CREATION_FAILED | Error during token creation | Try transacation againg or try with a different payment method |
| CS005 | EMAIL_ALREADY_EXISTS | Provided email address already exists | Try with a different email address |
| CS006 | INVALID_ADDITIONAL_DATA | AdditionalData is not properly formed | Verify that the value it is separated with a ; |
| CS007 | INVALID_CUSTOMER_DOCUMENT | Invalid personal identification number | Verify personal identification number and try transation again |
| CS008 | INVALID_CUSTOMER_DOCUMENT_TYPE | Invalid personal identification type | Verify personal identification type and try transaction again |
| CS009 | TOKEN_ALREADY_EXISTS | A CommerceToken already exists for the provided card | Try transaction with a differnet payment method |
| CS010 | INVALID_PAYMENT_PROFILE | The Payment Profile is invalid | Verify Payment Profile and try transaction again |
| CS011 | INVALID_PAYMENT_PROFILE_IDENTIFIER | The Payment Profile identifier is invalid | Verify Payment Profile identifier and try transaction again |
Transaction service errors
| Code | Error message | Meaning | Solution |
|---|---|---|---|
| TR001 | COMMUNICATION_ERROR | Communication error with the adquirer service | Try transaction again |
| TR002 | INVALID_TRANSACTION_STATE | The asociated transaction to this purchase is in a status that not allows the execution of the current operation. This happens, e.g when a 'Commir' operation it is executed upon a purchase that was already approved or rejected | Verify the asociated transaction purchase status and try transaction again |
| TR003 | ACQUIRER_ACCOUNT_PROBLEM | Problems with the adquirer merchant's account | Try transcation again, if failed get in touch with your payment provider |
| TR004 | ACQUIRER_PROXY_ERROR | Error when sending the transaction to the acquire | Try transcation again, if failed get in touch with your payment provider |
| TR005 | ACQUIRER_PROBLEM | Issuer is offline or problem linked to the adquirer | Try transcation again, if failed get in touch with your payment provider |
| TR006 | ACQUIRER_DUPLICATED_ORDER | Order number is duplicated in the adquired | Get in touch with your payment provider |
| TR007 | INVALID_PAYMENT_MEDIA | Error in the card details (Number, cvv and/or cvv) | Verify card details and try transaction again or try with a different payment method |
| TR008 | COMMIT_AMOUNT_GREATER_THAN_AUTHORIZED | The amount trying to be approved is greater than the previusly authorized | Try using a valid amount |
| TR009 | ACQUIRER_UNKNOWN_ERROR | Adquired unknown error | Try transcation again, if failed get in touch with your payment provider |
| TR010 | ACQUIRER_INVALID_DOCUMENT | The personal identification number provided to the adquired is not valid | Provied a valid personal identification number and try transaction again |
| TR011 | BLOCKED_OR_LOST_CARD | Card reported as lost or blocked | Try transaction againg using a valid payment method |
| TR012 | ACQUIRER_LIMIT_EXCEEDED | Credit limit exceeded | Try transaction againg using a different payment method |
| TR013 | ACQUIRER_DENIED_TRANSACTION | The transaction was rejected by the adquirer | Try transaction again using a different payment method |
| TR014 | ACQUIRER_POSSIBLE_FRAUD | The transaction was rejected by the adquired for possible fraud or suspicious activity | Try transaction again using a different payment method |
| TR015 | ACQUIRER_REVIEW_NEEDED | The transaction is being manually reviewed by adquirer suggestion | Wait for transaction final status. If failed try transaction using a different payment method |
| TR016 | ACQUIRER_INVALID_PARAMETER | Error in parameters sent to the adquirer | Verify parameters sent the adquirer and try transaction again |
| TR017 | INVALID_TRANSACTION_TYPE | Invalid transaction type | Try again using a supported transaction type or a different payment method |
| TR018 | REGISTRATION_DENIED | The registration was rejected by the adquirer | Try transaction again |
| TR019 | ACQUIRER_TRANSACTION_REJECTED | The transaction was rejected by the adquirer | Try transaction again using a different payment method |
| TR020 | ISSUER_DECLINE_CALL | The transaction was rejected by the adquirer, but it can be authorized by calling the issuer | Call the issuer to authorize the transaction or try using a different payment method |
| TR021 | ISSUER_EXPIRED_CARD | The card is expired or the provided expiry date does not match | Verify the expiry date of the provided payment method or try transaction again using a different payment method |
| TR022 | ISSUER_INVALID_CVV | The issuer indicates that the cvv is not valid | Verify card cvv and try transaction againg or try using a different payment method |
| TR023 | ISSUER_RESTRICTED_CARD | The card is not active or not authorize for this type of transactions | Try transaction again using a different payment method |
| TR024 | ACQUIRER_FRECUENCY_EXCEEDED | The number of authorize transactions or amount was used for this card during an specified period | Try transaction with a different payment method |
| TR025 | ACQUIRER_INVALID_ADDRESS | The provided home address is not valid | Provide a valid home address and try transaction again |
| TR075 | PAYER_AUTHENTICATION_REQUIRED | 3DSecure indicates that customer validation is needed | Validate customer and try transaction again |
| TR076 | PAYER_AUTHENTICATION_FAILED | The user authentication failed (VbV) | Try transaction again |
| TR100 | ACQUIRER_OTHER_REASONS | The adquirer rejected the payment for several reasons | Try transaction again or provide a different payment method |
| TR101 | ACQUIRER_REFUND_ERROR | The adquirer could not process the refund. | Get in touch with your payment provider |
| TR301 | Antifraud_Reject | Rejected by the anti-fraud engine | Try transaction using a different payment method |
| TR302 | Antifraud_Invalid_Parameter | Invalid parameters provided to the anti-fraud engine | Try transaction using a different payment method |
| TR997 | TRANSACTION_STEP_ERROR | And error occurred when executing current process | Try transaction again or try using a different payment method |
| TR999 | UNKNOWN | Error not identified | Verify details of provided payment method and try transaction again or try with a different payment method |
Generic errors
| Code | Error message | Meaning | Solution |
|---|---|---|---|
| Unknown | The error message is not specified | Error message displayed when the error is not identified | Try transaction again or try with a different payment method |
Updated about 1 month ago