Bbizbasics/ developers
◆ Developer platform

Ship your product.
Skip the platform.

bizbasics is a B2B control plane — identity, billing, entitlements, and an app catalog. You bring the product; we handle sign-in, who-can-use-what, and getting paid. Wire it up in an afternoon.

Quickstart →API reference
# 1 · the browser already carries a signed access cookie (bb_at),
#     set by the platform on every *.bizbasics.ai at sign-in.

# 2 · verify it locally against the platform JWKS — no callback:
verifyRS256(bb_at, jwks("auth.bizbasics.ai/.well-known/jwks.json"))
# → { user_id, email, org_id, role, plan, apps, quotas, iss, exp }

# 3 · your slug in `apps`? sign them in. done — one local check, no login code.

# ── legacy, still supported: one-time ?token= handoff ──
#   GET https://your-product.com/auth/sso?token=…  then exchange it:
curl "$AUTH/api/v1/internal/verify-app-token?token=$T" -H "X-Internal-Key: $BBAS"
# → { user_id, email, full_name, org_id, role, app, is_platform_admin }
#   identity only — apps/plan come from bb_at or the catalog API, not here.

How it fits together

Customers sign in once. The control plane owns identity, billing, entitlements, and the catalog — and every product, ours or yours, plugs in over the same four contracts.

Your customersone sign-in · one billbizbasics control planeapi.bizbasics.aiIdentitySSO · sessionsBillingStripeEntitlementsplan · seats · appsCataloglauncherrelaychatmonkknowledge · RAGyour productbuilt by youEvery product speaks four contracts: SSO handoff · REST API + keys · Webhooks · Workspace records

Everything but your product

SSO, handled
Verify one short-lived signed cookie (bb_at) locally via JWKS. No login screens, no password storage, no per-request callback.
Billing & entitlements
Stripe is wired up. You receive role/plan/apps at SSO and query live usage via the API.
Workspace records
Publish a summary of any object; it shows up in search and recents across the whole suite.
Webhooks
Signed, retried lifecycle events — org, member, entitlement, sandbox changes.
Sandbox tenants
Throwaway orgs that bypass plan limits and auto-clean after 14 days. Perfect for demos.
Catalog & launcher
List in the bizbasics app catalog; customers launch you from one place with one identity.

Sign-in in one round-trip

The canonical path verifies the bb_at cookie locally against the platform JWKS — no callback, no shared secret. The diagram below shows the legacy one-time-token handoff (still supported, and what relay/monk use): the platform hands your product a one-time token, you exchange it server-to-server, then mint your own session.

Browseryour customerbizbasicsauth.bizbasics.aiYour product/auth/ssosign in at app.bizbasics.ai1redirect → /auth/sso?token=… (one-time)2verify-app-token · X-Internal-Key3{ user · org · role · plan · apps }4set own session cookie · render5
The full handshake — see the SSO contract.

Three steps to live

1Clone the scaffoldA Go + Gin starter that already implements the whole integration — SSO, bootstrap, health, and record publishing.2Implement the contractFour endpoints your product exposes. The scaffold gives you all four; the contract tests keep you honest.3Submit for reviewWe review, provision infra, and flip you live in the catalog. Usually 1–3 business days.

Build something.

Read the docs without an account. You only need to sign in to issue keys or submit an app.

Read the docs →Open console ↗
© bizbasics — developer platform