Prices
A price says how much a product costs and how often it bills. Today every price is RECURRING.
Pass a price ID as priceId when you create or update a subscription. The subscription copies unitAmount (as amount), currency and recurring. A later change to the price never changes a subscription that already exists.
Prices do not change
Only active, nickname and metadata can change. To change the amount, the currency or the billing period, create a new price and switch the subscriptions to it.
Prices are never deleted. Set active to false to archive one. A subscription that already uses an archived price keeps working, but a subscription cannot start from it or switch to it.
Create Price
Creates a price of a product.
List Prices
Lists the prices of one product, newest first, one page at a time.
Get Price
Retrieves a price by its unique ID.
Update Price
Updates a price. Only `active`, `nickname` and `metadata` can change. Any other field is rejected.