Life Cycle

Plan Life Cycle

The figure below shows the life cycle of the Plan.

The table below list the various statuses that our Plans can have during its life cycle.

Status	Description
CREATED	When the Create Plan request is successfully created with a future start date.
ACTIVE	When the plan is activated, i.e., when the scheduled start date and time are reached.
INACTIVE	When the plan has expired.

Subscription [Mandate Registration] Life Cycle

The figure below shows the life cycle of the Subscription.

The table below list the various statuses that our Subscription can have during its Mandate registration life cycle.

Status	Description
CREATED	When the Create Subscription request is successfully received by Pine Labs Online.
EXPIRED	This state occurs when no response is received from the partner bank for the create subscription request within `4` hours.
INACTIVE	The mandate creation fails due to a failure response from the acquirer.
TRIAL	This state occurs when the mandate is successfully created by your customer. Note: Subscription billing will begin once the trial period ends. After the trial period, the mandate will transition to the `ACTIVE` state.
ACTIVE	Subscription is in an active state and can be presented to the customer.
PAUSED	This state occurs when the subscription is temporarily paused, and billing is currently on hold.
RESUMED	The subscription transitions to this state when either the merchant or the customer resumes it from a `PAUSED` or `HALTED` status.
UPDATING	This status occurs when the subscription details are requested for modification. Note: Once the customer provides consent, the subscription modification request will be processed, and the subscription will return to the `ACTIVE` state.
DEBIT FAILED	The subscription enters this state if the first debit execution request fails and the customer cannot be charged on the initial attempt for a billing cycle.
HALTED	After exhausting all retry attempts by both the merchant and Pine Labs Online, the subscription enters the `HALTED` state. No further actions can be performed while subscription remains in this state.
CANCELLED	The subscription is successfully cancelled after receiving a callback confirmation from the bank.
COMPLETED	Upon reaching the subscription's end period, the mandate transitions to this final state.

Presentation Life Cycle

The Presentation Life Cycle consists of two distinct flow types:

Pre Debit Notification Flow

The figure below shows the life cycle of the Pre Debit Notification flow of Presentation.

The table below list the various states of a Presentation.

Status	Description
CREATED	When we have received the Subscription Notification request successfully.
PENDING	When we successfully initiate a Pre-debit Notification.
PAUSED	When the subscription is Paused.
CANCELLED	When the subscription is Cancelled.
NOTIFIED	When the notification is delivered successfully.
FAILED	Pre-Debit Notification is unsuccessful, the system automatically retries delivery up to 10 times before marking it as Failed.
PDN FAILED	Pre-Debit Notification has failed after all internal retries for a subscription.

Customer Debit Flow

The figure below shows the life cycle of the Customer Debit flow of Presentation.

The table below list the various states of a Presentation.

Status	Description
CREATED	When the create presentation request is successfully received by Pine Labs Online. Note: You need to use our Presentation API only if notification is handled by Pine Labs Online.
PENDING	When we successfully initiate a Pre-debit Notification.
PAUSED	When the subscription is Paused.
CANCELLED	When the subscription is Cancelled.
FAILED	Pre-Debit Notification or customer debit fails, the system will attempt up to three retries—initiated either by the merchant or Pine Labs. After three unsuccessful attempts, the subscription status changes to `HALTED`. The merchant can then send a new notification and debit request. Once the debit is successful, the subscription returns to the `ACTIVE` state.
COMPLETED	When the debit is successful.