Products Overview
Product catalog structure in GetPaidHQ.
Products are catalog containers. Variants are the sellable versions of a product. Prices attach billing terms to variants.
Model
- Product: the thing you sell.
- Variant: a sellable version of that product.
- Price: the billing terms for a variant.
Product lifecycle
Products are either active or archived.
- Active: sellable and returned by default catalog views.
- Archived: preserved for history but not used for new sales.
Use archiving for retired products. Do not treat it as deletion; historic orders and subscriptions still need the product context.
Catalog design
Keep products broad and variants specific. For example, use one product for "API Access" and variants for "Basic", "Pro", or regional packaging.
Prices belong to variants so each sellable option can have fixed, metered, or hybrid pricing.
API details are in Catalog API.