Subscriptions

Subscriptions let you charge customers on a recurring basis. Suby handles the full lifecycle, renewals, failed payment recovery, and cancellations, automatically.

​

How It Works

When a customer subscribes, Suby:

​

Use Cases

​

Billing Cycles

Suby supports any billing cycle, weekly, monthly, every 3 months, every 6 months, or yearly. You set it when creating your product.

​

Seats and licences

A subscription can hold several units · seats, licences, accounts. The plan’s price is the price of one unit: a licence at $10/month held three times bills $30/month.

• At checkout you set how many with quantity on the checkout session · or the customer picks it, within your bounds, if you turned on Customers choose the quantity on the plan (adjustableQuantity: true).
• Adding units is charged right away, prorated for what is left of the current period, on the subscription’s own card · the customer never re-enters it, though their bank may ask them to confirm, in which case they pay the difference on the checkout page and that card becomes the subscription’s. On a crypto subscription they pay the difference on the checkout page. The next renewals bill the new total.
• Removing units takes effect at the next renewal · the customer keeps what they already paid for until then, and the next cycle bills one unit less.
• A customer who already pays a lower price keeps that unit price when they add units, even if you raised the product’s price since.

You change the quantity from your own app with POST /v3/subscriptions/{id}/change-plan and quantity · price it first with change-plan/preview. With Customers choose the quantity turned on, customers can also change it themselves from their subscription page (the Manage subscription link in every receipt); it is off by default, so out of the box only your app does. Listen to subscription.updated: it fires when the new quantity takes effect, with quantity on the subscription. A license key granted by the product follows the quantity: its activation limit is the one you set, per unit. When units are removed, the most recently activated machines beyond the new limit are deactivated at the renewal.

​

Dunning

Each subscription renews on its own card: the one it was taken on, or the one the customer last set from its manage page · not whichever card they used most recently elsewhere. Access never lasts longer than the period that was paid for. If a card renewal is declined, access is revoked right away and Suby retries the charge over the next 3 days, notifying the customer to update their payment method. If a retry succeeds, access comes back automatically; if none does, the subscription ends. Crypto subscribers are reminded 48 hours before the due date (24 hours for plans shorter than a month). Without payment by the due date, access is revoked; the subscriber still has 2 days to renew the same subscription and get their access back.

​

Setting Up a Subscription

Setup works the same way as one-time payments, with one difference: you also select a billing interval.

​

Via API