> ## Documentation Index
> Fetch the complete documentation index at: https://developer.transactbridge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors And Status Code

This page lists the error codes and transaction status codes returned by the TransactBridge APIs and payment service providers (PSPs).

## Error Codes

These error codes represent specific API errors. The `error_code` parameter is returned only when a specific error occurs and may not be present in every response.

| Error Code | Description |
| :- | :- |
| `02` | The amount is not within the minimum and maximum bounds for a deposit transaction. |
| `03` | The amount is not within the minimum and maximum bounds for a withdrawal transaction. |
| `07` | The risk threshold was exceeded for this payment. |
| `08` | Previous database changes are queued. Please wait and try again. |
| `09` | API authentication is incorrect. |
| `10` | No payment method is configured for this account. |
| `11` | Reference ID already exists. |
| `13` | The entered PIN code is incorrect. |
| `14` | Invalid GST number. |
| `15` | GST service is currently unavailable. |
| `16` | GST number is inactive. |
| `18` | The entered payment method is not active for this account. |
| `19` | GST number does not exist. Please check the GST number. |
| `20` | Expiry time must be in the future and greater than the current timestamp. |
| `21` | The amount is less than the minimum allowed. |
| `22` | The amount is greater than the maximum allowed. |
| `23` | The item is not allowed to be sold in the jurisdiction. |
| `25` | The price is less than the minimum allowed item price. |
| `26` | The price is greater than the maximum allowed item price. |
| `27` | Customer suspended due to unusual activity. |
| `401` | Authentication failed. |
| `404` | The requested object cannot be found. |
| `406` | You do not have permission for this operation. Repeated attempts may lead to a temporary ban. |
| `407` | PSP is not configured properly. |
| `411` | The partner has reached its daily payment volume quota for the specified payment method. A different payment method may be used if available. |
| `412` | The partner has reached its daily payment volume quota across all payment methods. Contact the administrator to increase the volume quota. |
| `422` | Invalid request format (body or headers). |
| `429` | Too many requests. |
| `430` | Invalid card details. |
| `431` | Card data entered is invalid. |
| `432` | Invalid UPI handle. |
| `433` | The email address in the request body is disposable and is not allowed. |
| `500` | Internal server error. |
| `503` | The request cannot be processed due to unknown reasons. |
| `504` | Error in the PSP request. |
| `505` | PSP internal error. |

## Transaction Status Codes

These transaction status codes represent specific acquirer messages. The `tx_status_code` parameter is returned only when a specific error occurs and may not be present in every response.

| Tx Status Code | Description |
| :- | :- |
| `100` | The transaction did not reach the bank in time and timed out. |
| `101` | Transaction cancelled by the user. |
| `102` | Transaction cancelled due to insufficient balance. |
| `103` | Transaction failed at the acquirer due to an unknown reason. |
| `104` | Transaction failed at the user end due to an unknown reason. |
| `105` | Transaction failed because payment was not completed within the due time. |
| `106` | Transaction failed because of an invalid UPI ID or account number. |
| `500` | Transaction failed because the bank server was down. |

## Data Format Errors

These errors are specific messages when the data is not allowed by the validator.

| Validator | Description |
| :- | :- |
| `multiComment` | Allowed characters: alphabets, numerals, spaces, dots, slashes, hyphens, parentheses, and URL links. Maximum length: 256 characters. |
| `multiLineDescription` | Allowed characters: alphabets, numerals, spaces, dots, slashes, hyphens, parentheses, and the `@` symbol. Maximum length: 256 characters. |
| `onlyAlphaNumeric` | Allowed characters: alphabets and numerals. Maximum length: 256 characters. |
| `gstNumberFormat` | Allows alphabets and numerals. Must follow the GST number format prescribed by the Government of India. Maximum length: 15 characters. |
| `referenceId` | Allowed characters: alphabets, numerals, dots, hyphens, parentheses, colons, and underscores. Maximum length: 256 characters. |
| `DateObject` | Allowed format: `yyyy-MM-dd HH:mm:ss`. Example: `2023-10-19 18:30:00`. |

## PSP Errors

These error messages describe failed payment attempts originating from the customer, bank, acquirer, or payment service provider (PSP).

