Payment providers

Stripe is configured from the Payment Providers settings section.

The app expects the provider record to include:

• a provider name,
• a secret key,
• a publishable key,
• and the currencies it should support.

Validation rules

• sk_test_... and pk_test_... indicate test mode.
• sk_live_... and pk_live_... indicate live mode.
• Keys that do not match the prefix pattern should be rejected before save.

Routes to know

• POST /api/stripe/connect/init
• POST /api/billing/create-checkout-session
• POST /api/invoices/[invoiceId]/create-checkout
• POST /api/invoices/[invoiceId]/create-payment-intent

What to explain in the docs

• where the keys are entered,
• whether the provider lives at company or workspace scope,
• which currency the customer sees,
• and how to tell test mode from live mode.

If a payment workflow fails, the first thing to check is whether the provider is saved with the expected prefix and the expected currency set.