status and status_code values returned by the Debit Wallet API and Verify Debit Wallet API, and configure your debit flow accordingly.
Status and status-code reference
The following table describes all possiblestatus and status_code combinations returned by debit APIs, along with recommended actions for each scenario.
Debit transaction statuses
Statuses are organised by transaction state. Each state contains specific status codes that indicate the current progress and required actions.PENDING - Debit in progress
PENDING - Debit in progress
| Status code | Description | Recommended action |
|---|---|---|
PENDING | Cashfree received the debit request and is processing it. | Wait for a terminal status or poll using the debit response |
OTP_GENERATED | Cashfree sent an OTP to the user for debit authorisation. | Call the Verify Debit Wallet API with the debit_id and OTP |
LAST_OTP_ATTEMPT_FAILED | The OTP verification attempt failed, but retries remain. | Prompt the user to re-enter the OTP and call the Verify Debit Wallet API again |
SUCCESS - Debit completed
SUCCESS - Debit completed
| Status code | Description | Recommended action |
|---|---|---|
SUCCESS | The debit completed successfully. | Proceed with order fulfilment or downstream processing |
FAILED - Debit failed
FAILED - Debit failed
| Status code | Description | Recommended action |
|---|---|---|
OTP_GENERATION_FAILED | Cashfree could not generate the OTP for the debit. | Retry the debit or verify notification channel configuration |
OTP_VERIFICATION_FAILED | The OTP verification failed. | Initiate a new debit if required |
OTP_EXPIRED | The OTP has expired. | Initiate a new debit |
OTP_VERIFICATION_ATTEMPT_EXHAUSTED | The maximum OTP verification attempts were exceeded. | Initiate a new debit |
FAILED | The debit failed. | Review the failure reason and retry if applicable |
REJECTED - Debit rejected
REJECTED - Debit rejected
| Status code | Description | Recommended action |
|---|---|---|
REJECTED | Cashfree rejected the debit. | Review the rejection reason before retrying |
INSUFFICIENT_BALANCE | The sub-wallet does not have sufficient balance for the debit. | Ask the user to top up the wallet or reduce the debit amount |
REVERSED - Debit reversed
REVERSED - Debit reversed
| Status code | Description | Recommended action |
|---|---|---|
REVERSED | Cashfree reversed the debit. | Update order or balance records accordingly |