Life Cycle

Learn about the list of states of a Subscription and their significance.

The figure below shows the life cycle of the Subscription.

Figure: Subscription Status

Figure: Subscription Life Cycle


Subscription States

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

StatusDescription
MANDATE REGISTRATIONAuthorizes automatic recurring payments for a subscription.
CREATEDSubscription is created after receiving approval from the end-user.
EXPIREDThe subscription moves to this state if no callback is received from the bank after mandate creation.
TRIALSubscription starts in a trial state; after mandate approval, it transitions to this state.
INACTIVEThe mandate creation fails due to a failure response from the bank.
ACTIVESubscription is in an active state and can be presented to the customer.
DEBIT SCHEDULEDDebit is scheduled. Only applicable when debit date is more than 48hrs from current timestamp.

Note: If the initial debit attempt fails, Pine Labs Online will automatically retry the transaction. If all retry attempts are exhausted without a successful debit, the status will change to 'Debit Failed.' The process will then resume.
DEBIT FAILEDPine Labs Online retries for debit execution fail twice, moving the subscription to this state.
HALTEDAfter 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 in this state.
RESUMINGIntermediate stage where a subscription transitions from PAUSED or HALTED to RESUMED.
RESUMEDThe subscription transitions to this state when either the merchant or the customer resumes it from a PAUSED or HALTED status.
REVOKE INTIATEDThe merchant or customer initiates the cancellation of the mandate.
CANCELLEDThe subscription is successfully cancelled after receiving a callback confirmation from the bank.
COMPLETEDUpon reaching the subscription's end period, the mandate transitions to this final state.

Ask AI
Assistant
Hourly Limit
0 / 20000 tokens used Resets in: 60m 0s
Order Lifecycle
Refunds
Settlements
Checkout
Dashboard
International Payments
How do I implement webhook notifications for payment status updates, and what's the recommended way to verify webhook authenticity?
How do I integrate Pine Labs payment gateway with my React Native mobile app and what are the required API credentials?
Can I customize the payment UI for card transactions, and what parameters can I pass to modify the checkout experience for my customers?
Assistant