> ## 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.

# Error Codes

> List of error codes for card recurring payments, categorised by error reason, with the description, source and step for each.

Available in
🇮🇳 India

Every failed payment or token operation returns an error object with `code`, `description`, `source`, `step` and `reason`. Given below is the list of error codes categorised by error reasons, with relevant descriptions, source and step. Branch your handling on `error.reason`. Some reasons are returned at more than one step, with a different source each time. 59 reasons in total.

* [Bad Request Errors](#bad-request-errors) (46)
* [Gateway Errors](#gateway-errors) (11)
* [Server Errors](#server-errors) (2)

### Bad Request Errors

Given below is the list of Bad Request errors.

> [accordion] insufficient\_funds
>
> * **Description**: Your payment could not be completed due to insufficient account balance. Try another card or payment method.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] customer\_action\_required
>
> * **Description**: The payment request failed as the predebit notification was not approved
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] payment\_timed\_out
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment was not completed on time.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Payment was not completed on time.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`

> [accordion] token\_not\_eligible
>
> * **Description**: Token is not confirmed for recurring payments
> * **Source**: `business`
> * **Step**: `payment_initiation`

> [accordion] pre\_debit\_notification\_failed
>
> > [accordion] Pre Debit Notification Verify
> >
> > * **Description**: The payment request failed as the pre-debit notification was not sent to the customer
> > * **Source**: `issuer_bank`
> > * **Step**: `pre_debit_notification_verify`
>
> > [accordion] Pre Debit Notification
> >
> > * **Description**: Payment debit notification failed to deliver to customer
> > * **Source**: `customer`
> > * **Step**: `pre_debit_notification`

> [accordion] card\_declined
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through as it was declined by the bank. Try another payment method or contact your bank.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment didn't go through as it was declined by the bank. Try another payment method or contact your bank.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment could not be completed due to incorrect card details. Try another payment method or contact your bank for details.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`

> [accordion] debit\_instrument\_blocked
>
> * **Description**: Your payment could not be completed as your card is blocked. Try another payment method or contact your bank for details.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] payment\_cancelled
>
> * **Description**: Your payment has been cancelled. Try again or complete the payment later.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] token\_expired
>
> * **Description**: Token has expired and cannot be used for recurring payments
> * **Source**: `business`
> * **Step**: `payment_initiation`

> [accordion] card\_mandate\_paused
>
> * **Description**: Card mandate is not active, it is paused by user
> * **Source**: `customer`
> * **Step**: `payment_create_validation`

> [accordion] card\_mandate\_not\_active
>
> * **Description**: Card mandate is not active
> * **Source**: `customer`
> * **Step**: `payment_create_validation`

> [accordion] payment\_risk\_check\_failed
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment didn't go through as it was declined due to potential risk. Try another payment method.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`

> [accordion] issuer\_declined
>
> * **Description**: Transaction not supported/blocked by issuer
> * **Source**: `issuer_bank`
> * **Step**: `payment_authorization`

> [accordion] international\_transaction\_not\_allowed
>
> * **Description**: International cards are not supported. Please contact our support team for help
> * **Source**: `business`
> * **Step**: `payment_initiation`

> [accordion] card\_disabled\_for\_online\_payments
>
> * **Description**: 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.
> * **Source**: `issuer_bank`
> * **Step**: `payment_authorization`

> [accordion] debit\_instrument\_inactive
>
> * **Description**: 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.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] incorrect\_card\_details
>
> > [accordion] Payment Authorization
> >
> > * **Description**: You've entered incorrect card details. Try again or retry the payment with another card or method.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment didn't go through due to invalid card number or invalid expiry. Please try again.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through due to invalid card number or invalid expiry. Please try again.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`

> [accordion] card\_mandate\_cancelled
>
> * **Description**: Card mandate is not active, it is cancelled by user
> * **Source**: `customer`
> * **Step**: `payment_create_validation`

> [accordion] transaction\_limit\_exceeded
>
> * **Description**: You've reached the maximum transaction limit for this card. Try another payment method or contact your bank.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] card\_mandate\_card\_not\_supported
>
> * **Description**: This card is not eligible for recurring payments. Please use a different card.
> * **Source**: `customer`
> * **Step**: `card_mandate_creation`

> [accordion] authentication\_failed
>
> * **Description**: Your payment could not be completed due to incorrect OTP or verification details. Try another payment method or contact your bank for details.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] bank\_technical\_error
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment was unsuccessful due to some issue with issuer bank. Please try again.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authentication`

> [accordion] card\_number\_invalid
>
> * **Description**: You've entered an incorrect card number. Try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] incorrect\_cvv
>
> * **Description**: You've entered an incorrect CVV number. Try again.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] transaction\_amount\_limit\_exceeded
>
> * **Description**: Payment failed because Transaction amount limit has exceeded
> * **Source**: `business`
> * **Step**: `payment_initiation`

> [accordion] declined\_by\_bank
>
> * **Description**: Your payment did not go through as it was declined by the bank. Try another payment method or contact your bank.
> * **Source**: `issuer_bank`
> * **Step**: `payment_authentication`

> [accordion] incorrect\_card\_expiry\_date
>
> * **Description**: You've entered an incorrect expiration date. Try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] request\_timed\_out
>
> * **Description**: The payment failed as the predebit notification was approved by the customer after the predefined TAT
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] card\_mandate\_bin\_not\_supported
>
> * **Description**: Card BIN not supported for recurring payments
> * **Source**: `issuer`
> * **Step**: `card_mandate_creation`

