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 backendCreates a checkout session with a secret API key.

2. Buyer browserMounts the payment iframe and receives postMessage events.

3. Merchant webhookReceives 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.

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

Canonical URLs

Examples use the branded production URLs below. For local development, override the same variables with your local API and checkout-web origins.

Environment

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