Billing

Stripe-based subscription billing. Organisations start on a trial plan and upgrade via Stripe Checkout. Subscription lifecycle is managed through Stripe webhooks (see stripe-webhook.doc.ts).

Plans

Sole Trader — for unincorporated businesses
Limited Company — for Ltd companies

Trial

Early access (first 50 signups): 90-day trial. Standard: 30-day. Remaining trial days carry over when subscribing mid-trial.

Stripe integration

Customer creation happens at registration or first checkout
Checkout sessions redirect to Stripe for payment
Billing portal lets users manage payment methods and invoices
Webhook events drive plan updates (see stripe-webhook)

→ The Billing object

Endpoints

POST https://app.speybooks.com/api/v1/billing/checkout Create checkout session GET https://app.speybooks.com/api/v1/billing/plans List subscription plans POST https://app.speybooks.com/api/v1/billing/portal Create billing portal session GET https://app.speybooks.com/api/v1/billing/status Get billing status

Endpoints

POST /v1/billing/checkout GET /v1/billing/plans POST /v1/billing/portal GET /v1/billing/status

The Billing Object json

{
  "plan": "trial",
  "planName": "Trial",
  "hasStripeCustomer": true,
  "hasSubscription": false,
  "isTrialActive": true,
  "trialDaysRemaining": 72,
  "trialEndsAt": "2026-05-01T00:00:00.000Z",
  "subscription": null
}