React SDK overview

​

What’s in the SDK

​

Components

​

Hooks

​

What you don’t need to do

• No Stripe SDK — BillingOS handles all Stripe communication. No @stripe/stripe-js or @stripe/react-stripe-js needed.
• No PCI compliance — Checkout runs in a secure iframe. Card data never touches your servers.
• No webhook handling — Entitlements update automatically after checkout.

​

Quick example

import { BillingOSProvider, PricingTable } from "@billingos/sdk";

function App() {
  return (
    <BillingOSProvider sessionTokenUrl="/api/billingos-session">
      <PricingTable />
    </BillingOSProvider>
  );
}

​

Architecture

BillingOSProvider (manages auth + SDK client)
  └── Components (PricingTable, CheckoutModal, CustomerPortal, etc.)
        └── Hooks (useSubscription, useFeature, useCheckout, etc.)
              └── BillingOSClient (API layer)

​

Requirements

• React 18+ (React 19 supported)
• TypeScript types included — no separate @types package needed
• Built on TanStack Query for data fetching and caching
• Tree-shakeable bundle (sideEffects: false)

​

Next steps