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

# S2S UPI Error Codes

> Error codes, reasons, sources and steps for UPI one-time payment failures on Collect, Intent and QR in server-to-server integrations.

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.

> [!NOTE]
>
> **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 |

### Related Information

* [S2S UPI Intent Flow](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/payment-methods/upi/intent.md)
* [S2S UPI Collect Flow](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/payment-methods/upi/collect.md)
* [UPI Error Codes](https://razorpay.com/docs/errors/payments/payment-methods-error-parameters.md#upi)
