ChangeLog — v1.2.0
v1.2.0 — Pricing v2
Released: November 2026
Phase 1: Price components
- Every price is built from price components: flat, per unit, graduated, volume and percentage, recurring or usage, each with an included quantity.
- One rating engine now prices estimates, orders, plan changes, renewals, invoices and MRR.
- Amounts have 6 decimals. Each invoice line and its GST are rounded to paise, and the total is the sum of the lines.
- New v2 APIs for prices and
POST /v2/prices/rate. The rate plan builder saves through v2. - v1 APIs keep working. A v1 edit that cannot be expressed against a multi-component price returns 409.
Phase 2: Charge models
- Stairstep and package pricing, with rounding UP, DOWN or PROPORTIONAL.
- A minimum and a cap per component.
- The builder gets How is it priced? (Per unit, Packs, Steps, Tiers) and + Add minimum or cap.
- Invoice lines say why the amount is what it is, for example
3 packs of 1000.
Phase 3: Invoicing
- Billing timing per component, in advance or in arrears. One boundary invoice carries next period’s in-advance lines and last period’s in-arrears lines.
- One-time fees and per-event fees as components.
- Pending charges:
POST,GETandDELETE /subscriptions/{id}/charges. - Pass-through charges with the Charge GST on pass-through lines switch.
- A final bill on cancel and expire.
Phase 4: Prepaid credits
- A prepaid credit wallet built on credit memos: packs with a bonus, once or every-period grants with rollover, expiry for bonus and grant credits, and a Paid from credits setting on each piece.
- GST is charged once, on the top-up. Covered lines carry no GST.
- Zero-balance actions: bill the overage, top up automatically, or block (
walletExhausted, headerX-Wallet-Exhausted). - A daily job expires credits and checks balances.
- A Wallet tab on the customer page. Wallet API under
/v2.
Changes
- A v1 edit of a price that uses any of these settings is refused with 409.
- Credits left on a cancelled or expired subscription carry over to the account’s next subscription with a wallet price.
See Price Components, Prepaid Credits and the Pricing v2 API.