Available in🇮🇳 India
Every error.reason you can receive, per method, and whether you can trigger it in Test Mode. Errors are grouped by error.source. Pick a method tab below. For how to handle these errors in your code, see Error Handling.
- Orders
- Cards
- UPI
- Card recurring
- UPI Autopay
Orders: available in test mode (32)
Your request (business) (32)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
"amount": 99 with "currency": "INR" | BAD_REQUEST_ERROR | business | order_creation | amount_less_than_minimum_amount | Order amount less than minimum amount allowed (HTTP 400) |
A parameter your account doesn’t support, e.g. transfers without Route | BAD_REQUEST_ERROR | business | payment_initiation | extra_field_sent | <field> is/are not required and should not be sent (HTTP 400) |
Reuse a receipt already on your account | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Order receipt should be unique. (HTTP 400) |
"amount": 100.5 | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | The amount must be an integer. (HTTP 400) |
"currency": 1 | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | expected string but provided <value> (HTTP 400) |
Leave out amount | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: is required. (HTTP 400) |
"amount": -100 | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: must be no less than 0. (HTTP 400) |
Leave out currency | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | currency: cannot be blank. (HTTP 400) |
An emoji in notes | BAD_REQUEST_ERROR | business | order_creation | input_validation_failed | The notes field should contain valid UTF-8 encoded characters. (HTTP 400) |
"currency": "IN" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | currency: the length must be exactly 3. (HTTP 400) |
"amount": "100.0" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | The amount must be a valid integer. (HTTP 400) |
"amount": "" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: cannot be blank. (HTTP 400) |
"amount": 99 | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: must be no less than 100. (HTTP 400) |
A 19-character customer_id that doesn’t exist | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | customer_id: The id provided does not exist. (HTTP 400) |
| A body that isn’t valid JSON | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | <JSON parse error> but provided <value> (HTTP 400) |
Leave out amount and currency | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: is required; currency: cannot be blank. (HTTP 400) |
A 57-character receipt | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | receipt: the length must be no more than 56. (HTTP 400) |
| A currency other than your account currency, without international payments enabled | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Order Currency is not supported (HTTP 400) |
"currency": "ABC" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | currency: validation_failure: BAD_REQUEST_INVALID_CURRENCY. (HTTP 400) |
notes larger than 20 KB | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | notes exceeded max size of 20KB (HTTP 400) |
A <script> tag in notes | BAD_REQUEST_ERROR | business | order_creation | input_validation_failed | notes must be valid key‑value pairs of strings (HTTP 400) |
"notes": "text" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Field should be of type list or map. (HTTP 400) |
An emoji in receipt | BAD_REQUEST_ERROR | business | order_creation | input_validation_failed | The receipt: validation_failure: BAD_REQUEST_ENCODING_VALIDATION_FAILED. field should contain valid UTF-8 encoded characters. (HTTP 400) |
A 256-character description | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | description: the length must be no more than 256. (HTTP 400) |
"amount": 0 | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: must be no less than 1. (HTTP 400) |
"partial_payment": "yes" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Boolean field must be either true or false. (HTTP 400) |
"customer_id": "cust_123" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | customer_id: the length must be exactly 19. (HTTP 400) |
A parameter your account doesn’t support, e.g. transfers without Route | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | <field> is/are not required and should not be sent (HTTP 400) |
Leave out currency and send "method": "xyz" | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | currency: cannot be blank; method: must be a valid value. (HTTP 400) |
"amount": -1 and no currency | BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | amount: must be no less than 0; currency: cannot be blank. (HTTP 400) |
An amount above your account’s maximum transaction amount | BAD_REQUEST_ERROR | business | order_creation | invalid_amount | Amount exceeds maximum amount allowed. (HTTP 400) |
"currency": "XYZ" | BAD_REQUEST_ERROR | business | order_creation | invalid_currency | Currency is not supported (HTTP 400) |
Orders: not available in test mode (13)
Your request (business) (2)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Order receipt should be unique. (HTTP 500) |
BAD_REQUEST_ERROR | business | order_creation | merchant_not_activated | Authentication failed (HTTP 401) |
Razorpay internal (8)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
SERVER_ERROR | internal | payment_initiation | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 502) |
SERVER_ERROR | internal | payment_initiation | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 500) |
SERVER_ERROR | internal | NA | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 500) |
SERVER_ERROR | internal | payment_initiation | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 400) |
SERVER_ERROR | internal | NA | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 504) |
SERVER_ERROR | internal | payment_authorization | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 500) |
SERVER_ERROR | internal | payment_validate | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. (HTTP 400) |
BAD_REQUEST_ERROR | internal | order_creation | server_error | DCS Fetch Feature Failure (HTTP 400) |
Razorpay account service (asv_server) (1)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
SERVER_ERROR | asv_server | — | request_failure | unexpected error received from account service (HTTP 500) |
Source not mapped (2)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
SERVER_ERROR | — | — | — | The server encountered an error. The incident has been reported to admins. (HTTP 400) |
| “ | — | — | — | (empty description) (HTTP 500) |
Cards: available in test mode (33)
Customer (19)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0000 0009 + Failure | GATEWAY_ERROR | customer | payment_authentication | authentication_failed | Your payment could not be completed due to incorrect OTP or verification details. Try another payment method or contact your bank for details. |
4100 2800 0007 0051 + Failure | BAD_REQUEST_ERROR | customer | — | card_cvv_invalid | You have entered an incorrect CVV number. Try again. |
4100 2800 0009 0034 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | card_expired | Your payment could not be completed as your card has expired. Try another payment method. |
4100 2800 0004 0013 + Failure | GATEWAY_ERROR | customer | card_enrollment_check | card_not_enrolled | Your payment could not be completed as this card is not enabled for online payments. Try another payment method or contact your bank for details. |
4100 2800 0001 0008 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | card_number_invalid | You’ve entered an incorrect card number. Try again. |
4100 2800 0001 0032 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | debit_instrument_blocked | Your payment could not be completed as your card is blocked. Try another payment method or contact your bank for details. |
4100 2800 0005 0038 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | debit_instrument_inactive | Your payment could not be completed as this card is not enabled for online payments. Try another payment method or contact your bank for details. |
4100 2800 0001 0040 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | incorrect_card_details | You’ve entered incorrect card details. Try again or retry the payment with another card or method. |
4100 2800 0002 0049 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_card_expiry_date | You’ve entered an incorrect expiration date. Try again. |
4100 2800 0000 0033 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | incorrect_cvv | You’ve entered an incorrect CVV number. Try again. |
4100 2800 0002 0031 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_pin | Incorrect PIN entered. Please try again |
4100 2800 0008 0001 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | insufficient_funds | Your payment could not be completed due to insufficient account balance. Try another card or payment method. |
4100 2800 0007 0002 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | payment_cancelled | Your payment has been cancelled. Try again or complete the payment later. |
4100 2800 0003 0048 + Failure | GATEWAY_ERROR | customer | payment_authentication | payment_session_expired | Your payment could not be completed on time. Try again later. |
4100 2800 0009 0000 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | payment_timed_out | Payment was not completed on time. |
4100 2800 0005 0046 + Failure | BAD_REQUEST_ERROR | customer | payment_authentication | pin_attempts_exceeded | You’ve entered an incorrect pin too many times. Try again in sometime. |
4100 2800 0008 0043 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | transaction_daily_count_exceeded | You’ve reached the maximum transaction limit on this card for today. Try another payment method or contact your bank. |
4100 2800 0009 0042 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | transaction_daily_limit_exceeded | Payment failed because card has reached it’s limit |
4100 2800 0008 0035 + Failure | BAD_REQUEST_ERROR | customer | payment_authorization | transaction_limit_exceeded | You’ve reached the maximum transaction limit for this card. Try another payment method or contact your bank. |
Issuing bank (8)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0007 0036 + Failure | GATEWAY_ERROR | issuer_bank | payment_authorization | bank_technical_error | Your payment did not go through due to a temporary technical issue at the bank. Any debited amount will be refunded in 4-5 business days. |
4100 2800 0006 0003 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
4100 2800 0005 0004 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
4100 2800 0004 0005 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_initiation | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
4100 2800 0003 0006 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | card_disabled_for_online_payments | Your card has been disabled for online payments by your issuing bank. Please reach out to your bank or re-try the payment with another card or method. |
4100 2800 0004 0039 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authentication | declined_by_bank | Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank. |
4100 2800 0007 0044 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | issuer_declined | Transaction not supported/blocked by issuer |
4100 2800 0003 0030 + Failure | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | payment_risk_check_failed | Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank. |
Bank (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0006 0045 + Failure | GATEWAY_ERROR | bank | payment_authorization | card_restricted | Payment processing failed due to error at bank or wallet gateway |
Gateway (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0002 0007 + Failure | GATEWAY_ERROR | gateway | payment_authorization | gateway_technical_error | Payment processing failed due to error at bank or wallet gateway |
4100 2800 0006 0037 + Failure | BAD_REQUEST_ERROR | gateway | payment_authorization | payment_failed | Payment failed |
Your request (business) (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0008 0050 + Failure | GATEWAY_ERROR | business | payment_authentication | card_name_invalid | Your payment could not be completed as the card holder name is not of correct format. Enter the card holder name in correct format or try with another card. |
Razorpay internal (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0000 0041 + Failure | GATEWAY_ERROR | internal | payment_initiation | Transaction not permitted to issuer/cardholder | Your payment didn’t go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days |
Source not mapped (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0004 0047 + Failure | BAD_REQUEST_ERROR | — | — | acs_maximum_attempts_reached | Payment was unsuccessful as you exceeded the number of authentication attempts |
Cards: not available in test mode (37)
Your request (business) (1)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR_TECHNICAL_ERROR | business | payment_initiation | token_expired | Gateway Error Technical Error. |
Razorpay internal (3)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | internal | payment_initiation | bin_disabled | Your payment could not be completed as your card is not supported. Try another payment method. |
SERVER_ERROR | internal | payment_creation | internal | The server encountered an error. The incident has been reported to admins. |
SERVER_ERROR | internal | get_token | server_error | Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method. |
Source not mapped (33)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | — | — | amount_mismatch | The amount does not match with payment amount |
BAD_REQUEST_ERROR | — | — | avs_failure | Payment failed as it did not pass all risk checks. Please try again or use another card. |
BAD_REQUEST_ERROR | — | — | bank_account_validation_failed | Your payment is declined due to a mismatch in account details. Try again with the account registered with the business only. |
BAD_REQUEST_ERROR | — | — | card_bin_not_found | Card could not be processed. Please try a different card |
BAD_REQUEST_ERROR | — | — | card_not_eligible | The card is not eligible for tokenisation. |
BAD_REQUEST_ERROR | — | — | card_read_error | Card could not be read properly. Please try again |
SERVER_ERROR | — | — | cross_border_error | Error unmarshalling HTTP response |
BAD_REQUEST_ERROR | — | — | decryption_failed | Decryption failed |
BAD_REQUEST_ERROR | — | — | duplicate_transaction | This transaction has already been processed |
BAD_REQUEST_ERROR | — | — | expired_otp | Payment processing failed because of expired OTP |
BAD_REQUEST_ERROR | — | — | fallback_declined | Payment could not be processed. Please try again |
BAD_REQUEST_ERROR | — | — | fees_greater_than_amount | Invalid Fee |
BAD_REQUEST_ERROR | — | — | giftcard_limits_exhausted | Your payment didn’t go through as you have exhausted the Giftcard limits. You can buy more giftcards next cycle. |
GATEWAY_ERROR | — | — | incorrect_cardholder_name | You’ve entered an incorrect card name. Try again. |
BAD_REQUEST_ERROR | — | — | incorrect_request | Something went wrong, please try again after sometime. |
BAD_REQUEST_ERROR | — | — | invalid_data | Your payment didn’t go through due to a temporary issue. Please reach out to the business. |
BAD_REQUEST_ERROR | — | — | invalid_iin | TThe requested IIN is not a valid token IIN |
BAD_REQUEST_ERROR | — | — | invalid_transaction | This transaction could not be processed. Please try again |
BAD_REQUEST_ERROR | — | — | invalid_txn_id | The transaction id is invalid |
BAD_REQUEST_ERROR | — | — | issuer_special_condition | Payment could not be processed. Please contact your card issuer |
INTERNAL_SERVER_ERROR | — | — | key_exchange_failed | Payment could not be processed. Please try again |
BAD_REQUEST_ERROR | — | — | NA | Could not validate payment callback request due to: %s |
BAD_REQUEST_ERROR | — | — | No checking account | No active checking account linked to the card. Contact your issuer or use another payment method. |
BAD_REQUEST_ERROR | — | — | No saving account | No active savings account linked to the card. Contact your issuer or use another payment method. |
BAD_REQUEST_ERROR | — | — | otp_length_invalid | Payment was unsuccessful as the OTP length is incorrect. Please submit a valid OTP with length of 4, 6 or 8 digits. |
GATEWAY_ERROR | — | — | payment_authorization | Your payment didn’t go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
BAD_REQUEST_ERROR | — | — | pending_confirmation | The transaction is pending final confirmation from the payment provider. |
BAD_REQUEST_ERROR | — | — | pin_required | PIN is required for this transaction. Please try again |
INTERNAL_SERVER_ERROR | — | — | pricing_not_configured | Payment could not be processed. Please contact the merchant |
GATEWAY_ERROR | — | — | terminal_error | Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method. |
BAD_REQUEST_ERROR | — | — | terminal_not_found | Payment could not be processed. Please contact the merchant |
BAD_REQUEST_ERROR | — | — | tpv_not_enabled | Your payment was unsuccessful as this seller is not enabled for card payments. Try using another method. |
GATEWAY_ERROR | — | — | transaction_frequency_limit_exceeded | Payment was unsuccessful as the number of transactions exceeds the max limit set by the bank. You can use another bank account or retry after some time. |
UPI: available in test mode (24)
Customer (11)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
203 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_debit_request | bank_account_invalid | Payment was unsuccessful as your bank account linked to this UPI ID is invalid. Try using another account. |
204 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_pin | You have entered an incorrect PIN on the UPI app. Please retry with the correct PIN. |
201 (Intent / QR) | GATEWAY_ERROR | customer | payment_debit_request | insufficient_funds | Transaction failed due to insufficient funds. |
407 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | invalid_device | Payment was unsuccessful as you may not be registered on the app you’re trying to pay with. Try using another method. |
202 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_request | mobile_number_invalid | Payment was unsuccessful as the phone number linked to this UPI ID is changed/removed. Try using another method. |
302 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | payment_cancelled | You may have cancelled the payment or there was a delay in response from the UPI app. |
301 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | payment_collect_request_expired | Payment was unsuccessful as you could not pay with the UPI app within time. |
304 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | payment_declined | You have declined the payment request on the UPI app. Please retry when you are ready. |
206 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | pin_attempts_exceeded | Payment was unsuccessful as you have breached the limit to enter UPI PIN incorrectly. Try using another method. |
205 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_authentication | pin_not_set | Payment was unsuccessful as you have not set the UPI PIN on the app. Try using another method. |
208 (Intent / QR) | BAD_REQUEST_ERROR | customer | payment_debit_response | transaction_limit_exceeded | Payment was unsuccessful as you exceeded the amount limit for the day with this bank account. Try using another account. |
Issuing bank (5)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
104 (Intent / QR) | GATEWAY_ERROR | issuer_bank | payment_debit_response | bank_technical_error | Payment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days. |
102 (Intent / QR) | GATEWAY_ERROR | issuer_bank | payment_debit_request | bank_technical_error | 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. |
212 (Intent / QR) | BAD_REQUEST_ERROR | issuer_bank | payment_debit_request | debit_instrument_blocked | Payment was unsuccessful as the account linked to this UPI ID is blocked. Try using another account. |
402 (Intent / QR) | GATEWAY_ERROR | issuer_bank | payment_debit_request | payment_declined | Payment failed. Please try again with another bank account. |
404 (Intent / QR) | GATEWAY_ERROR | issuer_bank | payment_debit_response | payment_risk_check_failed | Payment was unsuccessful as your account does not pass the risk checks done by your bank. Try using another account. |
Beneficiary bank (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
106 (Intent / QR) | GATEWAY_ERROR | beneficiary_bank | payment_credit_request | bank_technical_error | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
Customer’s UPI app (PSP) (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
107 (Intent / QR) | GATEWAY_ERROR | customer_psp | payment_request | upi_app_ not_available | Payment was unsuccessful as the UPI app is not reachable at this time. |
Network (NPCI / card network) (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
105 (Intent / QR) | GATEWAY_ERROR | network | payment_authentication | payment_timed_out | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
401 (Intent / QR) | GATEWAY_ERROR | network | payment_request | vpa_resolution_failed | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. |
Gateway (3)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
213 (Intent / QR) | GATEWAY_ERROR | gateway | payment_credit_request | beneficiary_account_does_not_exist | Payment was unsuccessful as the receiver’s bank account is inactive. Any amount deducted will be refunded within 5-7 working days. |
406 (Intent / QR) | BAD_REQUEST_ERROR | gateway | payment_request | duplicate_request | Payment was unsuccessful due to a temporary issue. If amount got deducted, it will be refunded within 5-7 working days. |
103 (Intent / QR) | GATEWAY_ERROR | gateway | payment_response | gateway_technical_error | Payment processing failed due to error at bank or wallet gateway |
Your request (business) (1)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
210 (Intent / QR) | BAD_REQUEST_ERROR | business | payment_initiation | transaction_frequency_limit_exceeded | Payment was unsuccessful as your UPI app is not supported. Try using another method. |
UPI: not available in test mode (44)
Customer (6)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | customer | payment_debit_response | insufficient_funds | Payment was unsuccessful as there was an insufficient amount in the account linked to this UPI ID. Try using another account. |
BAD_REQUEST_ERROR | customer | payment_request | invalid_vpa | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. |
BAD_REQUEST_ERROR | customer | payment_initiation | invalid_vpa | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. |
BAD_REQUEST_ERROR | customer | payment_authentication | invalid_vpa | You have entered an incorrect UPI ID. Please retry with the correct UPI ID. |
BAD_REQUEST_ERROR | customer | payment_debit_request | payment_declined | Payment was unsuccessful as your bank does not allow UPI payments from a multi-customer account. Try using another method. |
BAD_REQUEST_ERROR | customer | payment_authentication | payment_timed_out | Payment was unsuccessful as you could not complete it in time. |
Issuing bank (8)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | issuer_bank | payment_debit_request | bank_cutoff_in_progress | Payment was unsuccessful due to a temporary halt of services at this bank. Try using another method. |
GATEWAY_ERROR | issuer_bank | payment_debit_request | bank_not_available | Payment was unsuccessful as the bank linked to this UPI ID is temporarily not available. Try using another method. |
GATEWAY_ERROR | issuer_bank | payment_debit_response | compliance_violation | Payment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account. |
GATEWAY_ERROR | issuer_bank | payment_request | duplicate_rrn_found | Payment was unsuccessful due to a temporary issue. Please retry in some time. |
GATEWAY_ERROR | issuer_bank | payment_debit_response | issuer_technical_error | Payment was unsuccessful as it was declined by your bank. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | issuer_bank | payment_debit_response | payment_declined | Payment was unsuccessful as it was declined by your bank. Reach out to your bank for more details. Try using another account. |
GATEWAY_ERROR | issuer_bank | payment_debit_response | payment_declined_due_to_high_traffic | Payment was unsuccessful due to a temporary issue at your bank. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | issuer_bank | payment_debit_response | payment_timed_out | 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. |
Beneficiary bank (8)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | beneficiary_bank | payment_response | bank_technical_error | Payment processing failed due to error at bank or wallet gateway |
GATEWAY_ERROR | beneficiary_bank | payment_debit_response | bank_technical_error | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | beneficiary_bank | payment_credit_response | bank_technical_error | Beneficiary credentials are invalid |
GATEWAY_ERROR | beneficiary_bank | payment_credit_response | credit_failed | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | beneficiary_bank | payment_credit_response | credit_not_permitted | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | beneficiary_bank | payment_response | duplicate_rrn_found | Payment was unsuccessful due to a temporary issue. Please retry in some time |
GATEWAY_ERROR | beneficiary_bank | payment_credit_response | payment_risk_check_failed | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | beneficiary_bank | payment_credit_request | request_timed_out | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
Customer’s UPI app (PSP) (2)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | customer_psp | payment_authentication | psp_not_available | Payment was unsuccessful as the UPI app is not reachable at this time. Any amount deducted will be refunded within 5-7 working days. |
BAD_REQUEST_ERROR | customer_psp | payment_authentication | transaction_on_vpa_restricted | Payment was unsuccessful as it was declined by your UPI app. Try using another method. |
Gateway (15)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | gateway | payment_authorization | authorisation_declined_by_psp | Payment was unsuccessful as collect request was rejected on UPI app.Please initiate the request again |
GATEWAY_ERROR | gateway | payment_request | gateway_technical_error | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_status_request | gateway_technical_error | Payment processing failed due to error at bank or wallet gateway |
GATEWAY_ERROR | gateway | payment_request | invalid_request | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_response | invalid_response_from_gateway | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
BAD_REQUEST_ERROR | gateway | payment_credit_request | merchant_not_activated | Payment was unsuccessful as this business does not accept UPI payments currently. Try using another method. |
GATEWAY_ERROR | gateway | payment_response | mismatch_in_transaction_details | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_response | payment_failed | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_status_request | payment_pending | The status of your payment is pending. You can either wait or retry to pay successfully. |
GATEWAY_ERROR | gateway | payment_request | payment_timed_out | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_authorization | payment_timed_out | Payment was unsuccessful as the bank linked to this UPI ID is not reachable at this time. |
GATEWAY_ERROR | gateway | payment_credit_request | transaction_not_allowed | Payment was unsuccessful as it got declined by the receiver’s bank. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | payment_response | — | Payment was unsuccessful due to a temporary issue. Any amount deducted will be refunded within 5-7 working days. |
GATEWAY_ERROR | gateway | refund_request | — | Refund was not created successfully due to a temporary issue. Please retry in some time. |
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. |
Your request (business) (1)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | business | payment_initiation | input_validation_failed | Payment was unsuccessful as the details are invalid. Please retry with the right details. |
Razorpay internal (4)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
SERVER_ERROR | internal | payment_initiation | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. |
SERVER_ERROR | internal | — | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. |
GATEWAY_ERROR | internal | payment_request | — | Payment was unsuccessful due to a temporary issue. If money got deducted, reach out to the seller. |
SERVER_ERROR | internal | payment_initiation | — | We are facing some trouble completing your request at the moment. Please try again shortly. |
Card recurring: available in test mode (17)
Customer (10)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0000 0009 (registration, choose Failure) | GATEWAY_ERROR | customer | payment_authentication | authentication_failed | Your payment could not be completed due to incorrect OTP or verification details. Try another payment method or contact your bank for details. |
4100 2800 0006 0011 (registration, choose Failure) | BAD_REQUEST_ERROR | customer | card_mandate_creation | card_mandate_card_not_supported | This card is not eligible for recurring payments. Please use a different card. |
4718 6091 2000 0016 (subsequent debit) | BAD_REQUEST_ERROR | customer | payment_create_validation | card_mandate_not_active | Card mandate is not active. |
4718 6091 2007 0019 (subsequent debit) | BAD_REQUEST_ERROR | customer | payment_create_validation | card_mandate_paused | Card mandate is not active, it is paused by the user. |
4100 2800 0004 0013 (registration, choose Failure) | GATEWAY_ERROR | customer | card_enrollment_check | card_not_enrolled | Your payment could not be completed as this card is not enabled for online payments. Try another payment method or contact your bank for details. |
4718 6091 2009 0017 (subsequent debit) | BAD_REQUEST_ERROR | customer | payment_authorization | customer_action_required | The payment request failed as the pre-debit notification was not approved. |
4100 2800 0008 0001 (registration, choose Failure) | BAD_REQUEST_ERROR | customer | payment_authorization | insufficient_funds | Your payment could not be completed due to insufficient account balance. Try another card or payment method. |
4718 6000 0007 0021 (subsequent debit) | BAD_REQUEST_ERROR | customer | payment_authorization | insufficient_funds | Your payment could not be completed due to insufficient account balance. Try another card or payment method. |
4100 2800 0007 0002 (registration, choose Failure) | BAD_REQUEST_ERROR | customer | payment_authentication | payment_cancelled | Your payment has been cancelled. Try again or complete the payment later. |
4100 2800 0009 0000 (registration, choose Failure) | BAD_REQUEST_ERROR | customer | payment_authentication | payment_timed_out | Payment was not completed on time. |
Issuing bank (3)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4100 2800 0005 0004 (registration, choose Failure) | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
4100 2800 0003 0006 (registration, choose Failure) | BAD_REQUEST_ERROR | issuer_bank | payment_authorization | card_disabled_for_online_payments | Your card has been disabled for online payments by your issuing bank. Please reach out to your bank or re-try the payment with another card or method. |
4718 6091 2001 0015 (subsequent debit) | BAD_REQUEST_ERROR | issuer_bank | pre_debit_notification_verify | pre_debit_notification_failed | The payment request failed as the pre-debit notification was not sent to the customer. |
Issuer (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
6527 6500 0007 0022 (registration, choose Failure) | BAD_REQUEST_ERROR | issuer | card_mandate_creation | card_mandate_bin_not_supported | Card BIN not supported for recurring payments. |
4100 2800 0005 0012 (registration, choose Success) | — | issuer | — | token.rejected (webhook) | Registration payment succeeds; the token is rejected at the mandate hub because the BIN isn’t supported. |
Your request (business) (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
4718 6091 2008 0018 (subsequent debit) | BAD_REQUEST_ERROR | business | payment_initiation | token_expired | Token has expired and cannot be used for recurring payments. |
4718 6091 2002 0014 (subsequent debit) | BAD_REQUEST_ERROR | business | payment_initiation | token_not_eligible | Token is not confirmed for recurring payments. |
Card recurring: not available in test mode (59)
Customer (26)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | customer | payment_authentication | bank_account_invalid | Payment failed because of invalid account |
BAD_REQUEST_ERROR | customer | payment_authentication | card_cvv_invalid | You have entered an incorrect CVV number. Try again. |
BAD_REQUEST_ERROR | customer | payment_authentication | card_expired | Your payment could not be completed as your card has expired. Try another payment method. |
BAD_REQUEST_ERROR | customer | payment_create_validation | card_mandate_cancelled | Card mandate is not active, it is cancelled by user |
BAD_REQUEST_ERROR | customer | payment_create_validation | card_mandate_expired | Card mandate is not active, it is expired |
BAD_REQUEST_ERROR | customer | payment_authentication | card_number_invalid | You’ve entered an incorrect card number. Try again. |
BAD_REQUEST_ERROR | customer | payment_authorization | debit_instrument_blocked | Your payment could not be completed as your card is blocked. Try another payment method or contact your bank for details. |
BAD_REQUEST_ERROR | customer | payment_authorization | debit_instrument_inactive | Your payment could not be completed as this card is not enabled for online payments. Try another payment method or contact your bank for details. |
BAD_REQUEST_ERROR | customer | payment_authorization | incorrect_card_details | You’ve entered incorrect card details. Try again or retry the payment with another card or method. |
BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_card_details | Your payment didn’t go through due to invalid card number or invalid expiry. Please try again. |
GATEWAY_ERROR | customer | payment_authentication | incorrect_card_details | Your payment didn’t go through due to invalid card number or invalid expiry. Please try again. |
BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_card_expiry_date | You’ve entered an incorrect expiration date. Try again. |
BAD_REQUEST_ERROR | customer | payment_authorization | incorrect_cvv | You’ve entered an incorrect CVV number. Try again. |
BAD_REQUEST_ERROR | customer | payment_authentication | incorrect_pin | Payment failed |
BAD_REQUEST_ERROR | customer | payment_authentication | otp_attempts_exceeded | Payment processing failed because OTP validation attempts limit exceeded |
BAD_REQUEST_ERROR | customer | payment_authorization | payment_declined | customer opted out of the payment |
BAD_REQUEST_ERROR | customer | payment_authentication | pin_attempts_exceeded | You’ve entered an incorrect pin too many times. Try again in sometime. |
BAD_REQUEST_ERROR | customer | payment_authorization | request_timed_out | The payment failed as the predebit notification was approved by the customer after the predefined TAT |
BAD_REQUEST_ERROR | customer | pre_debit_notification | token_deleted | The requested token has been deleted |
BAD_REQUEST_ERROR | customer | payment_authorization | transaction_daily_count_exceeded | You’ve reached the maximum transaction limit on this card for today. Try another payment method or contact your bank. |
BAD_REQUEST_ERROR | customer | payment_authorization | transaction_limit_exceeded | You’ve reached the maximum transaction limit for this card. Try another payment method or contact your bank. |
BAD_REQUEST_ERROR | customer | payment_authentication | authentication_failed | Your payment could not be completed due to incorrect OTP or verification details. Try another payment method or contact your bank for details. |
BAD_REQUEST_ERROR | customer | payment_authentication | card_declined | Your payment could not be completed due to incorrect card details. Try another payment method or contact your bank for details. |
BAD_REQUEST_ERROR | customer | payment_authentication | card_not_enrolled | Payment processing failed because cardholder is not enrolled for the required 3dsecure authentication |
GATEWAY_ERROR | customer | payment_authorization | insufficient_funds | Your payment could not be completed due to insufficient account balance. Try another card or payment method. |
BAD_REQUEST_ERROR | customer | pre_debit_notification | pre_debit_notification_failed | Payment debit notification failed to deliver to customer |
Issuing bank (9)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | issuer_bank | payment_authorization | bank_technical_error | Your payment didn’t go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
BAD_REQUEST_ERROR | issuer_bank | payment_authentication | bank_technical_error | Payment was unsuccessful due to some issue with issuer bank. Please try again. |
GATEWAY_ERROR | issuer_bank | payment_authorization | bank_technical_error | Your payment did not go through due to a temporary technical issue at the bank. Any debited amount will be refunded in 4-5 business days. |
BAD_REQUEST_ERROR | issuer_bank | payment_authentication | declined_by_bank | Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank. |
BAD_REQUEST_ERROR | issuer_bank | payment_authorization | issuer_declined | Transaction not supported/blocked by issuer |
BAD_REQUEST_ERROR | issuer_bank | payment_authorization | payment_risk_check_failed | Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank. |
BAD_REQUEST_ERROR | issuer_bank | payment_initiation | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
GATEWAY_ERROR | issuer_bank | payment_authorization | card_declined | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
GATEWAY_ERROR | issuer_bank | payment_authorization | card_not_enrolled | Your payment didn’t go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
Bank (1)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | bank | payment_authorization | card_restricted | Payment processing failed due to error at bank or wallet gateway |
Gateway (8)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | gateway | payment_authorization | gateway_technical_error | Payment processing failed due to error at bank or wallet gateway |
GATEWAY_ERROR | gateway | payment_request | gateway_technical_error | Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method |
BAD_REQUEST_ERROR | gateway | payment_authorization | incorrect_card_details | Your payment didn’t go through due to invalid card number or invalid expiry. Please try again. |
GATEWAY_ERROR | gateway | payment_authorization | incorrect_card_details | We couldn’t create a secure token for this card, as the card details couldn’t be verified or the issuer doesn’t support it. Try another card or payment method. |
SERVER_ERROR | gateway | payment_authentication | server_error | Payment was unsuccessful due to temporary issue. Please try again. |
GATEWAY_ERROR | gateway | payment_authorization | card_declined | Action cannot be performed as the payment-credential request for the token was declined |
BAD_REQUEST_ERROR | gateway | payment_authorization | payment_timed_out | Payment was not completed on time. |
GATEWAY_ERROR | gateway | payment_authentication | payment_timed_out | Your payment could not be completed as the system took too long to respond. Please try again. |
Your request (business) (6)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | business | card_mandate_notification_creation | card_mandate_notification_invalid_debit_date | Debit date out of range |
BAD_REQUEST_ERROR | business | card_mandate_notification_creation | card_mandate_notification_limit_exceeded | Card mandate pre debit notification limit exceeded for today |
BAD_REQUEST_ERROR | business | payment_initiation | international_transaction_not_allowed | International cards are not supported. Please contact our support team for help |
BAD_REQUEST_ERROR | business | payment_create_validation | mandate_current_cycle_allowed_debit_exceeds | Mandate debit not as per frequency |
BAD_REQUEST_ERROR | business | payment_initiation | request_validation_failed | Partner is not enabled for the merchant category |
BAD_REQUEST_ERROR | business | payment_initiation | transaction_amount_limit_exceeded | Payment failed because Transaction amount limit has exceeded |
Razorpay internal (8)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | internal | payment_initiation | bin_disabled | Your payment could not be completed as your card is not supported. Try another payment method. |
SERVER_ERROR | internal | payment_creation | internal | The server encountered an error. The incident has been reported to admins. |
BAD_REQUEST_ERROR | internal | payment_initiation | payment_risk_check_failed | Your payment didn’t go through as it was declined due to potential risk. Try another payment method. |
BAD_REQUEST_ERROR | internal | get_token | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. |
GATEWAY_ERROR | internal | payment_initiation | server_error | Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method. |
SERVER_ERROR | internal | payment_validate | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. |
SERVER_ERROR | internal | payment_authorization | server_error | We are facing some trouble completing your request at the moment. Please try again shortly. |
SERVER_ERROR | internal | payment_initiation | server_error | Your payment didn’t go through as it was declined by the bank. Try another payment method or contact your bank. |
service_provider (1)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | service_provider | get_token | invalid_token | The token is invalid. Please use a valid token. |
UPI Autopay: available in test mode (42)
Customer (12)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
205 (registration) | GATEWAY_ERROR | customer | payment_debit_response | customer_mpin_not_set | UPI PIN is not set for this account. Please set up your UPI PIN and try again. |
205 (debit) | GATEWAY_ERROR | customer | payment_authentication | customer_mpin_not_set | UPI PIN is not set for this account. Please set up your UPI PIN and try again. |
407 (registration) | GATEWAY_ERROR | customer | payment_response | customer_psp_fingerprint_mismatch | Payment was declined for security reasons. Please contact your bank for more details. |
204 (registration) | GATEWAY_ERROR | customer | payment_initiation | incorrect_pin_entered | Payment authorisation failed due to incorrect MPIN. Please retry with the correct MPIN. |
206 (registration) | GATEWAY_ERROR | customer | payment_response | incorrect_pin_entered | You’ve exceeded the number of PIN attempts. Please wait and try again later, or contact your bank if you’ve forgotten your PIN. |
206 (debit) | GATEWAY_ERROR | customer | payment_authentication | incorrect_pin_entered | You’ve exceeded the number of PIN attempts. Please wait and try again later, or contact your bank if you’ve forgotten your PIN. |
201 (debit) | GATEWAY_ERROR | customer | payment_debit_request | insufficient_funds | Insufficient balance in your account. Please add funds and try again. |
401 (registration) | GATEWAY_ERROR | customer | payment_debit_request | invalid_vpa | Invalid UPI ID entered. Please enter a valid UPI ID and retry. |
304 (registration) | GATEWAY_ERROR | customer | payment_authentication | mandate_cancelled_by_user | You cancelled the UPI payment. Set it up again to complete your order. |
304 (debit) | GATEWAY_ERROR | customer | payment_debit_request | mandate_cancelled_by_user | This payment was declined. Please approve the payment request on your UPI app or try again. |
301 (registration) | GATEWAY_ERROR | customer | payment_authentication | mandate_collect_request_expired | You didn’t approve the request in your UPI app. Please try again and approve within 10 minutes. |
301 (debit) | GATEWAY_ERROR | customer | payment_authentication | mandate_collect_request_expired | You didn’t approve the request in your UPI app. Please try again and approve within 10 minutes. |
Customer’s bank (remitter) (24)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
212 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_request | account_blocked | Your account is blocked or frozen. Please contact your bank to resolve this. |
212 (registration) | GATEWAY_ERROR | remitter_bank | payment_status_request | account_state_blocked | Your account is blocked or frozen. Please contact your bank to resolve this. |
203 (registration) | GATEWAY_ERROR | remitter_bank | payment_authentication | account_state_forbidden | UPI Autopay setup is not allowed for this account. Please contact your bank or try a different account. |
101 (registration) | GATEWAY_ERROR | remitter_bank | payment_debit_response | bank_technical_error | UPI Autopay setup couldn’t be completed due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
102 (registration) | GATEWAY_ERROR | remitter_bank | payment_response | bank_technical_error | Your bank is temporarily unavailable. Please try again later or use a different account. |
107 (registration) | GATEWAY_ERROR | remitter_bank | payment_authentication | bank_technical_error | UPI Autopay setup couldn’t be completed due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
202 (registration) | GATEWAY_ERROR | remitter_bank | payment_debit_response | customer_invalid_mobile_number | Your mobile number has been changed or removed from this account. Please update your details or use a different account. |
202 (debit) | GATEWAY_ERROR | remitter_bank | payment_request | customer_mobile_changed | Your registered mobile number has been updated. Please update your UPI profile or contact your bank. |
203 (debit) | GATEWAY_ERROR | remitter_bank | payment_authorization | declined_by_remitter_bank | Your bank declined the payment. Please contact your bank. |
210 (debit) | GATEWAY_ERROR | remitter_bank | payment_initiation | frequency_limit_exceeded | You’ve exceeded the number of allowed transactions. Please try again later or contact your bank. |
201 (registration) | GATEWAY_ERROR | remitter_bank | payment_response | insufficient_funds | Insufficient balance in your account. Please add funds and try again. |
101 (debit) | GATEWAY_ERROR | remitter_bank | payment_response | remitter_bank_error | Your bank is experiencing technical issues. Please try again later. |
102 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_request | remitter_bank_unavailable | Your bank is temporarily unavailable. Please try again in a few moments. |
107 (debit) | GATEWAY_ERROR | remitter_bank | payment_request | remitter_bank_unavailable | Your bank is temporarily unavailable. Please try again in a few moments. |
405 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_response | risk_declined | Payment was declined for security reasons. Please contact your bank for assistance. |
404 (registration) | GATEWAY_ERROR | remitter_bank | payment_response | risk_declined_by_remitter_bank | Autopay setup was blocked for security reasons. Please contact your bank or use a different account. |
405 (registration) | GATEWAY_ERROR | remitter_bank | payment_initiation | risk_declined_by_remitter_bank | Autopay setup was declined for security reasons. Please contact your bank for assistance. |
209 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_response | spending_limit_exceeded | You’ve exceeded your total UPI spending limit. Please try again later or contact your bank to increase the limit. |
104 (registration) | GATEWAY_ERROR | remitter_bank | payment_response | timeout_at_remitter_bank | Your bank took too long to respond. Please try again. |
104 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_response | timeout_at_remitter_bank | Your bank took too long to respond. Please try again. |
208 (registration) | GATEWAY_ERROR | remitter_bank | payment_initiation | transaction_amount_limit_exceeded | This amount is above your transaction limit. Please try a lower amount or contact your bank for assistance. |
209 (registration) | GATEWAY_ERROR | remitter_bank | payment_authentication | transaction_amount_limit_exceeded | This amount is above your transaction limit. Please try a lower amount or contact your bank for assistance. |
210 (registration) | GATEWAY_ERROR | remitter_bank | payment_response | transaction_frequency_limit_exceeded | You’ve exceeded the number of allowed transactions on this account. Please try again later or contact your bank. |
208 (debit) | GATEWAY_ERROR | remitter_bank | payment_debit_response | transaction_limit_exceeded | Payment amount exceeds your bank’s limit. Please try with a lower amount or contact your bank to increase the limit. |
Customer’s UPI app (PSP) (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
103 (registration) | GATEWAY_ERROR | customer_psp | payment_response | duplicate_request | A mandate setup is already in progress. Please wait for it to complete or try again in a few moments. |
103 (debit) | GATEWAY_ERROR | customer_psp | payment_initiation | duplicate_request | A duplicate payment request was detected. If the earlier payment was successful, no action is needed. Otherwise, please retry. |
Your request (business) (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
213 (registration) | BAD_REQUEST_ERROR | business | payment_response | beneficiary_account_not_found | Payment authorisation failed due to a technical issue. Please try again or contact your bank if this continues. |
404 (debit) | BAD_REQUEST_ERROR | business | payment_debit_response | risk_declined | Payment was declined for security reasons. Please contact your bank for assistance. |
Razorpay internal (2)
| Trigger | error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|---|
302 (registration) | BAD_REQUEST_ERROR | internal | payment_response | mandate_cancelled_by_user | You cancelled the payment setup. Please try again. |
406 (registration) | BAD_REQUEST_ERROR | internal | payment_response | request_validation_failed | UPI Autopay setup failed due to a technical issue. Please try again. |
UPI Autopay: not available in test mode (48)
Customer (11)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | customer | payment_response | account_changed | Your account information has changed. Please set up the mandate again with your current account. |
GATEWAY_ERROR | customer | payment_status_request | address_resolution_failed | We couldn’t verify your UPI ID. Please check it’s correct and try again. |
GATEWAY_ERROR | customer | payment_authentication | business_blocked_by_customer | Payment failed as you have blocked requests from this business. Please unblock this business in your UPI app and try again. |
GATEWAY_ERROR | customer | payment_debit_request | first_time_user_freeze_period | You’ve exceeded the ₹5,000 limit for new UPI users in the first 24 hours. Please wait or set up a mandate for a lower amount. |
GATEWAY_ERROR | customer | payment_response | first_transaction_limit_exceeded | Payment declined as your first transaction is limited to ₹5,000. Please retry later. |
GATEWAY_ERROR | customer | payment_response | funds_blocked_for_mandate | Insufficient balance in your account. Please add funds and try again. |
GATEWAY_ERROR | customer | payment_authentication | mandate_creation_expired | The mandate setup has timed out. Please try again and approve the request in your UPI app within 10 minutes. |
GATEWAY_ERROR | customer | payment_response | mandate_not_actioned_by_user | Payment setup timed out. Please try again. |
GATEWAY_ERROR | customer | payment_response | mandate_paused | This UPI Autopay is paused. Please unpause it to continue payments with the business. |
GATEWAY_ERROR | customer | payment_response | mandate_revoked | This UPI Autopay was cancelled. Please set it up again. |
GATEWAY_ERROR | customer | payment_response | vpa_restricted | You have restricted this UPI ID. Please unblock it in your UPI app settings and try again. |
Customer’s bank (remitter) (18)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | remitter_bank | payment_credit_response | account_restricted | Payment failed due to a technical issue. Please contact support. |
GATEWAY_ERROR | remitter_bank | payment_response | account_type_invalid | Payment is not allowed for this account type. Please try a different account or contact your bank. |
GATEWAY_ERROR | remitter_bank | payment_authentication | account_type_not_supported | Payment is not allowed for this account type. Please try a different account or contact your bank. |
GATEWAY_ERROR | remitter_bank | payment_response | amount_invalid_gateway_error | Payment failed due to a technical issue. Please try again or contact support if this continues. |
GATEWAY_ERROR | remitter_bank | payment_response | bank_not_supported_for_mandate | Your bank doesn’t support UPI Autopay. Please use a different bank account. |
GATEWAY_ERROR | remitter_bank | payment_initiation | card_lost_or_stolen | This account cannot be used due to security reasons. Please contact your bank or use a different account. |
GATEWAY_ERROR | remitter_bank | payment_response | card_not_found | Card record not found. Please contact your bank. |
GATEWAY_ERROR | remitter_bank | payment_debit_response | compliance_violation | This payment was declined by the bank due to compliance restrictions. Please contact your bank for details. |
GATEWAY_ERROR | remitter_bank | payment_debit_response | customer_account_invalid | Your account details have changed. Please update your UPI profile or contact your bank. |
GATEWAY_ERROR | remitter_bank | payment_debit_request | customer_account_not_found | This account could not be found. Please contact your bank or try again. |
GATEWAY_ERROR | remitter_bank | payment_debit_request | customer_account_status_inactive | Your account is inactive or dormant. Please contact your bank to activate it. |
GATEWAY_ERROR | remitter_bank | payment_authentication | debit_exceeds_blocked_amount | Payment amount exceeds blocked amount. Please contact support. |
GATEWAY_ERROR | remitter_bank | payment_response | mandate_creation_limit_exceeded | You’ve reached the maximum number of UPI Autopay mandates allowed by your bank. Please use a different account. |
GATEWAY_ERROR | remitter_bank | payment_response | mandate_limit_exceeded_remitter_decline | Payment failed as your bank’s limit has been exceeded. Please contact your bank or try a different account. |
GATEWAY_ERROR | remitter_bank | payment_initiation | pin_credential_block_missing | Your UPI app did not send the UPI PIN needed to authorise this mandate. Please try again and approve with your UPI PIN. |
GATEWAY_ERROR | remitter_bank | payment_response | remitter_bank_throttling | Your bank is experiencing high traffic. Please try again in a few moments. |
GATEWAY_ERROR | remitter_bank | payment_response | request_not_found | Payment failed due to a technical issue. Please try again. |
GATEWAY_ERROR | remitter_bank | payment_response | signature_corrupt | Payment was declined for security reasons. Please contact your bank for assistance. |
Customer’s UPI app (PSP) (6)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | customer_psp | payment_debit_response | customer_psp_timeout | Your UPI app took too long to respond. Please try again. |
GATEWAY_ERROR | customer_psp | payment_response | customer_psp_unavailable | Your UPI app is currently unavailable. Please try again in a few moments. |
GATEWAY_ERROR | customer_psp | payment_debit_request | customer_vpa_not_supported | Autopay cannot be set up on this UPI ID. Please use a different UPI ID or account. |
GATEWAY_ERROR | customer_psp | payment_authentication | declined_by_customer_psp | Payment was declined by your UPI app. Please try again or use a different method. |
GATEWAY_ERROR | customer_psp | payment_status_request | psp_amount_cap_exceeded | This amount cannot be set up for UPI Autopay. Please retry with another UPI app or payment method. |
GATEWAY_ERROR | customer_psp | payment_authorization | psp_frequency_limit_exceeded | You’ve exceeded the number of allowed transactions. Please try again later or contact your bank. |
Payee PSP (4)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | payee_psp | payment_debit_response | merchant_psp_error | Payment failed due to a technical issue. Please try again. |
GATEWAY_ERROR | payee_psp | payment_initiation | payee_psp_system_error | Payment failed due to a technical issue. Please try again or contact support if this continues. |
GATEWAY_ERROR | payee_psp | payment_debit_request | payee_psp_timeout | Payment failed due to a technical issue. Please try again or contact support if this continues. |
GATEWAY_ERROR | payee_psp | payment_response | payee_psp_unavailable | Payment failed due to a technical issue. Please try again or contact support if this continues. |
UPI service (4)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
GATEWAY_ERROR | upi_service | payment_debit_response | address_dispatch_failed | Payment couldn’t be completed due to a temporary issue. Any debited amount will be refunded in 4-5 business days. |
GATEWAY_ERROR | upi_service | payment_response | collect_notification_failed | Payment failed as the collect notification expired. Please try again. |
GATEWAY_ERROR | upi_service | payment_response | device_not_permitted | This device is restricted for the payment Please use a registered device or contact your bank. |
GATEWAY_ERROR | upi_service | payment_response | invalid_transaction_id | Payment failed due to a technical issue. Please try again or contact support if this continues. |
Your request (business) (2)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
BAD_REQUEST_ERROR | business | payment_debit_response | mandate_already_executed | This payment has already been processed for the current cycle. No further executions are permitted. |
BAD_REQUEST_ERROR | business | payment_initiation | mandate_expired | This UPI Autopay has expired. Please set it up again. |
Razorpay internal (3)
error.code | error.source | error.step | error.reason | error.description |
|---|---|---|---|---|
SERVER_ERROR | internal | payment_request | internal_server_error | Payment was unsuccessful due to a temporary issue on our side. Any amount deducted will be refunded within 5-7 working days. |
BAD_REQUEST_ERROR | internal | payment_request | record_not_found | Your session ended. This may happen if you didn’t complete the request or took too long. Please try again. |
SERVER_ERROR | internal | payment_response | service_unavailable | Payment is temporarily unavailable. Please try again later. |