Prices

Prices define how much and how often to charge for products.

The Price object

{
  "id": "price_abc123",
  "object": "price",
  "product": "prod_xyz789",
  "unit_amount": 50000,
  "currency": "xof",
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "active": true,
  "created": 1708300800
}

Endpoints

Method	Endpoint	Description
POST	/v1/prices	Create a price
GET	/v1/prices/{id}	Retrieve a price
PATCH	/v1/prices/{id}	Update a price
GET	/v1/prices	List prices

Create a Price

POST /v1/prices

Parameter	Type	Required	Description
product	string	✅	Product ID
unit_amount	integer	✅	Amount in smallest currency unit
currency	string	✅	Three-letter ISO currency code
recurring	object		For recurring prices: { interval, interval_count }

Recurring intervals

Interval	Description
day	Daily billing
week	Weekly billing
month	Monthly billing
year	Annual billing