Lifecycle
When you create a Cashgram there are various states that the Cashgram goes through before the user redeems the Cashgram to his account. The various states help you understand the status of Cashgram.
A state is final if it does not allow transitioning to any other state within the lifecycle.
The various states in the Cashgram lifecycle are as below:
- Active
- Expired
- Pending
- Failed
- Redeemed
- Reversed
Active
When a new Cashgram has been created it is in the Active state. A Cashgram is active for a maximum of 30 days from the date of creation or the date specified by you during the creation.
The Active state can transition into:
- Redeemed state, if the customer successfully redeems the Cashgram.
- Expired state, if the Cashgram is no longer active.
Expired
When the Cashgram is no longer active, the Cashgram is in the Expired state. Expired is a final state and does not allow transitioning to any other state.
A Cashgram can indicate the Expired state due to various reasons, such as:
- The Cashgram link has not been accessed within the specified time.
- The OTP verification is successful and the Cashgram is not redeemed.
Pending
When the transfer status is yet to be confirmed, the Cashgram is in the Pending state. At this point, the partner bank could be processing the payout, and no further action is required from your end.
The Pending state can transition into:
- Redeemed state, if the Cashgram is successfully redeemed.
- Failed state, if the Cashgram could not be redeemed.
Failed
When the transfer fails, the Cashgram is in the Failed state. Failed is a final state and does not allow transitioning to any other state.
A Cashgram can indicate the Failed state due to various reasons, such as:
- The beneficiary account details are incorrect.
- Insufficient balance in your Payouts recharge account. To avoid this, you can specify the balance in the Low Balance Alert section, if the balance goes below the amount specified, Cashfree will send you a notification.
- Partner or beneficiary bank servers are down.
Redeemed
When the transfer is successfully processed, the Cashgram is in the Redeemed state.
In certain cases, the Redeemed state may transition into the Reversed state if the transfer is reversed by the beneficiary bank.
Reversed
A Cashgram can be in the Reversed state if the transfer is reversed by the clearing house or beneficiary bank.
Reversed is a final state and does not allow transitioning to any other state. Cashfree credits the original amount to your Payouts account.
You can see the status of the Cashgrams on the Payouts Dashboard, or you can use the API Get Cashgram Status to know the status.
Updated 10 months ago