Skip to content

Business onboarding flow

After a business is provisioned, the owner completes an onboarding wizard at /onboarding in portal-business. The wizard branches on billing type and collects payment details where required.

sequenceDiagram
    actor Owner
    participant PB as portal-business
    participant API as scheduler-api
    participant ST as Stripe

    Owner->>PB: accept invite / sign in (WorkOS)
    PB->>API: load onboarding state
    API-->>PB: steps + billing classification
    alt billing type requires a card
        Owner->>PB: enter card (shared AddCardForm)
        PB->>API: attach payment method
        API->>ST: create / update subscription
    else no card required
        PB->>PB: skip payment step
    end
    Owner->>PB: complete wizard
    PB->>API: mark onboarded
    API-->>PB: dashboard

The wizard shipped as a sequence of slices (capture → billing classification → owner reminders → owner /onboarding route). Background: the Billing concept and docs/business-onboarding-overview.md.