Products

One-time

The customer pays once. You get the money. Nothing recurs, nothing needs managing afterward. Good for software licenses, digital downloads, access passes, and any purchase that only needs to happen once.

Create a checkout with a one-time product and the customer pays the fixed price you set.

const checkout = await st.checkout.create({
  type: "product",
  product_id: "prod_abc123",
  customer_email: "user@example.com",
});

Subscription

The customer is billed on a recurring schedule. You set the price and the billing period: daily, weekly, monthly, yearly, or a custom interval.

StellarTools renews the subscription automatically at the end of each period. You can cancel, pause, or resume from the API or from the customer portal.

Period	What it means
daily	Billed every day
weekly	Billed every 7 days
monthly	Billed every 30 days
yearly	Billed every 365 days
custom	Billed every N days, weeks, or months that you define

When a subscription renews, StellarTools fires a subscription.renewed webhook so you know to keep the customer’s access active.

// Cancel at end of current period
await st.subscriptions.update(subscriptionId, {
  cancel_at_period_end: true,
});

Checking access

Both product types grant the customer access to whatever they paid for. Once they have a confirmed payment or an active subscription, you can verify that access programmatically:

const { has_access, grant } = await st.customers.access.verify("cus_xxx", "prod_xxx");

if (!has_access) {
  throw new Error("No active subscription or payment found");
}
// grant.type is "subscription" or "one_time"

The AI SDK, LangChain, and UploadThing adapters run this check automatically — you only call it directly if you’re building your own gating logic.

Create, read, and update products via the REST API.

Getting Started

Concepts

Integrations

Marketplace

Webhooks

One-time

Subscription

Checking access

Choosing a type

API Reference: Products

Checkouts

​One-time

​Subscription

​Checking access

​Choosing a type

API Reference: Products

Checkouts

One-time

Subscription

Checking access

Choosing a type