Managing subscriptions

After a subscription is created, you control renewals from Dashboard → Subscriptions or via the API: cancel, undo a pending cancel, pause collection, resume, and extend the current period with free days.

Cancel

At period end (default) keeps access until current_period_end, then moves the subscription to canceled. The customer is not charged again.

Immediate cancels now and revokes ongoing billing. Use this when access should stop right away.

If the customer changes their mind before the period ends, use Undo cancel (uncancel) to clear the pending cancellation flag.

Pause and resume

Pausing stops future renewal charges while you can choose to keep the customer's access. Optionally void outstanding past-due invoices so recovery does not continue collecting. Resume restores billing on the normal schedule.

You may schedule an automatic resume time when pausing; otherwise the subscription stays paused until you resume manually.

Add free days

Comp the customer by extending the current billing period (1–1095 days). The next renewal date moves forward. Useful for outages, goodwill, or referral rewards. Free days can also be used as a simple proration credit when changing plans.

Billing sync

Live subscriptions show a linked badge once Rollo has attached the underlying membership from payment webhooks. Pause, cancel, resume, and free-day actions then sync to recurring billing. Sandbox subscriptions are always linked locally.

Webhooks

Listen for subscription.updated, subscription.canceled, subscription.paused, and subscription.resumed to sync access in your product.

POST /v1/subscriptions/sub_.../cancel
{ "mode": "at_period_end" }

POST /v1/subscriptions/sub_.../pause
{ "void_outstanding": true }

POST /v1/subscriptions/sub_.../add_free_days
{ "free_days": 7 }