Payments

npm install @insforge/sdk@latest

yarn add @insforge/sdk@latest

pnpm add @insforge/sdk@latest

import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-app.insforge.app',
  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
});

Find the anon key with npx @insforge/cli secrets get ANON_KEY, or in the dashboard: click Install and open API Keys. InsForge Payments is provider-specific. Stripe uses hosted Checkout and Billing Portal. Razorpay uses provider-native Orders and Subscriptions plus Razorpay Checkout. The TypeScript SDK exposes separate provider modules for both.

Stripe Payments

Create Checkout and Billing Portal sessions with insforge.payments.stripe.

Razorpay Payments

Create Orders or Subscriptions with insforge.payments.razorpay, then open Razorpay Checkout.

Shared setup

import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-project.insforge.app',
  anonKey: 'your-anon-key'
});

Payment runtime calls require an InsForge user token. Guest one-time checkout can use an anonymous InsForge token. Provider secret keys must stay server-side and should be configured through Dashboard -> Payments -> Settings, the CLI, or admin APIs.

Fulfillment

For both providers, create app-owned tables such as public.orders, public.credit_ledger, or public.team_entitlements, then populate them from verified provider webhook events in payments.webhook_events. payments.transactions is a dashboard/reporting projection. Do not use it as the primary business workflow.

Next steps

Use Stripe Payments for insforge.payments.stripe.createCheckoutSession(...) and insforge.payments.stripe.createCustomerPortalSession(...).
Use Razorpay Payments for insforge.payments.razorpay.createOrder(...), createSubscription(...), verification, and subscription management.
Read Payments overview for the shared database architecture and fulfillment model.

⌘I

TypeScript

Swift

Kotlin

REST API

Examples

Stripe Payments

Razorpay Payments

Shared setup

Fulfillment

Next steps

Stripe Payments

Razorpay Payments

​Shared setup

​Fulfillment

​Next steps

Shared setup

Fulfillment

Next steps