Service Billing Integration Recipes

Stripe Integration

Services can be monetized using Stripe. To enable billing:

1. Configure STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET env vars
2. Create Products and Prices in Stripe Dashboard
3. Associate Stripe Price IDs when creating Plans
4. Use the Checkout endpoint to subscribe users

Organizations have service limits based on their tier. When a service is created, a default “Free” plan is automatically provisioned.

Provision a purchasable plan

1. Create the Stripe Product and Price in the Stripe Dashboard.
2. Create the AuthOS plan with that Price’s stripe_price_id.
3. Present the returned plan ID in your application’s plan picker.
4. Submit that plan ID with trusted success and cancel URLs to the checkout endpoint.
5. Confirm subscription state after Stripe redirects the browser.

Use the plan and checkout reference for request fields and response contracts. Do not treat the browser redirect alone as proof that a subscription was recorded.

Environment separation

Create separate services and Stripe test/live prices for development and production. Test OAuth callbacks and checkout redirects after changing a service, plan, domain, or Stripe configuration.