> ## 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 Paper NACH 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. 48 reasons in total.

* [Bad Request Errors](#bad-request-errors) (41)
* [Gateway Errors](#gateway-errors) (6)
* [Server Errors](#server-errors) (1)

### Bad Request Errors

Given below is the list of Bad Request errors.

> [accordion] already\_declined
>
> * **Description**: Your eMandate registration didn't go through as it was declined. Try another account or contact your bank for details.
> * **Source**: `customer`
> * **Step**: `payment_initiation`

> [accordion] authentication\_failed
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment could not be completed due to incorrect account details. Try again.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your Aadhaar is suspended/Locked and not in an authenticatable state. Please contact UIDAI and try again.
> > * **Source**: `customer`
> > * **Step**: `payment_initiation`

> [accordion] instrument\_blocked
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Payment failed because account withdrawal are frozen
> > * **Source**: `issuer_bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your account is frozen due to a court or attachment order. Please contact your bank for assistance.
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not completed as KYC for your bank account is pending. Try another account or contact your bank for details.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: The Customer ID entered does not match bank records. Please check and try again.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`

> [accordion] payment\_cancelled
>
> > [accordion] Payment Processing
> >
> > * **Description**: Payment processing cancelled by user
> > * **Source**: `customer`
> > * **Step**: `payment_processing`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment has been cancelled. Try again or complete the payment later.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed as it was cancelled by the customer.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] bank\_account\_invalid
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not be completed as your bank account is closed. Try another account or contact your bank for details.
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Processing
> >
> > * **Description**: The payment could not be completed as the customer's bank account is closed or blocked.
> > * **Source**: `customer`
> > * **Step**: `payment_processing`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The account number entered does not exist. Please check and enter the correct account number.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment failed because of invalid account
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Bank Account is closed.
> > * **Source**: `internal`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Validation
> >
> > * **Description**: Your payment could not be completed as this mandate has been permanently blocked due to repeated account closed or invalid account failures. Please contact support to resolve this.
> > * **Source**: `customer`
> > * **Step**: `payment_validation`

> [accordion] mandate\_cancelled
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment failed because emandate is cancelled or inactive
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Payment failed because emandate is cancelled or inactive
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] bank\_account\_validation\_failed
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment could not be completed due to a mismatch with the name of your bank account. Try again or contact your bank for details.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Validation
> >
> > * **Description**: Please check your debit card as it is not linked with the account number.
> > * **Source**: `customer`
> > * **Step**: `payment_validation`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment is declined due to a mismatch in account details. Try again with the account registered with the business only.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] card\_disabled\_for\_online\_payments
>
> * **Description**: Your payment could not be completed your card is not enabled for online payments. Try again with another account.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

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

> [accordion] card\_not\_allowed
>
> * **Description**: Your payment could not be completed as your debit card is blocked. Try again with another card.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] card\_number\_invalid
>
> * **Description**: Your payment could not be completed as the card number used is invalid. Try again with another card.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] debit\_instrument\_blocked
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not be completed as your bank account is blocked. Try another account or contact your bank for details.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed as debits are currently blocked on the customer's bank account.
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`

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

> [accordion] debit\_instrument\_inactive
>
> * **Description**: The payment could not be completed as the customer's bank account is inactive.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] payment\_failed
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Payment failed
> > * **Source**: `internal`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Payment failed
> > * **Source**: `internal`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your Mandate registration didn't go through as it was declined. Try another account or contact your bank for details.
> > * **Source**: `gateway`
> > * **Step**: `payment_authentication`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment didn't go through as it was declined. Try another account or contact your bank for details.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`

> [accordion] duplicate\_request
>
> * **Description**: Your eMandate registration is already in progress. Check the status in sometime.
> * **Source**: `customer`
> * **Step**: `payment_initiation`

> [accordion] input\_validation\_failed
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Something went wrong, please try again after sometime.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Validation
> >
> > * **Description**: The requested auth type is not supported by the selected bank for E-mandate payment
> > * **Source**: `business`
> > * **Step**: `payment_validation`
>
> > [accordion] Payment Validation
> >
> > * **Description**: Invalid bank passed for E-mandate payment
> > * **Source**: `customer`
> > * **Step**: `payment_validation`

> [accordion] transaction\_limit\_exceeded
>
> > [accordion] Payment Processing
> >
> > * **Description**: The payment could not be completed due to exceeds arrangement. Try again.
> > * **Source**: `internal`
> > * **Step**: `payment_processing`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed as the withdrawal limit for this account is exceeded.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] incorrect\_card\_expiry\_date
>
> * **Description**: Your payment was not successful as you have an invalid expiry date.To pay successfully try adding the right details
> * **Source**: `customer`
> * **Step**: `payment_authentication`

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

> [accordion] incorrect\_ifsc
>
> * **Description**: You've entered an incorrect IFSC code. Try again.
> * **Source**: `customer`
> * **Step**: `payment_initiation`

> [accordion] incorrect\_otp
>
> * **Description**: The OTP entered is invalid. Please check and enter the correct OTP.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] incorrect\_pin
>
> * **Description**: You've entered an incorrect PIN. Try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

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

