Errors And Status Code - TransactBridge Developer Kit

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.