Flow Overview
| Phase | What happens |
|---|---|
| Create | You create a subscription with a billing plan and payment method; Revolv3 may charge the first period immediately or after a trial. |
| Renew | On each billing date, Revolv3 creates an invoice and attempts to charge the stored payment method. Retries (“recycling”) apply if the attempt fails. |
| Cancel | You or the customer cancels; the subscription stops at the end of the current period or immediately, depending on your request. |
Sequence: Create Subscription
When to use: New recurring billing (SaaS, memberships, recurring services). See Create a Subscription for the full request body and Billing Plans for plan structure.Sequence: Renew (Recurring Charge)
Revolv3 handles scheduling and retries; you consume webhooks (e.g.InvoicePaid, InvoiceFailed) and/or poll subscription and invoice status. See Subscription Status and Recycling for retry behavior, soft vs hard decline, and multiple payment methods.
Sequence: Cancel
Cancellation can be “at end of period” or “immediately,” depending on the API and your call. See Canceling a Subscription for options and behavior.Sample Create Request (summary)
- Endpoint:
POST /api/subscriptions(use your environment base URL, e.g.https://api-sandbox.revolv3.comfor sandbox). - Body: Billing plan (or plan id), payment method(s), optional customer id, optional trial.
- Response: Subscription id, status, next billing date.
Where to Go Next
- Create a Subscription — Full create request and field reference
- Subscription Billing Plans — Plans, cycles, and value types
- Subscription Status and Recycling — Statuses, retries, and soft/hard declines
- Canceling a Subscription — How and when cancellation takes effect