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 (46)
- Gateway Errors (11)
- Server Errors (2)
Bad Request Errors
Given below is the list of Bad Request errors.insufficient_funds
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
customer_action_required
customer_action_required
- Description: The payment request failed as the predebit notification was not approved
- Source:
customer - Step:
payment_authorization
payment_timed_out
payment_timed_out
Payment Authentication
Payment Authentication
- Description: Payment was not completed on time.
- Source:
customer - Step:
payment_authentication
token_not_eligible
token_not_eligible
- Description: Token is not confirmed for recurring payments
- Source:
business - Step:
payment_initiation
pre_debit_notification_failed
pre_debit_notification_failed
Pre Debit Notification Verify
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
Pre Debit Notification
Pre Debit Notification
- Description: Payment debit notification failed to deliver to customer
- Source:
customer - Step:
pre_debit_notification
card_declined
card_declined
Payment Initiation
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
Payment Authentication
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
debit_instrument_blocked
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
payment_cancelled
payment_cancelled
- Description: Your payment has been cancelled. Try again or complete the payment later.
- Source:
customer - Step:
payment_authentication
token_expired
token_expired
- Description: Token has expired and cannot be used for recurring payments
- Source:
business - Step:
payment_initiation
card_mandate_paused
card_mandate_paused
- Description: Card mandate is not active, it is paused by user
- Source:
customer - Step:
payment_create_validation
card_mandate_not_active
card_mandate_not_active
- Description: Card mandate is not active
- Source:
customer - Step:
payment_create_validation
payment_risk_check_failed
payment_risk_check_failed
Payment Initiation
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
issuer_declined
issuer_declined
- Description: Transaction not supported/blocked by issuer
- Source:
issuer_bank - Step:
payment_authorization
international_transaction_not_allowed
international_transaction_not_allowed
- Description: International cards are not supported. Please contact our support team for help
- Source:
business - Step:
payment_initiation
card_disabled_for_online_payments
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
debit_instrument_inactive
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
incorrect_card_details
incorrect_card_details
Payment Authentication
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
card_mandate_cancelled
card_mandate_cancelled
- Description: Card mandate is not active, it is cancelled by user
- Source:
customer - Step:
payment_create_validation
transaction_limit_exceeded
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
card_mandate_card_not_supported
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
authentication_failed
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
bank_technical_error
bank_technical_error
Payment Authentication
Payment Authentication
- Description: Payment was unsuccessful due to some issue with issuer bank. Please try again.
- Source:
issuer_bank - Step:
payment_authentication
card_number_invalid
card_number_invalid
- Description: You’ve entered an incorrect card number. Try again.
- Source:
customer - Step:
payment_authentication
incorrect_cvv
incorrect_cvv
- Description: You’ve entered an incorrect CVV number. Try again.
- Source:
customer - Step:
payment_authorization
transaction_amount_limit_exceeded
transaction_amount_limit_exceeded
- Description: Payment failed because Transaction amount limit has exceeded
- Source:
business - Step:
payment_initiation
declined_by_bank
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
incorrect_card_expiry_date
incorrect_card_expiry_date
- Description: You’ve entered an incorrect expiration date. Try again.
- Source:
customer - Step:
payment_authentication
request_timed_out
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
card_mandate_bin_not_supported
card_mandate_bin_not_supported
- Description: Card BIN not supported for recurring payments
- Source:
issuer - Step:
card_mandate_creation
card_expired
card_expired
- Description: Your payment could not be completed as your card has expired. Try another payment method.
- Source:
customer - Step:
payment_authentication
card_mandate_expired
card_mandate_expired
- Description: Card mandate is not active, it is expired
- Source:
customer - Step:
payment_create_validation
server_error
server_error
- Description: We are facing some trouble completing your request at the moment. Please try again shortly.
- Source:
internal - Step:
get_token
payment_declined
payment_declined
- Description: customer opted out of the payment
- Source:
customer - Step:
payment_authorization
card_mandate_notification_invalid_debit_date
card_mandate_notification_invalid_debit_date
- Description: Debit date out of range
- Source:
business - Step:
card_mandate_notification_creation
request_validation_failed
request_validation_failed
- Description: Partner is not enabled for the merchant category
- Source:
business - Step:
payment_initiation
incorrect_pin
incorrect_pin
- Description: Payment failed
- Source:
customer - Step:
payment_authentication
token_deleted
token_deleted
- Description: The requested token has been deleted
- Source:
customer - Step:
pre_debit_notification
invalid_token
invalid_token
- Description: The token is invalid. Please use a valid token.
- Source:
service_provider - Step:
get_token
transaction_daily_count_exceeded
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
pin_attempts_exceeded
pin_attempts_exceeded
- Description: You’ve entered an incorrect pin too many times. Try again in sometime.
- Source:
customer - Step:
payment_authentication
otp_attempts_exceeded
otp_attempts_exceeded
- Description: Payment processing failed because OTP validation attempts limit exceeded
- Source:
customer - Step:
payment_authentication
mandate_current_cycle_allowed_debit_exceeds
mandate_current_cycle_allowed_debit_exceeds
- Description: Mandate debit not as per frequency
- Source:
business - Step:
payment_create_validation
bank_account_invalid
bank_account_invalid
- Description: Payment failed because of invalid account
- Source:
customer - Step:
payment_authentication
card_cvv_invalid
card_cvv_invalid
- Description: You have entered an incorrect CVV number. Try again.
- Source:
customer - Step:
payment_authentication
card_mandate_notification_limit_exceeded
card_mandate_notification_limit_exceeded
- Description: Card mandate pre debit notification limit exceeded for today
- Source:
business - Step:
card_mandate_notification_creation
card_not_enrolled
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.insufficient_funds
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
card_not_enrolled
card_not_enrolled
Card Enrollment Check
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
gateway_technical_error
gateway_technical_error
Payment Request
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
incorrect_card_details
incorrect_card_details
Payment Authentication
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
card_declined
card_declined
bank_technical_error
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
authentication_failed
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
server_error
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
card_restricted
card_restricted
- Description: Payment processing failed due to error at bank or wallet gateway
- Source:
bank - Step:
payment_authorization
payment_timed_out
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
bin_disabled
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.server_error
server_error
Payment Validate
Payment Validate
- Description: We are facing some trouble completing your request at the moment. Please try again shortly.
- Source:
internal - Step:
payment_validate
Payment Initiation
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
Payment Authentication
Payment Authentication
- Description: Payment was unsuccessful due to temporary issue. Please try again.
- Source:
gateway - Step:
payment_authentication
internal
internal
- Description: The server encountered an error. The incident has been reported to admins.
- Source:
internal - Step:
payment_creation