Catalog

Build the catalog before creating orders. The catalog is the source of what can be sold and how it is billed.

Integration flow

1. Create a product for the thing you sell.
2. Add variants for sellable versions of that product.
3. Add prices to each variant.
4. Add meters before creating metered prices.
5. Archive products that should no longer be sold.

API pages used

• Catalog API
• Usage Records API

Implementation notes

• Keep product names stable enough for historic orders to remain readable.
• Use variants for packaging differences, not for every billing interval.
• Use prices for currency, interval, fixed amount, and metered behavior.
• Create meters before prices that reference usage.

For the product model, see Products Overview.