Subscription

A Subscription is an instance of a Plan Term on a specific Account. It carries the quantity, collection method, payment terms, and renewal cadence used to bill that account. Subscriptions auto-renew at next_renewal_date unless cancelled; planned modifications (quantity changes, terms switches, early renewals) are tracked as Subscription Changes.

Cancel a subscription

The POST /api/v1/subscriptions/{subscription_uuid}/cancel/ endpoint accepts a cancellation_type of full_refund, at_renewal, or today. Each option produces a different financial outcome — see the charging options docs for the resulting invoice/refund behavior of each type.

Create a subscription — warning

Do not use the POST /api/v1/subscriptions/ endpoint together with the Subscribe Account to Plan endpoint. The latter cancels every other subscription on the account, so combining them will silently delete subscriptions you just created.