Skip to main content
Products describe what you sell. Prices describe how much a product costs. Checkout sessions and payment links can reference prices with price_id so the amount and currency come from the catalog. Use this page for the model. Use the generated endpoint pages for payloads and exact field requirements. The core path is Create product, then Create price, then reference the price_ ID from checkout or payment-link creation.

​
Product endpoints

​
Price endpoints

​
Notes

  • Product name is required on create.
  • Price product_id and currency are required on create; unit_amount should be sent explicitly, including 0 for free prices.
  • Prices are mostly immutable. Update active state, nickname, or metadata instead of changing amount or currency.
  • cross_sells uses replace semantics when present: omit it to keep existing values, send [] to clear.