Strata Docs

Stripe Payments

  1. Connect Stripe

    Go to Settings > Billing > Connect Stripe to begin the integration.

  2. Complete Stripe OAuth

    Authorise Strata in the Stripe OAuth flow. Once complete your Stripe account is linked and a connected account ID is stored.

  3. Enable test mode

    Flip the test mode toggle in Settings > Billing. All charges and webhooks will use Stripe test credentials until you disable this.

  4. Register the Strata webhook in Stripe

    In the Stripe Dashboard go to Developers > Webhooks and add the Strata webhook URL shown on your Settings > Billing page. Select at minimum: payment_intent.succeeded, payment_intent.payment_failed, invoice.paid, invoice.payment_failed.

  5. Create a Stripe Price for your first service

    In Stripe Dashboard go to Products, create a product, then add a Price. Copy the Price ID — you will paste it into Strata when configuring your first billable service.

Webhook URL format#

Strata generates a unique webhook endpoint per organisation. Use the URL below when adding the endpoint in your Stripe Dashboard.

Webhook URL format
https://app.strata.io/webhooks/stripe/{orgId}

Supported payment types#

NameTypeRequiredDescription
Fixedone-timeYesSingle charge on order creation.
SubscriptionrecurringNoMonthly or annual billing.
Usage-basedper-executionNoCharged per agent run.

How invoices map to Stripe charges#

Each Strata invoice creates a Stripe PaymentIntent. When the invoice moves to the paid state Strata confirms the PaymentIntent and records the Stripe charge ID against the invoice for reconciliation. For subscription plans Stripe generates the PaymentIntent automatically via its Invoice object; Strata listens for the invoice.paid webhook to mark the corresponding Strata invoice as settled.