AEPS
Response codes
Canonical AEPS error codes with class and retry guidance. Showing 36 row(s). Every response also carries meta.trace_id.
| Canonical | Class | Message | Retry after |
|---|---|---|---|
BANK_EKYC_REQUIRED |
terminal | Registration is complete. Bank eKYC (OTP + fingerprint) is required before AEPS can run. | — |
BANK_ERROR |
retryable | Bank error. Please retry | 30 |
BAV_NOT_FOUND |
terminal | Unable to locate BAV for CDA | — |
BIOMETRIC_ERROR |
retryable | Biometric authentication failed (KW) | 15 |
CUTOVER_IN_PROGRESS |
retryable | Bank cutover in progress. Please retry | 60 |
DEEMED_ACCEPTANCE |
deemed_success | Deemed acceptance; awaiting bank confirmation | — |
DO_NOT_HONOUR |
terminal | Transaction declined by bank | — |
DUPLICATE_TRANSACTION |
terminal | Duplicate transaction | — |
EKYC_PENDING |
pending | eKYC is pending. Please complete merchant eKYC | — |
EXCEEDS_FREQUENCY_LIMIT |
terminal | Exceeds frequency limit | — |
EXCEEDS_WITHDRAWAL_LIMIT |
terminal | Exceeds withdrawal limit | — |
FAILURE |
terminal | Transaction failed | — |
FORMAT_ERROR |
terminal | Format error in request | — |
FROZEN_ACCOUNT |
terminal | Account is frozen | — |
INSUFFICIENT_FUNDS |
terminal | Insufficient funds in customer account | — |
INVALID_AMOUNT |
terminal | Invalid amount | — |
INVALID_MERCHANT |
terminal | Invalid merchant. Contact support | — |
INVALID_TRANSACTION |
terminal | Invalid transaction | — |
ISSUER_DECLINE |
terminal | Issuer decline (unspecified reason) | — |
ISSUER_INOPERATIVE |
retryable | Issuer is inoperative. Please retry later | 30 |
ISSUER_UNAVAILABLE |
retryable | Issuer / CBS unavailable. Please retry later | 30 |
NO_CHECKING_ACCOUNT |
terminal | No checking account | — |
NO_SAVINGS_ACCOUNT |
terminal | No savings account found | — |
PARSE_ERROR |
terminal | Unable to process provider response | — |
PENDING |
pending | Transaction is pending confirmation | 60 |
RESPONSE_TOO_LATE |
deemed_success | Response received too late; verifying with the bank | — |
REVERSAL_BY_ACQUIRER_TERMINAL |
terminal | Transaction reversed by acquirer terminal | — |
REVERSAL_NOT_ACKNOWLEDGED_ACQUIRER |
terminal | Reversal by acquirer not acknowledged by issuer | — |
REVERSAL_NOT_ACKNOWLEDGED_NPCI |
terminal | Reversal by NPCI not acknowledged by issuer | — |
ROUTING_ERROR |
retryable | Unable to route to bank. Please retry | 30 |
SUCCESS |
success | Transaction successful | — |
SUSPECTED_FRAUD |
terminal | Transaction declined — suspected fraud | — |
SYSTEM_MALFUNCTION |
retryable | Bank system malfunction. Please retry | 30 |
TWO_FA_REQUIRED |
needs_2fa | Daily 2FA authentication required | — |
VALIDATION_ERROR |
terminal | Onboarding validation error 5001 | — |
VERSION_NOT_SUPPORTED |
terminal | Version not supported by issuer | — |
Explain error (API)
POST /developer/aeps/explain-error with JSON raw_code.