> [accordion] card\_expired
>
> * **Description**: Your payment could not be completed as your card has expired. Try another payment method.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] card\_mandate\_expired
>
> * **Description**: Card mandate is not active, it is expired
> * **Source**: `customer`
> * **Step**: `payment_create_validation`

> [accordion] server\_error
>
> * **Description**: We are facing some trouble completing your request at the moment. Please try again shortly.
> * **Source**: `internal`
> * **Step**: `get_token`

> [accordion] payment\_declined
>
> * **Description**: customer opted out of the payment
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] card\_mandate\_notification\_invalid\_debit\_date
>
> * **Description**: Debit date out of range
> * **Source**: `business`
> * **Step**: `card_mandate_notification_creation`

> [accordion] request\_validation\_failed
>
> * **Description**: Partner is not enabled for the merchant category
> * **Source**: `business`
> * **Step**: `payment_initiation`

> [accordion] incorrect\_pin
>
> * **Description**: Payment failed
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] token\_deleted
>
> * **Description**: The requested token has been deleted
> * **Source**: `customer`
> * **Step**: `pre_debit_notification`

> [accordion] invalid\_token
>
> * **Description**: The token is invalid. Please use a valid token.
> * **Source**: `service_provider`
> * **Step**: `get_token`

> [accordion] transaction\_daily\_count\_exceeded
>
> * **Description**: You've reached the maximum transaction limit on this card for today. Try another payment method or contact your bank.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] pin\_attempts\_exceeded
>
> * **Description**: You've entered an incorrect pin too many times. Try again in sometime.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] otp\_attempts\_exceeded
>
> * **Description**: Payment processing failed because OTP validation attempts limit exceeded
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] mandate\_current\_cycle\_allowed\_debit\_exceeds
>
> * **Description**: Mandate debit not as per frequency
> * **Source**: `business`
> * **Step**: `payment_create_validation`

> [accordion] bank\_account\_invalid
>
> * **Description**: Payment failed because of invalid account
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] card\_cvv\_invalid
>
> * **Description**: You have entered an incorrect CVV number. Try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] card\_mandate\_notification\_limit\_exceeded
>
> * **Description**: Card mandate pre debit notification limit exceeded for today
> * **Source**: `business`
> * **Step**: `card_mandate_notification_creation`

> [accordion] card\_not\_enrolled
>
> * **Description**: Payment processing failed because cardholder is not enrolled for the required 3dsecure authentication
> * **Source**: `customer`
> * **Step**: `payment_authentication`

### Gateway Errors

Given below is the list of Gateway errors.

> [accordion] insufficient\_funds
>
> * **Description**: Your payment could not be completed due to insufficient account balance. Try another card or payment method.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] card\_not\_enrolled
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through due to a temporary issue. Any debited amount will be refunded in 4-5 business days.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Card Enrollment Check
> >
> > * **Description**: 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.
> > * **Source**: `customer`
> > * **Step**: `card_enrollment_check`

> [accordion] gateway\_technical\_error
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Payment processing failed due to error at bank or wallet gateway
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Request
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method
> > * **Source**: `gateway`
> > * **Step**: `payment_request`

> [accordion] incorrect\_card\_details
>
> > [accordion] Payment Authorization
> >
> > * **Description**: 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.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment didn't go through due to invalid card number or invalid expiry. Please try again.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`

> [accordion] card\_declined
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through as it was declined by the bank. Try another payment method or contact your bank.
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Action cannot be performed as the payment-credential request for the token was declined
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`

> [accordion] bank\_technical\_error
>
> * **Description**: 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.
> * **Source**: `issuer_bank`
> * **Step**: `payment_authorization`

> [accordion] authentication\_failed
>
> * **Description**: Your payment could not be completed due to incorrect OTP or verification details. Try another payment method or contact your bank for details.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] server\_error
>
> * **Description**: Your payment could not be completed due to a temporary technical issue. To complete the payment, use another payment method.
> * **Source**: `internal`
> * **Step**: `payment_initiation`

> [accordion] card\_restricted
>
> * **Description**: Payment processing failed due to error at bank or wallet gateway
> * **Source**: `bank`
> * **Step**: `payment_authorization`

> [accordion] payment\_timed\_out
>
> * **Description**: Your payment could not be completed as the system took too long to respond. Please try again.
> * **Source**: `gateway`
> * **Step**: `payment_authentication`

> [accordion] bin\_disabled
>
> * **Description**: Your payment could not be completed as your card is not supported. Try another payment method.
> * **Source**: `internal`
> * **Step**: `payment_initiation`

### Server Errors

Given below is the list of Server errors.

> [accordion] server\_error
>
> > [accordion] Payment Validate
> >
> > * **Description**: We are facing some trouble completing your request at the moment. Please try again shortly.
> > * **Source**: `internal`
> > * **Step**: `payment_validate`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: We are facing some trouble completing your request at the moment. Please try again shortly.
> > * **Source**: `internal`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment didn't go through as it was declined by the bank. Try another payment method or contact your bank.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment was unsuccessful due to temporary issue. Please try again.
> > * **Source**: `gateway`
> > * **Step**: `payment_authentication`

> [accordion] internal
>
> * **Description**: The server encountered an error. The incident has been reported to admins.
> * **Source**: `internal`
> * **Step**: `payment_creation`

### Related Information

* [How Cards Recurring Works](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/cards/how-it-works.md)
* [Create the Authorisation Transaction](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/cards/authorization-transaction.md)
* [Fetch and Manage Tokens](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/cards/tokens.md)
* [Create Subsequent Payments](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/cards/subsequent-payments.md)
* [FAQs](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/cards/faqs.md)
