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.
Starting a new product opens one form. You'll work down it in the order of the steps below — name, what you're selling, how you charge, and the fields that appear for the pricing model you pick.
2. Pick a pricing model
Start a new product and choose the pricing model that matches how you want to charge. tiun supports three:
Subscription — you charge a flat price on a repeating interval (daily, weekly, monthly, yearly, or any multiple of those). Best when the value is access to the product itself over time.
One-time purchase — you charge a single price and access never expires. Best for consulting engagements, lifetime licenses, or a single course, report, or deliverable.
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 pricing model. Here's what each field actually represents — you'll be asked for the relevant ones during creation.
For a subscription product:
Product name — shown to your customers at checkout (for example "Pro", "Light").
Interval — a count plus a unit: day, week, month, or year. Every 3 months is how you'd set a quarterly plan.
Price — charged at the start of each interval.
Trial period (optional) — enable it to set a trial length and a trial amount. The trial amount is charged upfront; enter
0for a free trial, or less than the subscription price for a discounted one.
For a one-time product:
Product name — shown to your customers at checkout (for example "Full course", "Lifetime license").
Price — the single amount charged at checkout. It incurs only once; there's no interval and no trial.
For a time-based product:
Product name — shown to your customers at checkout.
Interval — measured in minutes; it's the only unit time-based billing offers.
Interval fee — what one interval costs, charged at the start of it.
Monthly limit — caps what a user can be charged in a calendar month, so heavy users don't run up surprise bills.
Field semantics live in the Products reference if you want the full picture.
4. Pick a tax category
Whatever the type, you also file the product under a tax category. It's required and there's no default. tiun is the Merchant of Record for your sales, so this is what determines how the product is taxed.
The form lists the available categories with a short description, guidance on where each one ends, and examples. Pick the one your product genuinely belongs to — not the closest-looking match.
If none of them fit what you sell, choose Something else and describe your product. tiun follows up with you instead of filing it under an approximate category, so it's always better than picking a near-match.
Choose carefully — this one is permanent. Unlike the name and price, a product's tax category cannot be changed after the product is created. Correcting it means archiving the product and creating a new one, and archiving cannot be undone. If you're unsure which category applies, use Something else rather than guessing.
5. 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?