> [accordion] invalid\_aadhar\_otp
>
> * **Description**: The Aadhaar OTP entered is invalid. Please check and enter the correct OTP.
> * **Source**: `gateway`
> * **Step**: `payment_authorization`

> [accordion] invalid\_amount
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed due to incorrect payment or account details.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Validation
> >
> > * **Description**: Payment amount exceeds the maximum amount allowed.
> > * **Source**: `business`
> > * **Step**: `payment_validation`

> [accordion] invalid\_bank\_account
>
> > [accordion] Payment Processing
> >
> > * **Description**: The account number entered does not exist. Please check and enter the correct account number.
> > * **Source**: `customer`
> > * **Step**: `payment_processing`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your Aadhaar number does not match your bank account details. Please verify and update your information.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] invalid\_mandate\_frequency
>
> * **Description**: The selected mandate frequency is invalid. Please choose a valid frequency.
> * **Source**: `customer`
> * **Step**: `payment_validation`

> [accordion] joint\_account\_not\_allowed
>
> * **Description**: Your eMandate registration could not be completed as it not available for joint accounts. Try again with another bank account.
> * **Source**: `customer`
> * **Step**: `payment_authorization`

> [accordion] mandate\_not\_active
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed as the registered eMandate is pending activation from the bank.
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: The payment could not be completed as the eMandate is not enabled by the bank.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`

> [accordion] mobile\_number\_invalid
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your mobile number is not updated with the bank. Please update your mobile number to receive OTP.
> > * **Source**: `customer`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your Aadhaar is not linked to a mobile number. Please update your mobile number with UIDAI.
> > * **Source**: `customer`
> > * **Step**: `payment_authentication`

> [accordion] otp\_expired
>
> * **Description**: Your Aadhaar OTP has expired. Please request a new OTP and try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] otp\_verification\_failed
>
> * **Description**: Aadhaar OTP verification failed. Please check the OTP and try again.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] payment\_pending\_approval
>
> * **Description**: Your payment is pending approval from the bank. We will notify the business once registration is complete.
> * **Source**: `bank`
> * **Step**: `payment_authorization`

> [accordion] payment\_risk\_check\_failed
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Processing
> >
> > * **Description**: This website isn't authorized to request payments from your account. To enable payments from website, please add it to your registered websites list.
> > * **Source**: `internal`
> > * **Step**: `payment_processing`

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

> [accordion] server\_error
>
> * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> * **Source**: `internal`
> * **Step**: `payment_authorization`

> [accordion] user\_not\_registered\_for\_netbanking
>
> * **Description**: Your account is not registered for net banking. Please register to continue.
> * **Source**: `customer`
> * **Step**: `payment_authentication`

> [accordion] invalid\_token
>
> * **Description**: Token not found. Please create a new mandate for the customer.
> * **Source**: `business`
> * **Step**: `payment_validation`

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

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

### Gateway Errors

> [accordion] bank\_technical\_error
>
> * **Description**: The payment could not be completed as the bank returned a rejection reason/namespace (xmlns) was missing/incorrect in its response. Try again in sometime.
> * **Source**: `bank`
> * **Step**: `payment_authorization`

> [accordion] duplicate\_request
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `gateway`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Duplicate Bank Response
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`

> [accordion] gateway\_technical\_error
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `gateway`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `bank`
> > * **Step**: `payment_authorization`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `gateway`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Initiation
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authentication
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `gateway`
> > * **Step**: `payment_authentication`
>
> > [accordion] Invalid Aadhaar Otp
> >
> > * **Description**: Aadhaar OTP verification could not be completed as no verification details were returned. Try again in sometime.
> > * **Source**: `gateway`
> > * **Step**: `invalid_aadhaar_otp`
>
> > [accordion] Payment Processing
> >
> > * **Description**: The payment could not be completed as the debit request is before the eMandate start date.
> > * **Source**: `gateway`
> > * **Step**: `payment_processing`

> [accordion] input\_validation\_failed
>
> * **Description**: The account holder name is missing or incorrect. Please verify and try again.
> * **Source**: `gateway`
> * **Step**: `payment_initiation`

> [accordion] payment\_declined
>
> * **Description**: The payment could not completed due to a temporary technical issue. Try again.
> * **Source**: `bank`
> * **Step**: `payment_authorization`

> [accordion] payment\_mandate\_not\_active
>
> * **Description**: The payment could not be completed as the debit request is before the eMandate start date.
> * **Source**: `gateway`
> * **Step**: `payment_authorization`

### Server Errors

> [accordion] server\_error
>
> > [accordion] Payment Initiation
> >
> > * **Description**: We are facing some trouble completing your request at the moment. Please try again shortly.
> > * **Source**: `internal`
> > * **Step**: `payment_initiation`
>
> > [accordion] Payment Authorization
> >
> > * **Description**: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
> > * **Source**: `internal`
> > * **Step**: `payment_authorization`

### Related Information

* [How Paper NACH Works](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/paper-nach/how-it-works.md)
* [Paper NACH Form](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/paper-nach/form.md)
* [Fetch and Manage Tokens](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/paper-nach/tokens.md)
* [Create Subsequent Payments](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/paper-nach/subsequent-payments.md)
* [FAQs](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/paper-nach/faqs.md)
