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 (41)
- Gateway Errors (6)
- Server Errors (1)
Bad Request Errors
Given below is the list of Bad Request errors.already_declined
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
authentication_failed
authentication_failed
Payment Authentication
Payment Authentication
- Description: Your payment could not be completed due to incorrect account details. Try again.
- Source:
customer - Step:
payment_authentication
Payment Initiation
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
instrument_blocked
instrument_blocked
Payment Authentication
Payment Authentication
- Description: The Customer ID entered does not match bank records. Please check and try again.
- Source:
customer - Step:
payment_authentication
payment_cancelled
payment_cancelled
Payment Processing
Payment Processing
- Description: Payment processing cancelled by user
- Source:
customer - Step:
payment_processing
Payment Authentication
Payment Authentication
- Description: Your payment has been cancelled. Try again or complete the payment later.
- Source:
customer - Step:
payment_authentication
bank_account_invalid
bank_account_invalid
Payment Processing
Payment Processing
- Description: The payment could not be completed as the customer’s bank account is closed or blocked.
- Source:
customer - Step:
payment_processing
Payment Authentication
Payment Authentication
- Description: Payment failed because of invalid account
- Source:
customer - Step:
payment_authentication
Payment Validation
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
mandate_cancelled
mandate_cancelled
Payment Authentication
Payment Authentication
- Description: Payment failed because emandate is cancelled or inactive
- Source:
customer - Step:
payment_authentication
bank_account_validation_failed
bank_account_validation_failed
Payment Authentication
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
Payment Validation
Payment Validation
- Description: Please check your debit card as it is not linked with the account number.
- Source:
customer - Step:
payment_validation
card_disabled_for_online_payments
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
card_expired
card_expired
- Description: Your payment could not be completed your card has expired. Try again with another account.
- Source:
customer - Step:
payment_authentication
card_not_allowed
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
card_number_invalid
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
debit_instrument_blocked
debit_instrument_blocked
otp_attempts_exceeded
otp_attempts_exceeded
- Description: Payment processing failed because OTP validation attempts limit exceeded
- Source:
customer - Step:
payment_authentication
debit_instrument_inactive
debit_instrument_inactive
- Description: The payment could not be completed as the customer’s bank account is inactive.
- Source:
customer - Step:
payment_authorization
payment_failed
payment_failed
Payment Authentication
Payment Authentication
- Description: Payment failed
- Source:
internal - Step:
payment_authentication
Payment Authentication
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
duplicate_request
duplicate_request
- Description: Your eMandate registration is already in progress. Check the status in sometime.
- Source:
customer - Step:
payment_initiation
input_validation_failed
input_validation_failed
Payment Initiation
Payment Initiation
- Description: Something went wrong, please try again after sometime.
- Source:
internal - Step:
payment_initiation
Payment Validation
Payment Validation
- Description: The requested auth type is not supported by the selected bank for E-mandate payment
- Source:
business - Step:
payment_validation
Payment Validation
Payment Validation
- Description: Invalid bank passed for E-mandate payment
- Source:
customer - Step:
payment_validation
transaction_limit_exceeded
transaction_limit_exceeded
Payment Processing
Payment Processing
- Description: The payment could not be completed due to exceeds arrangement. Try again.
- Source:
internal - Step:
payment_processing
Payment Initiation
Payment Initiation
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
internal - Step:
payment_initiation
incorrect_card_expiry_date
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
incorrect_cvv
incorrect_cvv
- Description: You’ve entered an incorrect CVV. Try again.
- Source:
customer - Step:
payment_authentication
incorrect_ifsc
incorrect_ifsc
- Description: You’ve entered an incorrect IFSC code. Try again.
- Source:
customer - Step:
payment_initiation
incorrect_otp
incorrect_otp
- Description: The OTP entered is invalid. Please check and enter the correct OTP.
- Source:
customer - Step:
payment_authentication
incorrect_pin
incorrect_pin
- Description: You’ve entered an incorrect PIN. Try again.
- Source:
customer - Step:
payment_authentication
insufficient_funds
insufficient_funds
- Description: Your payment could not be completed due to insufficient account balance. Try again with another account.
- Source:
customer - Step:
payment_authorization
invalid_aadhar_otp
invalid_aadhar_otp
- Description: The Aadhaar OTP entered is invalid. Please check and enter the correct OTP.
- Source:
gateway - Step:
payment_authorization
invalid_amount
invalid_amount
Payment Validation
Payment Validation
- Description: Payment amount exceeds the maximum amount allowed.
- Source:
business - Step:
payment_validation
invalid_bank_account
invalid_bank_account
Payment Processing
Payment Processing
- Description: The account number entered does not exist. Please check and enter the correct account number.
- Source:
customer - Step:
payment_processing
invalid_mandate_frequency
invalid_mandate_frequency
- Description: The selected mandate frequency is invalid. Please choose a valid frequency.
- Source:
customer - Step:
payment_validation
joint_account_not_allowed
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
mandate_not_active
mandate_not_active
mobile_number_invalid
mobile_number_invalid
Payment Authentication
Payment Authentication
- Description: Your Aadhaar is not linked to a mobile number. Please update your mobile number with UIDAI.
- Source:
customer - Step:
payment_authentication
otp_expired
otp_expired
- Description: Your Aadhaar OTP has expired. Please request a new OTP and try again.
- Source:
customer - Step:
payment_authentication
otp_verification_failed
otp_verification_failed
- Description: Aadhaar OTP verification failed. Please check the OTP and try again.
- Source:
customer - Step:
payment_authentication
payment_pending_approval
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
payment_risk_check_failed
payment_risk_check_failed
Payment Initiation
Payment Initiation
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
internal - Step:
payment_initiation
Payment Processing
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
payment_timed_out
payment_timed_out
- Description: Payment was not completed on time.
- Source:
customer - Step:
payment_authentication
server_error
server_error
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
internal - Step:
payment_authorization
user_not_registered_for_netbanking
user_not_registered_for_netbanking
- Description: Your account is not registered for net banking. Please register to continue.
- Source:
customer - Step:
payment_authentication
invalid_token
invalid_token
- Description: Token not found. Please create a new mandate for the customer.
- Source:
business - Step:
payment_validation
token_expired
token_expired
- Description: Token has expired and cannot be used for recurring payments
- Source:
business - Step:
payment_initiation
token_not_eligible
token_not_eligible
- Description: Token is not confirmed for recurring payments
- Source:
business - Step:
payment_initiation
Gateway Errors
bank_technical_error
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
duplicate_request
duplicate_request
Payment Initiation
Payment Initiation
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
gateway - Step:
payment_initiation
gateway_technical_error
gateway_technical_error
Payment Initiation
Payment Initiation
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
gateway - Step:
payment_initiation
Payment Initiation
Payment Initiation
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
internal - Step:
payment_initiation
Payment Authentication
Payment Authentication
- Description: Your payment could not be completed due to a temporary technical issue. Try again in sometime.
- Source:
gateway - Step:
payment_authentication
Invalid Aadhaar Otp
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
Payment Processing
Payment Processing
- Description: The payment could not be completed as the debit request is before the eMandate start date.
- Source:
gateway - Step:
payment_processing
input_validation_failed
input_validation_failed
- Description: The account holder name is missing or incorrect. Please verify and try again.
- Source:
gateway - Step:
payment_initiation
payment_declined
payment_declined
- Description: The payment could not completed due to a temporary technical issue. Try again.
- Source:
bank - Step:
payment_authorization
payment_mandate_not_active
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
server_error
server_error
Payment Initiation
Payment Initiation
- Description: We are facing some trouble completing your request at the moment. Please try again shortly.
- Source:
internal - Step:
payment_initiation