DocsPlatformProducts & Prices
Products & Prices
Products are the heart of your Saleonix store. One product powers everything: API checkout, payment links, invoices, your storefront — even subscriptions and license keys.
What is a product?
A product is something you sell — an e-book, a software license, a service, a subscription plan. You create products in the dashboard under Store → Products. Each product has:
| Property | What it does |
|---|---|
| Name & description | Shown to buyers on checkout pages and your storefront. |
| Images | Product gallery for the storefront and checkout. |
| SKU | Your internal reference code (unique per store). |
| Price | The amount in EUR. Each price has a price_id used by the API. |
| Tax rate | Optional VAT percentage added on top at checkout and shown on receipts. |
| Show in store | Toggle whether the product appears on your public storefront. |
| Digital file | Attach a file and Saleonix delivers the download after purchase. |
| License keys | Enable licensing and each sale generates a key your app can validate via the License API. |
One-time vs recurring prices
Every product has a price, and a price has a mode:
| Mode | Behavior | Used by |
|---|---|---|
| One-time | Charged once at checkout. | Checkout Sessions API, payment links, storefront, invoices |
| Recurring | Charged on an interval (e.g. monthly, yearly, every N months). Creates a subscription that bills automatically, retries failed charges, and moves to past-due / canceled states. | Storefront subscription checkout; subscription webhooks |
Currency
4318 = €43.18.Using price_id with the API
Open a product in the dashboard to find its price_id. Passing it to the Checkout Sessions API is called price mode— the server reads the amount from your catalog, so nothing the buyer's browser sends can alter the charge:
Price mode checkout
# The amount comes from your catalog — the buyer can never change it.
curl -X POST https://saleonix.com/api/v1/checkout/sessions \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{ "price_id": "clpr1ce...", "quantity": 2 }'The price_id must be active, one-time and EUR — recurring prices return price_mode_unsupported (subscriptions start from the storefront instead).
Digital delivery and licenses
File delivery
Mark a product as having a file and upload it — after a successful payment the buyer receives a secure download. Great for e-books, presets, templates and software builds.
License keys
Enable licensing on a product and configure the maximum activations per key, optional expiry, and demo periods. Every sale generates a license your application can activate and verify with signed API calls — see the License API reference. Manage issued keys under Store → Licenses.
Subscriptions in a nutshell
Give a product a recurring price and buyers can subscribe from your storefront. Saleonix then handles the lifecycle for you:
- Automatic charges on each billing date, with an optional fixed number of payments.
- Failed charges are retried; after repeated failures the subscription becomes past-due.
- You or the customer can cancel; everything is visible under Subscriptions in the dashboard.
- Your server can react to every state change via subscription webhooks (
subscription.created,subscription.payment_succeeded,subscription.past_due, …).
Organizing your catalog
Use Categories and Tags (in the dashboard sidebar) to group products for your storefront. Product features (bullet points) appear on product pages to help buyers compare plans.