Prices
One-time and recurring prices for your products.
Prices
A Price represents how much and how often a product costs. Every product needs at least one price to be sellable.
Types
| Type | recurring |
Use for |
|---|---|---|
one_time |
null |
Physical goods, single services, invoices. |
recurring |
{ interval, interval_count } |
Subscriptions (API-only, coming soon). |
Fields
| Field | Description |
|---|---|
unit_amount |
Amount in minor units (cents). Must be ≥ 250 (= 2.50). |
currency |
3-letter ISO code, lowercase. |
product |
The parent prod_… ID. |
type |
one_time or recurring. |
recurring.interval |
day, week, month, year. |
recurring.interval_count |
e.g. 3 → every 3 months. |
nickname |
Internal label (e.g. "Pro monthly EUR"). |
active |
false archives it — existing subscriptions keep billing. |
Currency lock
Once a price exists, its currency is immutable (spuke rule). To sell in another currency, create a second price for the same product with a different currency.
Recurring prices in invoices
Recurring products are disabled in the invoice UI — invoices are one-shot documents. To bill on a schedule, use the upcoming Subscriptions API (/v1/subscriptions, currently in design).
Creating a price
Prices are created automatically when you create a product from the dashboard. To add additional prices to an existing product, use Dashboard → Products → {product} → Add price (coming soon) or call spuke directly on your connected account.
Finding your Price ID
Dashboard → Products — the list shows both the Product ID (prod_…) and the Price ID (price_…) with copy buttons.