Native checkout docs

Build a checkout that settles cleanly.

Throttle gives your storefront a hosted payment surface, server-side checkout sessions, signed webhooks, native carts, and shipping/tax calculation.

Start the quickstart View API reference

1. Merchant backend Creates a checkout session with a secret API key.

2. Buyer browser Mounts the payment iframe and receives postMessage events.

3. Merchant webhook Receives signed durable payment and order events.

Choose Your Path

V1 focuses on native Throttle checkout and carts. Start with a payment-only embed, then add carts, shipping, tax, and webhooks as your integration grows. Building an app for other merchants to install rather than integrating your own store? That path starts with extensions.

Accept a payment

Create a session, mount the payment embed, and handle success.

Open guide

Embed checkout

Use PaymentEmbed, CheckoutEmbed, a raw iframe, or a hosted page.

Open guide

Manage native carts

Create carts, add items, calculate shipping/tax, and checkout.

Open guide

Listen to webhooks

Verify HMAC signatures and process events idempotently.

Open guide

Choose a package

Pick the right SDK or CLI for your integration surface.

Open guide

Browse endpoints

Use the curated reference, then jump to full OpenAPI when needed.

Open guide

Build an extension

Ship an app on the marketplace: scopes, identity, review, and launch.

Open guide

Canonical URLs

Examples use the branded Throttle URLs below. Keep these values on your backend unless the variable is explicitly prefixed for browser use.

Environment

THROTTLE_API_URL=https://api.usethrottle.dev
THROTTLE_CHECKOUT_URL=https://checkout.usethrottle.dev
THROTTLE_DASHBOARD_URL=https://app.usethrottle.dev