Retrieve a product
Returns one product: its price in the currency's minor unit, whether it is `active`, and for a recurring product the interval it bills on. Only products belonging to the key's merchant and mode are visible.
Returns one product: its price in the currency's minor unit, whether it is active, and for a recurring product the interval it bills on. Only products belonging to the key's merchant and mode are visible.
Authorization
secretKey Your secret key: sk_live_… or sk_test_….
In: header
Path Parameters
The product's id, which starts with pdt_.
^pdt_[0-9a-f]{32}$Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/products/pdt_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c"{ "object": "product", "product_id": "pdt_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c", "name": "string", "description": "string", "price": 0, "currency": "AED", "billing": "one_time", "billing_interval": "day", "interval_count": 1, "status": "active", "metadata": { "property1": "string", "property2": "string" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Create a product POST
Saves something you sell, so a checkout can name it by `product_id` instead of repeating a price. Create one for anything you sell more than once, and for every plan: only a saved recurring product can start a subscription. `price` is an integer in the currency's minor unit, and `currency` must be one `GET /account` lists. `billing: "recurring"` needs a `billing_interval`, and `interval_count` bills every N intervals; a one-time product must not carry either. A price of zero is accepted, but a checkout containing that product is refused. A product created with a test key exists only in test mode. Send `Idempotency-Key` so a retried request does not save a second product.
List products GET
Lists products, newest first, drafts and archived ones included. Filter by `status` for what customers can actually buy (`status=active`), or by `billing` to separate one-time prices from recurring plans. One page carries `items`, `has_more` and `next_cursor`; pass `next_cursor` back as `cursor` for the next page. Only products belonging to the key's merchant and mode are listed.