# 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 via `POST /v1/subscriptions`. |

## 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** (Southbill 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 [Subscriptions API](/docs/api/subscriptions) (`POST /v1/subscriptions`).

## 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** or the API: `POST /v1/products/{product_id}/prices`.

## Finding your Price ID

**Dashboard → Products** — the list shows both the Product ID (`prod_…`) and the Price ID (`price_…`) with copy buttons.