For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create your first product

Every tiun integration is wired to one or more products you configure in the dashboard. This guide walks through creating a product end-to-end and captures the product ID you'll use in code.


1. Open Products

In the my.tiun.business dashboard, go to Products. The catalog belongs to whichever environment the Sandbox toggle is showing — live and sandbox each have their own products and IDs. Most teams create products in sandbox first while integrating, then recreate them in live when shipping.


2. Pick a product type

Start a new product and choose the type that matches what you're selling. tiun supports two:

  • Subscription — you charge a flat recurring fee on a schedule (monthly, quarterly, yearly). Best when the value is access to the product itself over time.

  • Time-based — you charge for the time the user spends with your content. Best for media-style products (articles, audio, video) where engagement varies per visit.

If you're not sure, see Products in Reference for a fuller comparison.


3. Configure pricing

The configuration depends on the product type. Here's what each field actually represents — you'll be asked for the relevant ones during creation.

For a subscription product:

  • Name — what the user will see (for example "Pro", "Light").

  • Recurring fee — the amount charged each cycle.

  • Billing interval — how often the fee is charged (monthly, quarterly, yearly).

  • Trial period (optional) — a window where the user has access at a reduced price, including 0 for a free trial.

For a time-based product:

  • Name — internal label for the product.

  • Interval — the smallest billable unit of time (for example one minute).

  • Interval fee — what one interval costs.

  • Monthly limit (optional) — caps the total charge per month so heavy users don't run up surprise bills.

Field semantics live in the Products reference if you want the full picture.


4. Save and copy the product ID

Once the product is saved, copy its product ID — it's prefixed p-test-... in sandbox and p-live-... in live. Use it with the matching SDK environment (sandbox: true for p-test-..., live default for p-live-...). See Sandbox if you need both environments.

Last updated

Was this helpful?