Skip to content

Developer portal

Billing and onboarding guide

Combine Stripe lifecycle events with public onboarding tokens to provision tenants safely.

Last updated: 2026-06-09

Self-serve monitor signup flow

  1. Capture lead intent: POST /public/monitor-signup
  2. Provision starter profile: POST /public/monitor-provision
  3. Finalize tenant and key issuance in admin workflows.

Stripe lifecycle synchronization

Stripe events should be delivered to POST /public/stripe-webhook and validated with Stripe-Signature. For customer self-service billing updates, expose POST /tenant/billing/portal from authenticated tenant context.

Onboarding token bootstrap

Validate invite tokens via GET /public/onboarding-key/{token}, then mint tenant keys through admin issuance endpoints once user identity and entitlement checks pass.

Audit and support handoff

Store webhook event ids and token redemption records in tenant audit trails so billing disputes and onboarding incidents can be resolved from immutable evidence.