Subscriptions
Subscription statuses, renewals, failed renewals, and canceling, pausing or changing a plan on behalf of a customer.
Text description
A subscription starts Incomplete until the first payment or trial is confirmed, then becomes Trialing or Active. Active subscriptions renew each period. A failed renewal makes it Past due while the provider retries; a later success returns it to Active, otherwise it ends as Unpaid or Canceled. An active subscription can be Paused and resumed. Cancellation happens immediately or at the end of the paid period. A plan change waits as pending and takes effect at the next renewal.
What each provider supports#
| Action | Stripe | PayPal | Square | Authorize.net |
|---|---|---|---|---|
| Cancel at period end | yes | yes (billing stopped now, access kept) | yes | yes (billing stopped now, access kept) |
| Cancel now | yes | yes | — | yes |
| Pause / resume | yes | yes | yes | — |
| Change plan (same interval, next renewal) | yes | yes (buyer approves) | yes | yes |
| Retry a failed payment now | yes | yes | — (Square retries itself) | — |
Each action calls the provider first. The provider's webhook then moves the status, and the customer is emailed.
Renewals and failed renewals#
- A successful renewal creates a new payment with its own confirmation code.
- A failed renewal makes the subscription Past due. The customer keeps access for a 3-day grace period while the provider retries. After that, access pauses until a payment succeeds, or the subscription ends as Unpaid or Canceled, depending on the provider's retry settings.
- Plan changes requested by you or the customer wait as pending and take effect with the next renewal, without proration.
Where to find subscriptions#
On each customer's page, and in the subscriptions export (Exports). The Analytics screen shows MRR, active, trialing and past-due counts, and churn.