A subscription is created when a customer is subscribed to a Product Plan. The subscription is a complete copy of the current Product Plan with all the Product Plan Charges referencing prices, billing cycles and the default quantities.

The subscription holds the state of the billing cycle, including the term of the subscription and the advancement in billing.

  • A subscription can be termed, in the sense of having a start and an end-date. A termed subscription can renew and be set to automatically renew upon the anchor of the renewal. A termed subscription will have both properties set.
  • A subscription can also be an evergreen, in the sense that there is no end-date assigned to the subscription. An evergreen subscription does not have any renewal, they simply run until they are cancelled.

Stages of a subscription.

ActiveSubscription is active and charges are being processed on each cycle.Active (1)Active (0)
Inactive (draft)Subscription is being created and edited. No processing is done.Inactive (7)Draft (5)
On holdSubscription is active, though not processed on next cycle. Subscription can be reactivated at a later time. Upon this time, existing (holding charges) can either be discarded or processed in bulk.Inactive (7)Hold (8)
CancelledSubscription has been actively cancelled by a user or the API.Inactive (7)Cancelled (4)
Pending cancellationSubscription has been actively cancelled by a user or the API, and will cancel at next renewal. Intermediate charges will be processed.Active (1)PendingEnding (6)
EndedSubscription has ended its lifecycle, and terminated without manual cancellation.Inactive (7)Ended (7)


A subscription has a reference field called Subscription.SubscriptionReference which will always be transfered to all invoices coming from this particular subscription. This is the field typically used to store a Purchase Order Number (PO-number) or other unique identifies that need to go on the invoice.

If you want this on your invoice PDF you can include it using the handlebar {{invoice.InvoiceReference}} see Merging e-mail content.


We're always happy to help with code or other questions you might have! Search our documentation or contact helpdesk. You can also chat live with us using the Intercom icon.

What’s Next

A Subscription consists of Subscription Charges, which are the underlying recurring charges. Or maybe you want to review the Subscription Object and Subscription Endpoints.