Skip to main content
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

Given below is the list of Bad Request errors.
  • Description: Your payment could not be completed due to insufficient account balance. Try another card or payment method.
  • Source: customer
  • Step: payment_authorization
  • Description: The payment request failed as the predebit notification was not approved
  • Source: customer
  • Step: payment_authorization
  • Description: Payment was not completed on time.
  • Source: customer
  • Step: payment_authentication
  • Description: Payment was not completed on time.
  • Source: gateway
  • Step: payment_authorization
  • Description: Token is not confirmed for recurring payments
  • Source: business
  • Step: payment_initiation
  • Description: The payment request failed as the pre-debit notification was not sent to the customer
  • Source: issuer_bank
  • Step: pre_debit_notification_verify
  • Description: Payment debit notification failed to deliver to customer
  • Source: customer
  • Step: pre_debit_notification
  • 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
  • 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
  • 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
  • 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
  • Description: Your payment has been cancelled. Try again or complete the payment later.
  • Source: customer
  • Step: payment_authentication
  • Description: Token has expired and cannot be used for recurring payments
  • Source: business
  • Step: payment_initiation
  • Description: Card mandate is not active, it is paused by user
  • Source: customer
  • Step: payment_create_validation
  • Description: Card mandate is not active
  • Source: customer
  • Step: payment_create_validation
  • 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
  • Description: Your payment didn’t go through as it was declined due to potential risk. Try another payment method.
  • Source: internal
  • Step: payment_initiation
  • Description: Transaction not supported/blocked by issuer
  • Source: issuer_bank
  • Step: payment_authorization
  • Description: International cards are not supported. Please contact our support team for help
  • Source: business
  • Step: payment_initiation
  • 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
  • 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
  • Description: You’ve entered incorrect card details. Try again or retry the payment with another card or method.
  • Source: customer
  • Step: payment_authorization
  • Description: Your payment didn’t go through due to invalid card number or invalid expiry. Please try again.
  • Source: customer
  • Step: payment_authentication
  • Description: Your payment didn’t go through due to invalid card number or invalid expiry. Please try again.
  • Source: gateway
  • Step: payment_authorization
  • Description: Card mandate is not active, it is cancelled by user
  • Source: customer
  • Step: payment_create_validation
  • Description: You’ve reached the maximum transaction limit for this card. Try another payment method or contact your bank.
  • Source: customer
  • Step: payment_authorization
  • Description: This card is not eligible for recurring payments. Please use a different card.
  • Source: customer
  • Step: card_mandate_creation
  • 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
  • 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
  • Description: Payment was unsuccessful due to some issue with issuer bank. Please try again.
  • Source: issuer_bank
  • Step: payment_authentication
  • Description: You’ve entered an incorrect card number. Try again.
  • Source: customer
  • Step: payment_authentication
  • Description: You’ve entered an incorrect CVV number. Try again.
  • Source: customer
  • Step: payment_authorization
  • Description: Payment failed because Transaction amount limit has exceeded
  • Source: business
  • Step: payment_initiation
  • 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
  • Description: You’ve entered an incorrect expiration date. Try again.
  • Source: customer
  • Step: payment_authentication
  • Description: The payment failed as the predebit notification was approved by the customer after the predefined TAT
  • Source: customer
  • Step: payment_authorization
  • Description: Card BIN not supported for recurring payments
  • Source: issuer
  • Step: card_mandate_creation
  • Description: Your payment could not be completed as your card has expired. Try another payment method.
  • Source: customer
  • Step: payment_authentication
  • Description: Card mandate is not active, it is expired
  • Source: customer
  • Step: payment_create_validation
  • Description: We are facing some trouble completing your request at the moment. Please try again shortly.
  • Source: internal
  • Step: get_token
  • Description: customer opted out of the payment
  • Source: customer
  • Step: payment_authorization
  • Description: Debit date out of range
  • Source: business
  • Step: card_mandate_notification_creation
  • Description: Partner is not enabled for the merchant category
  • Source: business
  • Step: payment_initiation
  • Description: Payment failed
  • Source: customer
  • Step: payment_authentication
  • Description: The requested token has been deleted
  • Source: customer
  • Step: pre_debit_notification
  • Description: The token is invalid. Please use a valid token.
  • Source: service_provider
  • Step: get_token
  • 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
  • Description: You’ve entered an incorrect pin too many times. Try again in sometime.
  • Source: customer
  • Step: payment_authentication
  • Description: Payment processing failed because OTP validation attempts limit exceeded
  • Source: customer
  • Step: payment_authentication
  • Description: Mandate debit not as per frequency
  • Source: business
  • Step: payment_create_validation
  • Description: Payment failed because of invalid account
  • Source: customer
  • Step: payment_authentication
  • Description: You have entered an incorrect CVV number. Try again.
  • Source: customer
  • Step: payment_authentication
  • Description: Card mandate pre debit notification limit exceeded for today
  • Source: business
  • Step: card_mandate_notification_creation
  • 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.
  • Description: Your payment could not be completed due to insufficient account balance. Try another card or payment method.
  • Source: customer
  • Step: 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
  • 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
  • Description: Payment processing failed due to error at bank or wallet gateway
  • Source: gateway
  • Step: payment_authorization
  • 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
  • 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
  • Description: Your payment didn’t go through due to invalid card number or invalid expiry. Please try again.
  • Source: customer
  • Step: payment_authentication
  • 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
  • Description: Action cannot be performed as the payment-credential request for the token was declined
  • Source: gateway
  • Step: payment_authorization
  • 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
  • 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
  • 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
  • Description: Payment processing failed due to error at bank or wallet gateway
  • Source: bank
  • Step: payment_authorization
  • Description: Your payment could not be completed as the system took too long to respond. Please try again.
  • Source: gateway
  • Step: payment_authentication
  • 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.
  • Description: We are facing some trouble completing your request at the moment. Please try again shortly.
  • Source: internal
  • Step: payment_validate
  • Description: We are facing some trouble completing your request at the moment. Please try again shortly.
  • Source: internal
  • Step: 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: internal
  • Step: payment_initiation
  • Description: Payment was unsuccessful due to temporary issue. Please try again.
  • Source: gateway
  • Step: payment_authentication
  • Description: The server encountered an error. The incident has been reported to admins.
  • Source: internal
  • Step: payment_creation
Last modified on November 17, 2026