SDKs and CLI

Pick the Smallest Package That Does the Job

Throttle publishes focused packages for checkout embeds, native cart orchestration, discounts, generated REST calls, and command-line setup. Each package card calls out where it is safe to run and whether it is production-ready today.

Environment comes from the credential
Server SDKs do not take a separate environment option for normal API calls. Generate separate keys for Production, Test, UAT, or any custom non-production environment; the raw key is pinned to exactly one workspace environment. Every non-production environment routes to sandbox provider credentials. Clerk-authenticated dashboard calls that are not using an API key send X-Throttle-Environment-Id instead.

@usethrottle/checkout-sdk

Production

Checkout SDK with server-side session/order helpers and a React wrapper for embedded payment.

Server helpers plus browser React component. Secret API key stays server-side.

NodeReactcheckout
Install
npm install @usethrottle/checkout-sdk

@usethrottle/checkout-react

Production

React iframe components for payment-only and full checkout embeds.

Browser React component. Session creation still belongs on your backend.

ReactiframepostMessage
Install
npm install @usethrottle/checkout-react

@usethrottle/cart

Production

Typed server-side client for native carts, line items, discounts, shipping, tax, and checkout.

Server-side only. Requires a secret API key.

Nodecartshipping/tax
Install
npm install @usethrottle/cart

@usethrottle/discounts

Production

Headless server-side client for promotion code preview, management, and cart apply.

Server-side only. Requires a secret API key.

Nodediscountspromotions
Install
npm install @usethrottle/discounts

@usethrottle/subscriptions

Production

Production React hooks, server proxy helpers, and primitives for buyer subscription portals.

Browser hooks through your backend proxy; server helper/client with your secret key.

Reactsubscriptionsbuyer portal
Install
npm install @usethrottle/subscriptions @usethrottle/checkout-react

@usethrottle/invoices

Production

React hooks and server proxy for surfacing a buyer's unified invoice list — card captures, Net-N issuances, and subscription charges — in your storefront portal.

Browser hooks through your backend proxy. The server subpath holds the sk_ key; buyers never call Throttle directly.

Reactinvoicesbuyer portal
Install
pnpm add @usethrottle/invoices

@usethrottle/payment-methods

Production

React hooks, a headless client, and a drop-in wallet component so buyers can list, add, set as default, and remove saved cards — your secret key stays server-side behind a minted client token.

Browser hooks + component gated by a server-minted client token; the server subpath holds the sk_ key. Buyers never touch the secret key.

Reactpayment methodsbuyer portal
Install
npm install @usethrottle/payment-methods

@usethrottle/api-client

Generated

Generated TypeScript REST client for advanced endpoints that do not yet have a focused SDK.

Server-side escape hatch. Prefer checkout, cart, discounts, and subscriptions SDKs for normal storefront flows.

OpenAPITypeScriptREST
Install
npm install @usethrottle/api-client

@usethrottle/webhook-types

Production

Discriminated unions for every outbound webhook event + a Stripe-compatible signature verification helper.

Node 20+. Use from your webhook route handler to narrow event.data without casts.

TypeScriptwebhookstypes
Install
npm install @usethrottle/webhook-types

@usethrottle/extension-bridge

Production

Iframe runtime bridge for extension apps, plus webhook verification helpers for extension event receivers.

Browser iframe client for createBridge(); Node route handlers can import the webhook verifier subpath.

ExtensionsiframepostMessage
Install
npm install @usethrottle/extension-bridge

@usethrottle/cli

Setup

Command-line helper for embed configuration and developer setup tasks.

Developer workstation or CI setup tool.

CLIoriginssetup
Install
npm install -g @usethrottle/cli

Package Boundary

For public integrations, use the @usethrottle/*packages above. If a package is not listed here, it is not public API.

Check published versions
npm view @usethrottle/checkout-sdk version && npm view @usethrottle/checkout-react version && npm view @usethrottle/cart version && npm view @usethrottle/discounts version && npm view @usethrottle/subscriptions version && npm view @usethrottle/extension-bridge version