Billing
Stripe-based subscription billing. Stripe is the system of record for subscription state; this resource reads that state and exposes the entry points an organisation uses to subscribe and to manage its subscription. The webhook handler is the single writer of the local mirror (see the Stripe webhook resource); these endpoints never write subscription status.
An organisation starts cardless. Registration grants a 7-day cardless grace window: time to reach Checkout, not the trial. The trial starts at Checkout, where the card is captured (GBP 0 due that day): 90 days while founder seats remain (the first 50 organisations to subscribe), 30 days thereafter. The full entitlement is granted regardless of how many grace days were consumed; converting early never shortens the offer. There is one trial per organisation, ever: a re-subscriber goes straight to billing with no trial. Lapsed grace does not forfeit the offer: Checkout remains available and the full trial starts whenever it completes.
Two paid plans are available:
- Sole Trader: for unincorporated businesses
- Limited Company: for limited companies
The billing-page state machine (grace, trial, active, cancellation,
payment failure, suspension, retention) is governed by
DESIGN-BILLING-LIFECYCLE v1.4 section 6 and surfaced through the
precomputed variant on the status response.
Endpoints
https://app.speybooks.com/api/v1/billing/checkoutCreate checkout sessionGEThttps://app.speybooks.com/api/v1/billing/invoicesList recent invoicesGEThttps://app.speybooks.com/api/v1/billing/plansList subscription plansPOSThttps://app.speybooks.com/api/v1/billing/portalCreate billing portal sessionGEThttps://app.speybooks.com/api/v1/billing/statusGet billing status