createClientSession(params)

Creates a client session without rendering a UI. This function is used in advanced scenarios where you want to obtain a payment client token and order ID first, then possibly handle the UI or payment flow manually.

Parameters

string

required

The price identifier for the subscription/product.

string

required

The customer’s external ID (your user ID).

string

required

Customer’s email address.

string

Organization ID, if not configured globally. Not needed if you already called configure().

Returns

A Promise resolving to an object containing at least { clientToken, orderId, type }. The clientToken can be used with Primer’s Headless Checkout, and orderId is the generated order identifier on Funnelfox’s side.

Example

import { createClientSession } from '@funnelfox/billing';

const session = await createClientSession({
  priceId: 'price_123',
  externalId: 'user_456',
  email: 'user@example.com',
  orgId: 'your-org-id', // Optional if configured
});

console.log(session.clientToken); // Use with Primer Headless Checkout
console.log(session.orderId);

⌘I

API reference

Webhook reference

Billing Web SDK

createClientSession(params)

Parameters

Returns

Example

​Parameters

​Returns

​Example

Parameters

Returns

Example