Order and Transaction Lifecycle

This page helps you understand the order lifecycle at Cashfree.

When you create an order at Cashfree Payments, there are various states that this order may go through before reaching your account. The various states help you understand the status of the order and the payment associated with it.

Order and Payment LifecycleOrder and Payment Lifecycle

Order and Payment Lifecycle

Order State Details

Order State

Description

ACTIVE

Orders are marked as ACTIVE, when an order is created by the merchant through an API request to Cashfree Payments.

PAID

Orders are marked PAID when the payment is verified by Cashfree Payments and the payment is successful.

EXPIRED

Orders are marked as EXPIRED when the order has exceeded order_expiry_time specified by merchant to complete the order.

Payment State Details

Customers can try to make multiple payments for orders at Cashfree. Every new payment attempt leads to a new payment attempt in our system. These payments follow their own lifecycle at Cashfree Payments.

Payment State

Description

SUCCESS

Transactions are marked as SUCCESS when we get a successful response from the bank, and we can capture the amount in our system.

Once payment is marked as SUCCESS, we mark the order as PAID.

FAILED

Transactions are marked as FAILED when we get a failed response from the bank.

NOT_ATTEMPTED

Transactions are marked as NOT_ATTEMPTED initially when a transaction is created and an acknowledgement is awaited from the bank.

PENDING

Transactions are marked as PENDING when we have successfully sent the request to the bank but waiting for a response from the bank.

FLAGGED

Transactions are marked as FLAGGED if we have identified any risks associated with the transaction.

CANCELLED

Transactions are marked as CANCELLED when there is success response post time to live. In this case, the amount will be reversed to the customer without any charge being levied to them or the merchant.

VOID

Transactions are marked as VOID when we do not want to capture the transaction amount. This is only applicable for card-based pre-authorized transactions or to UPI one-time mandates.
The amount is reversed immediately in these cases by Cashfree Payments.

USER_DROPPED

Transactions are marked as USER_DROPPED when customers drop out of the payment flow without completing the transaction. It will help you understand if customers attempted to pay or not.

Some common scenarios where the transaction will be marked as USER_DROPPED are:

  • Android UPI Intent Payments - when a user clicks on the back button in the UPI app without making any payment attempt.
  • Card Payments - when a user drops out of the payment flow by closing the OTP verification page.
  • UPI Collect Transactions - when a user does not enter the UPI PIN and closes the transaction screen

Did this page help you?