Skip to main content
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 codeerror.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.codereasonsourcestepDescriptionTest Mode
1GATEWAY_ERRORinsufficient_fundscustomerpayment_debit_requestTransaction failed due to insufficient funds.Yes, amount 201
2GATEWAY_ERRORpayment_declinedissuer_bankpayment_debit_requestPayment failed. Please try again with another bank account.Yes, amount 402
3BAD_REQUEST_ERRORincorrect_pincustomerpayment_authenticationYou have entered an incorrect PIN on the UPI app. Please retry with the correct PIN.Yes, amount 204
4BAD_REQUEST_ERRORpayment_cancelledcustomerpayment_authenticationYou may have cancelled the payment or there was a delay in response from the UPI app.Yes, amount 302
5GATEWAY_ERRORgateway_technical_errorgatewaypayment_responsePayment processing failed due to error at bank or wallet gatewayYes, amount 103
6GATEWAY_ERRORpayment_risk_check_failedissuer_bankpayment_debit_responsePayment was unsuccessful as your account does not pass the risk checks done by your bank. Try using another account.Yes, amount 404
7BAD_REQUEST_ERRORbank_account_invalidcustomerpayment_debit_requestPayment was unsuccessful as your bank account linked to this UPI ID is invalid. Try using another account.Yes, amount 203
8GATEWAY_ERRORupi_app_not_availablecustomer_psppayment_requestPayment was unsuccessful as the UPI app is not reachable at this time.Yes, amount 107
9BAD_REQUEST_ERRORpin_attempts_exceededcustomerpayment_authenticationPayment was unsuccessful as you have breached the limit to enter UPI PIN incorrectly. Try using another method.Yes, amount 206
10GATEWAY_ERRORbank_technical_errorissuer_bankpayment_debit_responsePayment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days.Yes, amount 104
11BAD_REQUEST_ERRORdebit_instrument_blockedissuer_bankpayment_debit_requestPayment was unsuccessful as the account linked to this UPI ID is blocked. Try using another account.Yes, amount 212
12BAD_REQUEST_ERRORtransaction_limit_exceededcustomerpayment_debit_responsePayment was unsuccessful as you exceeded the amount limit for the day with this bank account. Try using another account.Yes, amount 208
13GATEWAY_ERRORbank_technical_errorissuer_bankpayment_debit_requestPayment 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
14BAD_REQUEST_ERRORtransaction_frequency_limit_exceededbusinesspayment_initiationPayment was unsuccessful as your UPI app is not supported. Try using another method.Yes, amount 210
15BAD_REQUEST_ERRORmobile_number_invalidcustomerpayment_requestPayment was unsuccessful as the phone number linked to this UPI ID is changed/removed. Try using another method.Yes, amount 202
16BAD_REQUEST_ERRORpin_not_setcustomerpayment_authenticationPayment was unsuccessful as you have not set the UPI PIN on the app. Try using another method.Yes, amount 205
17BAD_REQUEST_ERRORinvalid_devicecustomerpayment_authenticationPayment was unsuccessful as you may not be registered on the app you’re trying to pay with. Try using another method.Yes, amount 407
18GATEWAY_ERRORpayment_timed_outnetworkpayment_authenticationPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.Yes, amount 105
19GATEWAY_ERRORvpa_resolution_failednetworkpayment_requestYou have entered an incorrect UPI ID. Please retry with the correct UPI ID.Yes, amount 401
20GATEWAY_ERRORbeneficiary_account_does_not_existgatewaypayment_credit_requestPayment was unsuccessful as the receiver’s bank account is inactive. Any amount deducted will be refunded within 5-7 working days.Yes, amount 213
21GATEWAY_ERRORbank_technical_errorbeneficiary_bankpayment_credit_requestPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.Yes, amount 106
22BAD_REQUEST_ERRORduplicate_requestgatewaypayment_requestPayment was unsuccessful due to a temporary issue. If amount got deducted, it will be refunded within 5-7 working days.Yes, amount 406
23BAD_REQUEST_ERRORpayment_declinedcustomerpayment_authenticationYou have declined the payment request on the UPI app. Please retry when you are ready.Yes, amount 304
24BAD_REQUEST_ERRORpayment_collect_request_expiredcustomerpayment_authenticationPayment was unsuccessful as you could not pay with the UPI app within time.Yes, amount 301
25BAD_REQUEST_ERRORpayment_timed_outcustomerpayment_authenticationPayment was unsuccessful as you could not complete it in time.No
26BAD_REQUEST_ERRORinvalid_vpacustomerpayment_requestYou have entered an incorrect UPI ID. Please retry with the correct UPI ID.No
27GATEWAY_ERRORissuer_technical_errorissuer_bankpayment_debit_responsePayment was unsuccessful as it was declined by your bank. Any amount deducted will be refunded within 5-7 working days.No
28GATEWAY_ERRORpayment_failedgatewaypayment_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
29GATEWAY_ERRORcredit_failedbeneficiary_bankpayment_credit_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
30GATEWAY_ERROR—gatewaypayment_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
31GATEWAY_ERRORgateway_technical_errorgatewaypayment_requestPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
32GATEWAY_ERRORpayment_timed_outgatewaypayment_requestPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
33GATEWAY_ERRORcompliance_violationissuer_bankpayment_debit_responsePayment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account.No
34GATEWAY_ERRORcredit_not_permittedbeneficiary_bankpayment_credit_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
35GATEWAY_ERRORpayment_timed_outgatewaypayment_authorizationPayment was unsuccessful as the bank linked to this UPI ID is not reachable at this time.No
36GATEWAY_ERRORbank_cutoff_in_progressissuer_bankpayment_debit_requestPayment was unsuccessful due to a temporary halt of services at this bank. Try using another method.No
37BAD_REQUEST_ERRORtransaction_on_vpa_restrictedcustomer_psppayment_authenticationPayment was unsuccessful as it was declined by your UPI app. Try using another method.No
38GATEWAY_ERROR—gatewayrefund_requestRefund was not created successfully due to a temporary issue. Please retry in some time.No
39BAD_REQUEST_ERRORinvalid_vpacustomerpayment_initiationYou have entered an incorrect UPI ID. Please retry with the correct UPI ID.No
40GATEWAY_ERRORpayment_timed_outissuer_bankpayment_debit_responsePayment 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
41GATEWAY_ERRORpayment_declinedissuer_bankpayment_debit_responsePayment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account.No
42GATEWAY_ERRORmismatch_in_transaction_detailsgatewaypayment_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
43GATEWAY_ERRORbank_technical_errorbeneficiary_bankpayment_responsePayment processing failed due to error at bank or wallet gatewayNo
44SERVER_ERRORserver_errorinternalpayment_initiationWe are facing some trouble completing your request at the moment. Please try again shortly.No
45GATEWAY_ERROR—internalpayment_requestPayment was unsuccessful due to a temporary issue. If money got deducted, reach out to the seller.No
46GATEWAY_ERRORbank_not_availableissuer_bankpayment_debit_requestPayment was unsuccessful as the bank linked to this UPI ID is temporarily not available. Try using another method.No
47SERVER_ERROR—internalpayment_initiationWe are facing some trouble completing your request at the moment. Please try again shortly.No
48GATEWAY_ERRORbank_technical_errorbeneficiary_bankpayment_debit_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
49BAD_REQUEST_ERRORmerchant_not_activatedgatewaypayment_credit_requestPayment was unsuccessful as this business does not accept UPI payments currently. Try using another method.No
50GATEWAY_ERRORgateway_technical_errorgatewaypayment_status_requestPayment processing failed due to error at bank or wallet gatewayNo
51GATEWAY_ERRORinvalid_response_from_gatewaygatewaypayment_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
52BAD_REQUEST_ERRORinput_validation_failedbusinesspayment_initiationPayment was unsuccessful as the details are invalid. Please retry with the right details.No
53GATEWAY_ERRORpayment_declined_due_to_high_trafficissuer_bankpayment_debit_responsePayment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days.No
54GATEWAY_ERRORduplicate_rrn_foundissuer_bankpayment_requestPayment was unsuccessful due to a temporary issue. Please retry in some time.No
55BAD_REQUEST_ERRORinsufficient_fundscustomerpayment_debit_responsePayment was unsuccessful as there was an insufficient amount in the account linked to this UPI ID. Try using another account.No
56GATEWAY_ERRORbank_technical_errorbeneficiary_bankpayment_credit_responseBeneficiary credentials are invalidNo
57GATEWAY_ERRORtransaction_not_allowedgatewaypayment_credit_requestPayment was unsuccessful as it got declined by the receiver’s bank. Any amount deducted will be refunded within 5-7 working days.No
58BAD_REQUEST_ERRORinvalid_vpacustomerpayment_authenticationYou have entered an incorrect UPI ID. Please retry with the correct UPI ID.No
59GATEWAY_ERROR—gatewaypayment_credit_requestPayment was unsuccessful due to some issue at the bank. Any amount deducted will be refunded within 5-7 working days.No
60GATEWAY_ERRORduplicate_rrn_foundbeneficiary_bankpayment_responsePayment was unsuccessful due to a temporary issue. Please retry in some timeNo
61GATEWAY_ERRORrequest_timed_outbeneficiary_bankpayment_credit_requestPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
62GATEWAY_ERRORpayment_risk_check_failedbeneficiary_bankpayment_credit_responsePayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
63BAD_REQUEST_ERRORpayment_declinedcustomerpayment_debit_requestPayment was unsuccessful as your bank does not allow UPI payments from a multi-customer account. Try using another method.No
64GATEWAY_ERRORpayment_pendinggatewaypayment_status_requestThe status of your payment is pending. You can either wait or retry to pay successfully.No
65GATEWAY_ERRORinvalid_requestgatewaypayment_requestPayment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days.No
66SERVER_ERRORserver_errorinternal—We are facing some trouble completing your request at the moment. Please try again shortly.No
67GATEWAY_ERRORauthorisation_declined_by_pspgatewaypayment_authorizationPayment was unsuccessful as collect request was rejected on UPI app.Please initiate the request againNo
68GATEWAY_ERRORpsp_not_availablecustomer_psppayment_authenticationPayment was unsuccessful as the UPI app is not reachable at this time. Any amount deducted will be refunded within 5-7 working days.No
Last modified on November 19, 2026