> ## 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 Emandate recurring payments, categorised by error reason, with the description, source and step for each.

Available in
🇮🇳 India

Every failed payment or token operation carries `error.code`, `error.source`, `error.step` and `error.reason`. Use `error.reason` to identify the exact cause of the failure and decide the next action for your customer.

```json Sample Error Response theme={null}
{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "Authentication failed due to incorrect otp",
    "field": null,
    "source": "customer",
    "step": "payment_authentication",
    "reason": "invalid_otp",
    "metadata": {
      "payment_id": "pay_EDNBKIP31Y4jl8",
      "order_id": "order_DBJKIP31Y4jl8"
    }
  }
}
```

## Error Parameters

> [tab] Source Parameter
>
> The possible values for the `source` parameter for Emandate are listed below:
>
> * `customer`
> * `bank`
> * `business`
> * `internal`
> * `gateway`
> * `issuer_bank`

> [tab] Step Parameter
>
> The possible values for the `step` parameter, along with the description, are listed below:
>
> 1. `payment_initiation`\\
>
>    Your system initiates and sends the payment request to our server. Our server validates your request, creates the payment flow and forwards the request to the Gateway.
>
> 2. `payment_authentication`\\
>
>    The bank verifies the enrollment of the Emandate by asking customers to authenticate themselves.
>
> 3. `payment_authorization`\\
>
>    Once the customer has completed the authentication, the bank authorizes the release of the funds. The authorization status is communicated to the Gateway which in turn communicates the same to Razorpay.

## Error Reasons

Given below is the list of error codes categorised by error reasons, with relevant descriptions, source and step. Branch your handling on the 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

> [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 Emandate Recurring Works](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/emandate/how-it-works.md)
* [Create the Authorisation Transaction](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/emandate/authorization-transaction.md)
* [Fetch and Manage Tokens](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/emandate/tokens.md)
* [Create Subsequent Payments](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/emandate/subsequent-payments.md)
* [FAQs](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/emandate/faqs.md)
