Available in🇮🇳 India
Every UPI failure your integration can receive on the Collect, Intent and QR flows. These errors appear in the error object of the payment.failed webhook and the Fetch Payment API response. The last column tells you whether you can reproduce the failure in Test Mode, and with which amount.
68 unique source, step and reason combinations are listed. 24 of them are reproducible in Test Mode today.
Match on reason, not on the code
error.code is a broad class, so many reasons share one code. Use error.reason to decide what to do, and error.code only to decide how loudly to log.| # | error.code | reason | source | step | Description | Test Mode |
|---|---|---|---|---|---|---|
| 1 | GATEWAY_ERROR | insufficient_funds | customer | payment_debit_request | Transaction failed due to insufficient funds. | Yes, amount 201 |
| 2 | GATEWAY_ERROR | payment_declined | issuer_bank | payment_debit_request | Payment failed. Please try again with another bank account. | Yes, amount 402 |
| 3 | BAD_REQUEST_ERROR | incorrect_pin | customer | payment_authentication | You have entered an incorrect PIN on the UPI app. Please retry with the correct PIN. | Yes, amount 204 |
| 4 | BAD_REQUEST_ERROR | payment_cancelled | customer | payment_authentication | You may have cancelled the payment or there was a delay in response from the UPI app. | Yes, amount 302 |
| 5 | GATEWAY_ERROR | gateway_technical_error | gateway | payment_response | Payment processing failed due to error at bank or wallet gateway | Yes, amount 103 |
| 6 | GATEWAY_ERROR | payment_risk_check_failed | issuer_bank | payment_debit_response | Payment was unsuccessful as your account does not pass the risk checks done by your bank. Try using another account. | Yes, amount 404 |
| 7 | BAD_REQUEST_ERROR | bank_account_invalid | customer | payment_debit_request | Payment was unsuccessful as your bank account linked to this UPI ID is invalid. Try using another account. | Yes, amount 203 |
| 8 | GATEWAY_ERROR | upi_app_not_available | customer_psp | payment_request | Payment was unsuccessful as the UPI app is not reachable at this time. | Yes, amount 107 |
| 9 | BAD_REQUEST_ERROR | pin_attempts_exceeded | customer | payment_authentication | Payment was unsuccessful as you have breached the limit to enter UPI PIN incorrectly. Try using another method. | Yes, amount 206 |
| 10 | GATEWAY_ERROR | bank_technical_error | issuer_bank | payment_debit_response | Payment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days. | Yes, amount 104 |
| 11 | BAD_REQUEST_ERROR | debit_instrument_blocked | issuer_bank | payment_debit_request | Payment was unsuccessful as the account linked to this UPI ID is blocked. Try using another account. | Yes, amount 212 |
| 12 | BAD_REQUEST_ERROR | transaction_limit_exceeded | customer | payment_debit_response | Payment was unsuccessful as you exceeded the amount limit for the day with this bank account. Try using another account. | Yes, amount 208 |
| 13 | GATEWAY_ERROR | bank_technical_error | issuer_bank | payment_debit_request | Payment was unsuccessful as the bank linked to this UPI ID is temporarily unavailable. Any amount deducted will be refunded within 5-7 working days. | Yes, amount 102 |
| 14 | BAD_REQUEST_ERROR | transaction_frequency_limit_exceeded | business | payment_initiation | Payment was unsuccessful as your UPI app is not supported. Try using another method. | Yes, amount 210 |
| 15 | BAD_REQUEST_ERROR | mobile_number_invalid | customer | payment_request | Payment was unsuccessful as the phone number linked to this UPI ID is changed/removed. Try using another method. | Yes, amount 202 |
| 16 | BAD_REQUEST_ERROR | pin_not_set | customer | payment_authentication | Payment was unsuccessful as you have not set the UPI PIN on the app. Try using another method. | Yes, amount 205 |
| 17 | BAD_REQUEST_ERROR | invalid_device | customer | payment_authentication | Payment was unsuccessful as you may not be registered on the app you’re trying to pay with. Try using another method. | Yes, amount 407 |
| 18 | GATEWAY_ERROR | payment_timed_out | network | payment_authentication | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | Yes, amount 105 |
| 19 | GATEWAY_ERROR | vpa_resolution_failed | network | payment_request | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. | Yes, amount 401 |
| 20 | GATEWAY_ERROR | beneficiary_account_does_not_exist | gateway | payment_credit_request | Payment was unsuccessful as the receiver’s bank account is inactive. Any amount deducted will be refunded within 5-7 working days. | Yes, amount 213 |
| 21 | GATEWAY_ERROR | bank_technical_error | beneficiary_bank | payment_credit_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | Yes, amount 106 |
| 22 | BAD_REQUEST_ERROR | duplicate_request | gateway | payment_request | Payment was unsuccessful due to a temporary issue. If amount got deducted, it will be refunded within 5-7 working days. | Yes, amount 406 |
| 23 | BAD_REQUEST_ERROR | payment_declined | customer | payment_authentication | You have declined the payment request on the UPI app. Please retry when you are ready. | Yes, amount 304 |
| 24 | BAD_REQUEST_ERROR | payment_collect_request_expired | customer | payment_authentication | Payment was unsuccessful as you could not pay with the UPI app within time. | Yes, amount 301 |
| 25 | BAD_REQUEST_ERROR | payment_timed_out | customer | payment_authentication | Payment was unsuccessful as you could not complete it in time. | No |
| 26 | BAD_REQUEST_ERROR | invalid_vpa | customer | payment_request | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. | No |
| 27 | GATEWAY_ERROR | issuer_technical_error | issuer_bank | payment_debit_response | Payment was unsuccessful as it was declined by your bank. Any amount deducted will be refunded within 5-7 working days. | No |
| 28 | GATEWAY_ERROR | payment_failed | gateway | payment_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 29 | GATEWAY_ERROR | credit_failed | beneficiary_bank | payment_credit_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 30 | GATEWAY_ERROR | — | gateway | payment_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 31 | GATEWAY_ERROR | gateway_technical_error | gateway | payment_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 32 | GATEWAY_ERROR | payment_timed_out | gateway | payment_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 33 | GATEWAY_ERROR | compliance_violation | issuer_bank | payment_debit_response | Payment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account. | No |
| 34 | GATEWAY_ERROR | credit_not_permitted | beneficiary_bank | payment_credit_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 35 | GATEWAY_ERROR | payment_timed_out | gateway | payment_authorization | Payment was unsuccessful as the bank linked to this UPI ID is not reachable at this time. | No |
| 36 | GATEWAY_ERROR | bank_cutoff_in_progress | issuer_bank | payment_debit_request | Payment was unsuccessful due to a temporary halt of services at this bank. Try using another method. | No |
| 37 | BAD_REQUEST_ERROR | transaction_on_vpa_restricted | customer_psp | payment_authentication | Payment was unsuccessful as it was declined by your UPI app. Try using another method. | No |
| 38 | GATEWAY_ERROR | — | gateway | refund_request | Refund was not created successfully due to a temporary issue. Please retry in some time. | No |
| 39 | BAD_REQUEST_ERROR | invalid_vpa | customer | payment_initiation | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. | No |
| 40 | GATEWAY_ERROR | payment_timed_out | issuer_bank | payment_debit_response | Payment was unsuccessful as the bank linked to this UPI ID is temporarily unavailable. Any amount deducted will be refunded within 5-7 working days. | No |
| 41 | GATEWAY_ERROR | payment_declined | issuer_bank | payment_debit_response | Payment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account. | No |
| 42 | GATEWAY_ERROR | mismatch_in_transaction_details | gateway | payment_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 43 | GATEWAY_ERROR | bank_technical_error | beneficiary_bank | payment_response | Payment processing failed due to error at bank or wallet gateway | No |
| 44 | SERVER_ERROR | server_error | internal | payment_initiation | We are facing some trouble completing your request at the moment. Please try again shortly. | No |
| 45 | GATEWAY_ERROR | — | internal | payment_request | Payment was unsuccessful due to a temporary issue. If money got deducted, reach out to the seller. | No |
| 46 | GATEWAY_ERROR | bank_not_available | issuer_bank | payment_debit_request | Payment was unsuccessful as the bank linked to this UPI ID is temporarily not available. Try using another method. | No |
| 47 | SERVER_ERROR | — | internal | payment_initiation | We are facing some trouble completing your request at the moment. Please try again shortly. | No |
| 48 | GATEWAY_ERROR | bank_technical_error | beneficiary_bank | payment_debit_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 49 | BAD_REQUEST_ERROR | merchant_not_activated | gateway | payment_credit_request | Payment was unsuccessful as this business does not accept UPI payments currently. Try using another method. | No |
| 50 | GATEWAY_ERROR | gateway_technical_error | gateway | payment_status_request | Payment processing failed due to error at bank or wallet gateway | No |
| 51 | GATEWAY_ERROR | invalid_response_from_gateway | gateway | payment_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 52 | BAD_REQUEST_ERROR | input_validation_failed | business | payment_initiation | Payment was unsuccessful as the details are invalid. Please retry with the right details. | No |
| 53 | GATEWAY_ERROR | payment_declined_due_to_high_traffic | issuer_bank | payment_debit_response | Payment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days. | No |
| 54 | GATEWAY_ERROR | duplicate_rrn_found | issuer_bank | payment_request | Payment was unsuccessful due to a temporary issue. Please retry in some time. | No |
| 55 | BAD_REQUEST_ERROR | insufficient_funds | customer | payment_debit_response | Payment was unsuccessful as there was an insufficient amount in the account linked to this UPI ID. Try using another account. | No |
| 56 | GATEWAY_ERROR | bank_technical_error | beneficiary_bank | payment_credit_response | Beneficiary credentials are invalid | No |
| 57 | GATEWAY_ERROR | transaction_not_allowed | gateway | payment_credit_request | Payment was unsuccessful as it got declined by the receiver’s bank. Any amount deducted will be refunded within 5-7 working days. | No |
| 58 | BAD_REQUEST_ERROR | invalid_vpa | customer | payment_authentication | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. | No |
| 59 | GATEWAY_ERROR | — | gateway | payment_credit_request | Payment was unsuccessful due to some issue at the bank. Any amount deducted will be refunded within 5-7 working days. | No |
| 60 | GATEWAY_ERROR | duplicate_rrn_found | beneficiary_bank | payment_response | Payment was unsuccessful due to a temporary issue. Please retry in some time | No |
| 61 | GATEWAY_ERROR | request_timed_out | beneficiary_bank | payment_credit_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 62 | GATEWAY_ERROR | payment_risk_check_failed | beneficiary_bank | payment_credit_response | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 63 | BAD_REQUEST_ERROR | payment_declined | customer | payment_debit_request | Payment was unsuccessful as your bank does not allow UPI payments from a multi-customer account. Try using another method. | No |
| 64 | GATEWAY_ERROR | payment_pending | gateway | payment_status_request | The status of your payment is pending. You can either wait or retry to pay successfully. | No |
| 65 | GATEWAY_ERROR | invalid_request | gateway | payment_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. | No |
| 66 | SERVER_ERROR | server_error | internal | — | We are facing some trouble completing your request at the moment. Please try again shortly. | No |
| 67 | GATEWAY_ERROR | authorisation_declined_by_psp | gateway | payment_authorization | Payment was unsuccessful as collect request was rejected on UPI app.Please initiate the request again | No |
| 68 | GATEWAY_ERROR | psp_not_available | customer_psp | payment_authentication | Payment was unsuccessful as the UPI app is not reachable at this time. Any amount deducted will be refunded within 5-7 working days. | No |