Life Cycle

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

The figure below shows the States 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, Plural 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 FAILEDPlural's retries for debit execution fail twice, moving the subscription to this state.
HALTEDAfter exhausting all retry attempts by both the merchant and Plural, 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.