TypeScript SDK

Installation

npm
pnpm
yarn
bun

Terminal

npm install @crossdev/sdk

Terminal

pnpm add @crossdev/sdk

Terminal

yarn add @crossdev/sdk

Terminal

bun add @crossdev/sdk

Quickstart

Create an organization access token (Settings > Developers) and store it in CROSSPOINT_ACCESS_TOKEN. The client reads it from there:

index.ts

import { createCrosspoint } from "@crossdev/sdk";

const crosspoint = createCrosspoint();

for await (const product of crosspoint.products.iterList({ limit: 10 })) {
  console.log(product);
}

You can also pass the token yourself: createCrosspoint({ accessToken: "cxp_oat_..." }). Requests wait up to 30 seconds (Polar’s SDK waits 5). Change it with createCrosspoint({ timeout: 60 }), in seconds.

API versions

@crossdev/sdk uses API version 2026-10. Pin a version with its import path:

import { createCrosspoint } from "@crossdev/sdk/2027-01";

Versions 2026-04, 2026-10 and 2027-01 are available.

Creating a checkout

const checkout = await crosspoint.checkouts.create({
  products: ["<PRODUCT_ID>"],
  success_url: "https://your-app.com/success?checkout_id={CHECKOUT_ID}",
});

// send your customer to checkout.url

Transaction splits

crosspoint.splits and crosspoint.splitRecipients are Crosspoint’s own: they share each sale with partners or vendors. See Transaction splits.

const recipients = await crosspoint.splitRecipients.list({ status: "pending" });

Like the rest of the SDK, they use the API’s field names (fee_bearer, product_ids) and take IDs as plain arguments (crosspoint.splits.update(id, { is_default: true })). Errors from these come as CrosspointAPIError, with statusCode and body.

Verifying webhooks

import { webhooks } from "@crossdev/sdk";

try {
  const event = await webhooks.validateEvent(body, headers, process.env.CROSSPOINT_WEBHOOK_SECRET!);
  // handle event.type
} catch (error) {
  if (error instanceof webhooks.WebhookVerificationError) {
    // not from Crosspoint: reject it with a 403
  }
}

Sandbox

Use the sandbox while you build: set CROSSPOINT_ENVIRONMENT=sandbox with a sandbox access token, or pass the environment:

const crosspoint = createCrosspoint({ environment: "sandbox" });

Local development

Point the client at a local API with baseUrl:

const crosspoint = createCrosspoint({ baseUrl: "http://127.0.0.1:8000" });

Next steps

Webhook delivery: a full webhook handler
API reference: every endpoint, with TypeScript examples

Get started

Features

Integrate

Merchant of Record (MoR)

Installation

Quickstart

API versions

Creating a checkout

Transaction splits

Verifying webhooks

Sandbox

Local development

Next steps

​Installation

​Quickstart

​API versions

​Creating a checkout

​Transaction splits

​Verifying webhooks

​Sandbox

​Local development

​Next steps

Installation

Quickstart

API versions

Creating a checkout

Transaction splits

Verifying webhooks

Sandbox

Local development

Next steps