Subscriptions
Recurring payments on a gateway, renewed, failed and canceled on each subscription's own clock.
Try it in the demo.
A subscription charges a test card on a gateway every day, week, month or year. Nothing waits for real time: each subscription keeps its own clock, and Advance to renewal moves it to the next renewal and charges the card as a payment through the gateway, so your app receives the same notifications it gets from a real renewal.
What it solves
- Renewals take a month to test: advance the clock as often as you like, each advance is one renewal.
- Failed renewals are hard to reproduce: subscribe with a test card that declines, and the renewal fails and the subscription goes past due.
- Cancellation paths: cancel now, or at the end of the period, and see what your app receives.
How it connects
| Gets from | Sends to |
|---|---|
| a gateway and a test card from Methods | each renewal as a payment in Payments, with the gateway's notification |
subscription.created, subscription.renewed, subscription.payment_failed and subscription.canceled for webhook rules |
Use it
- Press New subscription, pick Stripe, enter
[email protected], keep the plan Pro at15.00USD every month, and press Start subscription. The first period is charged at once: the row shows Active and one renewal, and the payment is in Payments. - Open the row's menu and choose Advance to renewal. The period moves on a month and the card is charged again.
- Start another subscription with the test card
4000000000009995, which declines for insufficient funds. The first charge fails and the row shows Past due. - Choose Cancel at period end on the first one: it shows "Ends at period end", and the next advance ends it.
Everything on this screen
The table
The customer with the gateway and the card's last four digits, the plan with its amount and interval, the status (Trialing, Active, Past due or Canceled, with "Ends at period end" when cancelled at the period end), when the current period ends, and how many periods were paid. The row's menu offers Advance to renewal, Cancel at period end and Cancel now until the subscription is canceled.
New subscription
| Field | What it does |
|---|---|
| Gateway | the gateway the renewals are charged through |
| Interval | every day, week, month or year |
| Customer email | who pays |
| Plan name, Amount, Currency | what each renewal charges |
| Trial days | days before the first charge; 0 charges at once |
| Test card | the test card that pays each renewal; a real card number is refused |
Every control and text, one by one: Subscriptions in depth.
Customize
Write the renewal into a test: start a subscription with the API, advance it, and wait for the renewal's payment with sendmock payments wait.