How Products Work
| Type | Use Case | Example |
|---|---|---|
admission | Entry tickets | General admission, VIP pass |
presale | Early access offers | Presale tickets, early bird deals |
perks | Vouchers and extras | Drink coupons, merch credits, backstage access |
Product Items
A product item is a single instance of a product issued to a user. Think of a product as the template (e.g., “General Admission Ticket”) and items as individual copies given to specific users. Items support:- Sequential IDs — Each item gets a unique
item_id(also used as NFT ID if minted) - Multi-use redemption — Configure
redemption_quantityfor items valid for multiple uses (e.g., a voucher for 3 drinks) - Transfers — Allow users to send items to other users (when
is_transferableis enabled) - Batch issuance — Issue to up to 550 users per request
Configuration Options
Products offer fine-grained control over distribution:| Field | What it does | Default |
|---|---|---|
stock | Total available inventory (null = unlimited) | Unlimited |
max_per_account | Max items per user (null = unlimited) | Unlimited |
redemption_quantity | Times each item can be redeemed | 1 |
is_transferable | Allow transfers between users | false |
is_claimable | Allow claiming via direct URL | false |
price | Product price as decimal string (e.g., "49.99") | — |
active | Whether items can currently be issued | true |
NFT Minting
Products can optionally mint an NFT on the Polkadot network for each issued item. When enabled:- Set
mint_nft: truewhen creating the product - Provide a
metadata_uripointing to a JSON file withname,image, anddescription - Choose a
chain:AssetHub(mainnet) orWestendAssetHub(testnet) - Your project wallet needs at least 2 DOT (or 2 WND on testnet) for on-chain fees
- Each item’s sequential
item_idbecomes its on-chain NFT ID
Quick Example
Create a ticket and issue it:Learn More
Products API Reference
Full API documentation with all endpoints, parameters, and response schemas.
Events Overview
Learn how events and products work together.