The product and price objects

{
  "id": "prod_01JEXAMPLE2K8V4N9C6M1Q7R",
  "object": "product",
  "name": "Monthly membership",
  "description": "Unlimited classes each month",
  "active": true,
  "default_price_id": null,
  "metadata": {},
  "livemode": false
}

{
  "id": "price_01JEXAMPLE2K8V4N9C6M1Q7R",
  "object": "price",
  "product_id": "prod_01JEXAMPLE2K8V4N9C6M1Q7R",
  "unit_amount": 2500,
  "currency": "usd",
  "type": "one_time",
  "recurring": null,
  "active": true,
  "livemode": false
}

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. For payloads and exact field requirements, open the endpoint pages in this group. The core path is Create product, then Create price, then reference the price_ ID from checkout or payment-link creation.

Attributes

Product attributes

string

Product id (prod_…).

string

Product name.

string

Product description.

boolean

false when the product is archived.

string | null

The product’s default price (price_…), or null if none is set.

object

Custom key-value pairs for your use.

Price attributes

string

Price id (price_…).

string

Parent product (prod_…).

integer

Billing amount in minor units.

string

Three-letter ISO currency code.

string

Price type.

object | null

Cadence for recurring prices; null for one-time prices.

boolean

false when the price is deactivated.

See every field in the response of Retrieve a product.

Product endpoints

Endpoint	Use it for
Create product	Add a product.
List products	Page through products, optionally filtering by `active`.
Get product	Retrieve one product by `prod_` ID.
Update product	Change name, active state, metadata, images, kind, or cross-sells.

Price endpoints

Endpoint	Use it for
Create price	Add a one-time price to a product.
List prices	Page through prices, optionally filtering by product or active state.
Get price	Retrieve one price by `price_` ID.
Update price	Change active state, nickname, or metadata.

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.

Fundamentals

Payments

Checkout

In-person payments

Customers and catalog

Connect

Billing

Webhooks

The product and price objects

Attributes

Product attributes

Price attributes

Product endpoints

Price endpoints

Notes

​Attributes

​Product attributes

​Price attributes

​Product endpoints

​Price endpoints

​Notes

Attributes

Product attributes

Price attributes

Product endpoints

Price endpoints

Notes