| Tx Status Code | Description |
| :- | :- |
| `USER_DROP_PAYMENT_REQUEST` | User dropped off before making the payment. |
| `REQUEST_TIME_OUT` | No action was taken on the collect payment request. |
| `USER_DECLINED_PAYMENT_REQUEST` | Collect request declined by the requestee. |
| `ACCOUNT_INSUFFICIENT_FUNDS` | Insufficient funds in the customer's (remitter's) account - Z9. |
| `UPI_COLLECT_EXPIRED` | UPI collect request expired - U69. |
| `TRANSACTION_NOT_PERMITTED_AC` | Transaction not permitted for this account type (OD) - SA. |
| `TRANSACTION_FREQUENCY_LIMIT_EXCEEDED` | Transaction frequency limit exceeded as set by the remitting member - Z7. |
| `PG_API_ERROR` | PSP API call error. |
| `INTERNAL_SERVER_ERROR` | PSP internal server error. |
| `WRONG_PIN_ATTEMP_EXCEEDED` | The customer entered the wrong PIN and exceeded the allowed number of attempts - Z6. |
| `INVALID_MPIN` | The customer entered an invalid MPIN - ZM. |
| `USER_ACCOUNT_BLOCKED` | Customer account is blocked or frozen - YE. |
| `USER_ACOUNT_NOT_EXIST` | Customer account does not exist - XH. |
| `USER_ACCOUNT_REGISTER_NUMBER_CHANGE` | The registered mobile number linked to the account has been changed or removed - B1. |
| `USER_DEBIT_LIMIT_EXCEEDED` | The net debit limit has been exceeded - U03. |
| `TRANSACTION_NOT_PERMITTED_AC_LEGAL` | Transaction not permitted for the account, for example, a minor account, proprietor account, an account subject to legal restrictions, or an NRE account - B3. |
| `FAILED_REASON_NOT_DEFINED` | Failure reason is not defined. |
| `REMITTER_BANK_DEEMED_HIGH` | Remitter bank declined the transaction due to a high response-time check - U90. |
| `REMITTER_SUSPECTED_FRAUD_HIGH_RISK` | Transaction declined by the remitter due to suspected fraud or a high-risk score - K1. |
| `TXN_NOT_PERMITTED_CARD_REMITTER` | Transaction not permitted for the cardholder (remitter) - XP. |
| `BANK_HAS_PSP_UNAVAILABLE_ISSUE` | The bank is experiencing a PSP availability issue. |
| `USER_BANK_DEBIT_LIMIT_EXCEEDED` | Limit exceeded for the remitting or issuing bank. |
| `PSP_TXN_NOT_FOUND` | Transaction not found on the PSP side. |
| `USER_BANK_BALANCE_BLOCKED` | Sufficient funds are not available because funds have been blocked in the account. |
| `USER_PSP_OFFLINE` | User PSP is offline. |
| `USER_VPA_NOT_TRANSACTION` | User VPA is not transacting. |
| `PSP_RISK_DETECTED` | PSP risk detected. |
| `USER_INVALID_VPA` | VPA is invalid. |
| `PSP_BLOCKED_USER_DETECTED` | User blocked by PSP. |
| `PSP_COMPLIANCE_ISSUE` | PSP compliance issue detected. |
| `PSP_TIME_OUT` | Remitter or issuer timeout. |
| `UPI_EXPIRED_PAY_REQUEST` | User payment request has expired. |
| `DEVICE_FINGER_PRINT_ISSUE` | Device fingerprint issue. |
| `MANDATE_AUTH_EXPIRED` | Mandate authorization link expired - UM. |
| `FREEZE_PERIOD_FOR_FIRST_TIME_USER` | Freeze period for a first-time user. |
| `RESPAUTHMANDATE_EXPIRED` | Response authorization mandate expired - UM3. |
| `NATURE_OF_DEBIT_NOT_ALLOWED_IN_ACCOUNT_TYPE` | Nature of the debit is not allowed for this account type. |
| `ENCRYPTION_ERROR` | Encryption error - U14. |
| `UTR_ALREADY_PRESENT` | Unique transaction reference already exists. |
| `TRANSACTION_ABORTED_BY_USER` | Transaction aborted by the user. |
| `AUTHENTICATION_FAILED` | Authentication failed. |
| `PAYMENT_ERROR` | Payment failed. |
| `PG_ERROR` | Payment gateway error. |
| `DEBIT_HAS_BEEN_FAILED` | Debit has failed. |
| `PSP_NOT_SUPPORTED_BY_UPI` | PSP is not supported by UPI. |
| `TRANSACTION_INVALID` | Invalid transaction. |
| `TRANSACTION_IN_PROGRESS` | The transaction is in progress. |
| `BANK_TECHNICAL_FAILURE` | Bank technical error. |
| `PAYMENT_INSTRUMENT_INACTIVE` | Customer's payment instrument is inactive. |
| `GATEWAY_ERROR` | Gateway infrastructure error detected. |
| `INVALID_AMOUNT` | Transaction amount must be greater than or equal to 1 rupee. |
| `INVALID_CARD_DETAILS` | Invalid card details. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.