Errors Code
When integrating with PhonePe’s APIs, it’s important to handle both successful and failed responses gracefully. A successful request returns an HTTP status code 200 along with the appropriate response payload. In case of failure, PhonePe provides a structured JSON response containing specific error parameters to help you identify and resolve the issue.
Handling these responses ensures your system can accurately track payment events, offer timely feedback to customers, and recover from errors without disruption. Below is a list of common error codes you may encounter, along with their meanings and recommended actions.
| Error Code | Description | Recommended Action |
| 400 | Bad Request | Verify request parameters and JSON/body format. |
| 401 | Unauthorized Access | Check API keys or authentication tokens. |
| 404 | Resource Not Found | Ensure the endpoint or resource is correct. |
| 500 | Internal Server Error | Retry after a delay; contact support if issue persists. |
📘 When Is errorContext Returned in the Response?
The errorContext field will be included in the status response only if errorContext is explicitly set to True in the request.
Refer: Order Status API Documentation for details on request parameters and sample responses.
| Detailed Error Code | Error Code | Stage | Source | Error Description |
| TXN_AUTO_FAILED | TXN_NOT_COMPLETED | PRE_AUTHENTICATION | CUSTOMER | Payment couldn’t be completed due to issues related to customer or their bank. |
| Z9 | INSUFFICIENT_BALANCE | AUTHORIZATION | CUSTOMER | Payment failed due to insufficient balance in customer’s account. |
| ZM | INVALID_MPIN | AUTHENTICATION | CUSTOMER | Customer entered the wrong UPI PIN. |
| U90 | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Bank is taking longer than usual to process this payment. |
| UT | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| U28 | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| Z7 | TXN_FREQ_LIMIT_BREACHED | AUTHORIZATION | CUSTOMER | Customer exceeded their daily payment limit. |
| Z6 | MPIN_LIMIT_BREACHED | AUTHENTICATION | CUSTOMER | Customer entered wrong PIN too many times. |
| B3 | ACCOUNT_NOT_ELIGIBLE | AUTHORIZATION | CUSTOMER | Customer’s account type is not supported for this payment. |
| Z8 | TXN_LIMIT_BREACHED | AUTHORIZATION | CUSTOMER | Customer exceeded their daily payment limit. |
| XB | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| U03 | TXN_LIMIT_BREACHED | AUTHORIZATION | CUSTOMER | Customer exceeded the per-transaction limit. |
| XY | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| K1 | TXN_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank declined the payment for security reasons. |
| S96 | BANK_TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| YE | ACCOUNT_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank account is blocked or frozen. |
| XH | ACCOUNT_DOES_NOT_EXIST | AUTHORIZATION | CUSTOMER | Customer’s bank account is invalid or unregistered. |
| XT | BANK_NOT_ABLE_TO_PROCESS | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| IR | BANK_NOT_ABLE_TO_PROCESS | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| XP | TXN_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank blocked the payment. |
| NO | REQUEST_NOT_FOUND | AUTHORIZATION | BUSINESS | Original payment request not found. |
| T14 | INVALID_REQUEST | AUTHORIZATION | BUSINESS | You provided invalid payment details. Please check and try again. |
| ZU | TXN_LIMIT_BREACHED | AUTHORIZATION | ISSUING_BANK | Amount exceeds the limit set by the customer’s bank. |
| IE | INSUFFICIENT_BALANCE | AUTHORIZATION | CUSTOMER | Insufficient balance in customer’s account. |
| XV | TXN_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank blocked the payment. |
| U66 | DEVICE_FINGERPRINT_MISMATCH | AUTHENTICATION | BUSINESS | Temporary technical issue. |
| AM | MPIN_NOT_SET | AUTHORIZATION | CUSTOMER | Customer hasn’t set a UPI PIN . |
| B1 | TXN_NOT_ALLOWED | AUTHORIZATION | CUSTOMER | Customer’s number registered with the bank is different. |
| XQ | TXN_BLOCKED | AUTHORIZATION | BENEFICIARY_BANK | Your bank blocked the payment. Contact your bank for help. |
| YC | TXN_NOT_ALLOWED | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| ZX | ACCOUNT_INACTIVE | AUTHORIZATION | CUSTOMER | Customer’s bank account is inactive. |
| FP | TXN_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank account is frozen. |
| U80 | TECHNICAL_ISSUE | AUTHORIZATION | PAYER_PSP | Technical issue at the customer’s bank. |
| U54 | TXN_NOT_ALLOWED | AUTHORIZATION | BUSINESS | Transaction ID or amount mismatch. |
| SA | TXN_NOT_ALLOWED | AUTHORIZATION | ISSUING_BANK | Customer’s bank blocked the payment. |
| SD | ACCOUNT_INACTIVE | AUTHORIZATION | CUSTOMER | Customer’s bank account is inactive. |
| U86 | TECHNICAL_ISSUE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| ZG | TXN_NOT_ALLOWED | AUTHORIZATION | CUSTOMER | Customer’s UPI ID is restricted for this payment. |
| U69 | TXN_NOT_COMPLETED | PRE_AUTHENTICATION | CUSTOMER | Payment request expired. |
| ZA | TXN_CANCELLED | PRE_AUTHENTICATION | CUSTOMER | Customer cancelled the payment. |
| ZH | INVALID_VPA | AUTHORIZATION | CUSTOMER | Customer entered an invalid UPI ID. |
| U16_NPCI_TXNRISK_00924 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_0 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00976 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01026 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01002 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00970 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00966 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01022 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00965 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01242 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00901 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01232 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01054 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01028 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00030 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01018 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01206 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00941 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01083 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00963 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00987 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_00980 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| U16_NPCI_TXNRISK_01078 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| REQUEST_TIME_OUT | TXN_NOT_COMPLETED | PRE_AUTHENTICATION | CUSTOMER | Payment request timed-out. |
| REQUEST_CANCEL_BY_REQUESTER | TXN_CANCELLED | PRE_AUTHENTICATION | BUSINESS | You cancelled the payment request. Please send a new request to the customer. |
| REQUEST_DECLINE_BY_REQUESTEE | TXN_CANCELLED | PRE_AUTHENTICATION | CUSTOMER | Customer cancelled the payment. |
| TXN_NOT_FOUND | TXN_NOT_FOUND | PRE_AUTHENTICATION | BUSINESS | Payment failed due to temporary technical issue. |
| INTERNAL_SECURITY_BLOCK | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| INTERNAL_SECURITY_BLOCK_1 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as the payment URL doesn’t match the one you shared during onboarding. |
| INTERNAL_SECURITY_BLOCK_2 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as the IP address doesn’t match the one you shared during onboarding. |
| INTERNAL_SECURITY_BLOCK_4 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as the package name doesn’t match the one you shared during onboarding. |
| INTERNAL_SECURITY_BLOCK_5 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as the business policies are missing or outdated on your website/app. |
| INTERNAL_SECURITY_BLOCK_6 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as you have not completed your video KYC verification. |
| BF_110 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| BF_025 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| BF_028 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| BF_049 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| BL_076 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| BL_077 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked as you have not completed your video KYC verification. |
| ORDER_EXPIRED | TXN_NOT_COMPLETED | PRE_AUTHENTICATION | CUSTOMER | Customer did not complete the payment. |
| ORDER_CANCELLED_BY_USER | TXN_CANCELLED | PRE_AUTHENTICATION | CUSTOMER | Customer cancelled the payment. |
| AUTHENTICATION_FAILED | AUTHENTICATION_FAILED | AUTHENTICATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| INVALID_CARD_NUMBER | INVALID_CARD_NUMBER | PRE_AUTHENTICATION | Customer | Customer didn’t enter the card details or entered incorrect ones. |
| BANK_ERROR | BANK_ERROR | UNKNOWN | ISSUING_BANK | Technical issue at the customer’s bank. |
| TRANSACTION_DECLINED | TRANSACTION_DECLINED | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| TECHNICAL_ISSUE_BANK | TECHNICAL_ISSUE_BANK | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| INVALID_DETAILS | INVALID_DETAILS | AUTHENTICATION | PAYMENT_GATEWAY | Customer entered invalid details. |
| BANK_MERCHANT_CONFIG | BANK_MERCHANT_CONFIG | AUTHENTICATION | PAYMENT_GATEWAY | Temporary technical issue. |
| CONNECTION_TIMEOUT | CONNECTION_TIMEOUT | UNKNOWN | UNKNOWN | Payment request timed out. |
| ADDRESS_MISMATCH | ADDRESS_MISMATCH | AUTHENTICATION | Customer | Address provided for the order doesn’t match the customer’s bank records. |
| TRANSACTION_DECLINED_PG | TRANSACTION_DECLINED_PG | AUTHORIZATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| BUSINESS_RISK_RULES | BUSINESS_RISK_RULES | AUTHORIZATION | ISSUING_BANK | Customer’s bank doesn’t allow payments with this card. |
| CARD_BLOCKED | CARD_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s card is blocked by their bank. |
| CARD_EXPIRED | CARD_EXPIRED | AUTHORIZATION | Customer | Customer’s card is expired. |
| INVALID_CVV_EXPIRY | INVALID_CVV_EXPIRY | AUTHENTICATION | Customer | Customer entered an invalid CVV. |
| INVALID_DETAILS_MERCHANT | INVALID_DETAILS_MERCHANT | AUTHENTICATION | BUSINESS | You have entered invalid details. Please check and send the request to the customer again. |
| PROCESSOR_ERROR | PROCESSOR_ERROR | AUTHORIZATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| INVALID_CARD_TYPE | INVALID_CARD_TYPE | AUTHENTICATION | ISSUING_BANK | Customer’s card is not supported for this payment. |
| INVALID_FIELDS | INVALID_FIELDS | AUTHENTICATION | Customer | Customer didn’t provide all the details for this payment. |
| INSUFFICIENT_BALANCE | INSUFFICIENT_BALANCE | AUTHORIZATION | Customer | Insufficient balance in customer’s account. |
| TRANSACTION_TIME_OUT | TRANSACTION_TIME_OUT | AUTHENTICATION | PAYMENT_GATEWAY | Payment request timed out. |
| CANCELLED_BY_USER | CANCELLED_BY_USER | AUTHENTICATION | Customer | Customer didn’t complete the authentication process in time. |
| DUPLICATE_TRANSACTION | DUPLICATE_TRANSACTION | AUTHENTICATION | PAYMENT_GATEWAY | A payment with the same Order ID is already in progress. |
| HASH_MISMATCH | HASH_MISMATCH | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| TXN_AMOUNT_MISMATCH | TXN_AMOUNT_MISMATCH | AUTHORIZATION | ISSUING_BANK | Product amount is different from the the amount recorded by the bank. |
| INVALID_TXN_ID | INVALID_TXN_ID | UNKNOWN | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| ONLINE_TRANSACTIONS_DISABLED | ONLINE_TRANSACTIONS_DISABLED | AUTHORIZATION | Customer | Customer cannot use this card for online payments. |
| MAX_AUTH_EXCEEDED | MAX_AUTH_EXCEEDED | AUTHENTICATION | Customer | Customer has exceeded the maximum PIN attempts. |
| INVALID_CARD_NAME | INVALID_CARD_NAME | AUTHENTICATION | Customer | Customer entered an invalid card name. |
| WRONG_PIN | WRONG_PIN | AUTHENTICATION | Customer | Customer didn’t enter the OTP or entered an incorrect one. |
| INVALID_AMOUNT | INVALID_AMOUNT | AUTHORIZATION | Customer | Customer entered the wrong amount. |
| INVALID_CARD | INVALID_CARD | AUTHENTICATION | Customer | Customer entered an incorrect account number. |
| TRANSACTION_LIMIT_EXCEEDED | TRANSACTION_LIMIT_EXCEEDED | AUTHORIZATION | Customer | Customer exceeded their transaction limit. |
| MERCHANT_ERROR | MERCHANT_ERROR | AUTHORIZATION | BUSINESS | Technical issue at your end. |
| INTERNATIONAL_TXN_NOT_ALLOWED | INTERNATIONAL_TXN_NOT_ALLOWED | AUTHORIZATION | Customer | Customer’s card does not support international payments. |
| UNSUPPORTED_PAYMENT_MODE | UNSUPPORTED_PAYMENT_MODE | AUTHORIZATION | ISSUING_BANK | Customer’s bank doesn’t allow payments with this instrument. |
| AUTHORIZATION_FAILED | AUTHORIZATION_FAILED | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| AUTH_TIMEOUT | AUTH_TIMEOUT | AUTHENTICATION | Customer | Customer didn’t complete authentication process in time. |
| CARD_BIN_NOT_SUPPORTED | CARD_BIN_NOT_SUPPORTED | AUTHORIZATION | ISSUING_BANK | Customer’s card is not supported for this payment. |
| TXN_FAILED | TXN_FAILED | AUTHENTICATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| MERCHANT_CONFIG_NOT_FOUND | MERCHANT_CONFIG_NOT_FOUND | AUTHENTICATION | PAYMENT_GATEWAY | Merchant validation failed as your configuration details are missing or incorrect at PhonePe PG. |
| PENDING | PENDING | AUTHORIZATION | ISSUING_BANK | Payment is being processed. Please check after 15 minutes. |
| INVALID_REQUEST | INVALID_REQUEST | AUTHENTICATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| GENERIC_NPCI_ERROR | GENERIC_NPCI_ERROR | AUTHORIZATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| GENERIC_ERROR | GENERIC_ERROR | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_CURRENCY | INVALID_CURRENCY | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_TXN | INVALID_TXN | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_DATE | INVALID_DATE | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| ENCRYPTION_ERROR | ENCRYPTION_ERROR | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| DECRYPTION_ERROR | DECRYPTION_ERROR | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_BANK_CODE | INVALID_BANK_CODE | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| CHECKSUM_MISMATCH | CHECKSUM_MISMATCH | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_KEY | INVALID_KEY | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_PARAMETERS | INVALID_PARAMETERS | UNKNOWN | UNKNOWN | You passed invalid parameters. Please verify the details and try again. |
| INVALID_CARD_DETAILS | INVALID_CARD_DETAILS | AUTHENTICATION | Customer | Customer entered incorrect card details. |
| INVALID_CUSTOMER_ID | INVALID_CUSTOMER_ID | UNKNOWN | UNKNOWN | Payment failed due to invalid customer ID. |
| INCORRECT_DETAILS | INCORRECT_DETAILS | AUTHORIZATION | Customer | Customer entered incorrect card details. |
| MERCHANT_CONFIG_ERROR | MERCHANT_CONFIG_ERROR | AUTHENTICATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| CARD_NOT_ALLOWED | CARD_NOT_ALLOWED | AUTHENTICATION | Customer | Customer cannot make the payment using this card. |
| REFUND_SUBMITTED | REFUND_SUBMITTED | REFUND | ISSUING_BANK | Your refund request has been submitted successfully. |
| INVALID_REFUND_REQUEST_FIELDS | INVALID_REFUND_REQUEST_FIELDS | REFUND | BUSINESS | You entered an invalid merchant code or incorrect amount. Please verify the details and try again. |
| TXN_AMOUNT_MISMATCH_REFUND | TXN_AMOUNT_MISMATCH_REFUND | REFUND | BUSINESS | The refund amount does not match the original payment amount. Please check and try again. |
| REFUND_NOT_ALLOWED | REFUND_NOT_ALLOWED | REFUND | BUSINESS | You cannot process this refund. |
| REFUND_FOR_TXN_OLDER_THAN_LIMIT | REFUND_FOR_TXN_OLDER_THAN_LIMIT | REFUND | BUSINESS | Refund failed as the payment was made over 90 days ago. Only payments within the last 90 days are refundable. |
| EXCESS_REFUND_AMOUNT | EXCESS_REFUND_AMOUNT | REFUND | BUSINESS | You have insufficient balance to process the refund. Please check and try again. |
| CHECKSUM_GENERATION_FAILED | CHECKSUM_GENERATION_FAILED | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| MISSING_FIELDS | MISSING_FIELDS | UNKNOWN | UNKNOWN | A required field is missing. Please fill in all mandatory parameters and try again. |
| INVALID_CHECKSUM_PARAMETERS | INVALID_CHECKSUM_PARAMETERS | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| MESSAGE_FORMAT_ERROR | MESSAGE_FORMAT_ERROR | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_CHECKSUM_KEY | INVALID_CHECKSUM_KEY | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| INVALID_MERCHANT_CODE | INVALID_MERCHANT_CODE | UNKNOWN | UNKNOWN | You have not passed a valid merchant code. Please check and try again. |
| INVALID_CUSTOMER_RELATED_FIELDS | INVALID_CUSTOMER_RELATED_FIELDS | UNKNOWN | UNKNOWN | Customer details like name, email, or address are missing. |
| MISSING_CHECKSUM_VALUE | MISSING_CHECKSUM_VALUE | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| CAPTURE_ERROR | CAPTURE_ERROR | CAPTURE | BUSINESS | Payment failed due to temporary technical issue. |
| DECLINED_BY_ACQUIRER | DECLINED_BY_ACQUIRER | AUTHORIZATION | PAYMENT_GATEWAY | Your bank has declined this payment. Please contact your bank for more details. |
| TXN_NOT_ALLOWED | TXN_NOT_ALLOWED | UNKNOWN | UNKNOWN | Payment not allowed. |
| TXN_DATA_TAMPERED | TXN_DATA_TAMPERED | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| DUPLICATE_TXN_REQUEST | DUPLICATE_TXN_REQUEST | UNKNOWN | ISSUING_BANK | A transaction with the same details has already been processed. |
| TXN_ALREADY_PROCESSED | TXN_ALREADY_PROCESSED | AUTHORIZATION | ISSUING_BANK | A transaction with the same details has already been processed. |
| INVALID_ACCOUNT_NUMBER | INVALID_ACCOUNT_NUMBER | AUTHENTICATION | BUSINESS | You have passed an invalid account number. Please check and try again. |
| UNSUPPORTED_BY_MERCHANT | UNSUPPORTED_BY_MERCHANT | UNKNOWN | BUSINESS | Payment failed as you do not support this payment type. |
| TXN_NOT_FOUND | TXN_NOT_FOUND | AUTHORIZATION | BUSINESS | Payment not found. |
| SUCCESS | SUCCESS | UNKNOWN | UNKNOWN | This payment is successful. |
| TXN_STATUS_AWAITED | TXN_STATUS_AWAITED | UNKNOWN | UNKNOWN | Payment is being processed. Please check after 15 minutes. |
| WITHDRAWAL_LIMIT_EXCEEDED | WITHDRAWAL_LIMIT_EXCEEDED | AUTHORIZATION | Customer | Customer’s bank declined the payment as they exceeded the withdrawal limit. |
| CARD_VALIDATION_FAILURE | CARD_VALIDATION_FAILURE | UNKNOWN | UNKNOWN | Payment failed due to temporary technical issue. |
| UNSUPPORTED_TXN_TYPE | UNSUPPORTED_TXN_TYPE | UNKNOWN | ISSUING_BANK | Customer’s bank does not support this payment. |
| ACQUIRER_UNAVAILABLE | ACQUIRER_UNAVAILABLE | UNKNOWN | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| MERCHANT_RESTRICTION | MERCHANT_RESTRICTION | AUTHORIZATION | ISSUING_BANK | Customer cannot make this payment using this card. |
| CARD_NOT_EXIST | CARD_NOT_EXIST | AUTHORIZATION | ISSUING_BANK | The customer’s bank declined the payment as the card number is invalid. |
| CARD_NOT_ACTIVE | CARD_NOT_ACTIVE | AUTHORIZATION | ISSUING_BANK | Customer’s card is inactive. |
| ACCOUNT_NO_LONGER_ACTIVE | ACCOUNT_NO_LONGER_ACTIVE | AUTHENTICATION | Customer | Customer’s bank account is inactive. |
| ORIGINAL_TXN_NOT_FOUND | ORIGINAL_TXN_NOT_FOUND | REFUND | PAYMENT_GATEWAY | Original payment ID was not found. |
| NETWORK_ERROR | NETWORK_ERROR | AUTHENTICATION | NETWORK | Payment failed due to temporary technical issue. |
| MERCHANT_CANCELLED | MERCHANT_CANCELLED | CAPTURE | BUSINESS | Payment failed due to temporary technical issue. |
| PG_TECHNICAL_FAILURE | PG_TECHNICAL_FAILURE | AUTHENTICATION | PAYMENT_GATEWAY | Payment failed due to temporary technical issue. |
| TECHNICAL_ISSUE_NETWORK | TECHNICAL_ISSUE_NETWORK | UNKNOWN | NETWORK | Payment failed due to temporary technical issue. |
| OTP_EXPIRED | OTP_EXPIRED | AUTHENTICATION | Customer | Customer entered an expired OTP. |
| AUTH_PROCESS_FAILED | AUTH_PROCESS_FAILED | AUTHENTICATION | Customer | Customer didn’t complete or failed the card authentication process. |
| SERVER_UNAVAILABLE | SERVER_UNAVAILABLE | AUTHENTICATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| WRONG_MCC | WRONG_MCC | AUTHORIZATION | PAYMENT_GATEWAY | Customer cannot make this payment using a card. |
| CUSTOMER_CARD_BLOCKED | CUSTOMER_CARD_BLOCKED | AUTHORIZATION | ISSUING_BANK | Customer’s bank has blocked this card. |
| PREVIOUS_ORDER_IN_PROGRESS | PREVIOUS_ORDER_IN_PROGRESS | PRE_AUTHENTICATION | PAYMENT_GATEWAY | A payment with the same order ID is already in progress. |
| DUPLICATE_TRANSACTIONS | DUPLICATE_TRANSACTIONS | AUTHORIZATION | ISSUING_BANK | The customer’s bank declined the payment as a duplicate request was received within 15 seconds. |
| NETWORK_TRACE_FAILURE | NETWORK_TRACE_FAILURE | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| UNSUPPORTED_TRANSACTION | UNSUPPORTED_TRANSACTION | AUTHORIZATION | ISSUING_BANK | Customer’s bank does not support this payment. |
| RESTRICTED_USAGE | RESTRICTED_USAGE | AUTHORIZATION | ISSUING_BANK | Customer cannot make this payment using a card. |
| DATA_ERROR | DATA_ERROR | AUTHORIZATION | PAYMENT_GATEWAY | Payment failed due to incorrect network name, CVV, or cryptogram. Please check and try again. |
| AMOUNT_READ_FAILURE | AMOUNT_READ_FAILURE | AUTHORIZATION | ISSUING_BANK | Customer’s bank couldn’t read the transaction amount. |
| PAN_MAPPING_FAILURE | PAN_MAPPING_FAILURE | AUTHORIZATION | NETWORK | Technical issue at the customer’s bank. |
| CARD_DEACTIVATED | CARD_DEACTIVATED | AUTHORIZATION | Customer | Customer’s card is deactivated. |
| OTP_VALIDATION_FAILURE | OTP_VALIDATION_FAILURE | AUTHENTICATION | PAYMENT_GATEWAY | Technical issue at the customer’s bank. |
| TIMED_OUT | TXN_AUTO_FAILED | PRE_AUTHENTICATION | CUSTOMER | Payment couldn’t be completed due to issues related to customer or their bank. |
| U16_NPCI_TXNRISK_01069 | TXN_BLOCKED | AUTHENTICATION | NPCI | Customer’s payment blocked due to security reasons. |
| BL_086 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| ZD | VALIDATION_ERROR | AUTHORIZATION | BUSINESS | Technical issue at the customer’s bank. |
| BL_088 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Payment blocked due to security reasons. |
| NPCI_SERVER_ERROR | SERVER_ERROR | OTHERS | NPCI | Payment failed due to technical issue |
| INSUFFICIENT_FUNDS | INSUFFICIENT_BALANCE | AUTHORIZATION | CUSTOMER | Payment failed due to insufficient balance in customer’s account. |
| PG_ERROR | OTHERS | OTHERS | OTHERS | Transaction could not be processed |
| DECLINED_BY_ISSUER | TXN_BLOCKED | AUTHORIZATION | ISSUING_BANK | Technical issue at the customer’s bank. |
| BF_108 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Transaction has been blocked due to security reasons |
| CR_016 | TXN_BLOCKED | PRE_AUTHENTICATION | PAYMENT_GATEWAY | Transaction has been blocked due to security reasons |