Price
An amount at which a Product is sold, once or on a recurring interval. Subscription items and Invoice lines point at Prices.
| |
|---|
| Pack | Billing |
| Version | v1 (latest) |
| URN | urn:postware:billing:price |
| Identity | identifiers or product + name |
Fields
| Field | Type | Req | Notes |
|---|
product | Ref<Product> | yes | |
name | string | no | a short label: Monthly, Annual, 2 seats |
amount | Money | yes | per unit, per interval; tax per tax_inclusive |
interval | enum(one_time|day|week|month|year) | yes | default one_time |
interval_count | int | no | intervals between charges; 3 with month bills quarterly; default 1 |
tax_inclusive | bool | yes | default false |
active | bool | yes | default true |
Extensions
| Extension | Type | Notes |
|---|
ext.billing.tiers | object | Tiered or volume pricing: { scheme (graduated | volume), tiers: [ { up_to (decimal string or null for the last tier), unit_amount { amount, currency }, flat_amount { amount, currency } } ] }. |
ext.billing.trial_days | int | Free trial length in days granted when a subscription starts on this price. |
ext.billing.usage_based | bool | True when the quantity billed each period comes from metered usage rather than a fixed quantity. |