RecurringGraduated

A recurring charge priced on tiers, graduated: the units in each tier are priced at that tier's price. The quantity is 1 on a plan and the line's quantity on an order.

Example: up to 10 units at 2000 (USD 20.00) each, then 1500 (USD 15.00) each. 25 units cost 10 × 20.00 + 15 × 15.00 = USD 425.00 a month.

pricingType
const:
RecurringGraduated
required

The pricing type. It decides the charge's other fields and how it bills.
billingFrequency
Type: enum

How often the charge is billed: every 1, 3, 6 or 12 months, or with Custom every billingFrequencyCustomMonths months. Amounts (the price, credit benefits) are per billing period: a quarterly fee is charged once a quarter.

values
MonthlyQuarterlySemi-AnnuallyAnnualCustom
billingFrequencyCustomMonths
Type: integer
min:
1

With billingFrequency: Custom, the length of the billing period in months.
billingType
Type: enum

When each period is billed. Advance: at the start of the period, for the period ahead. Arrears: at the end, for the period just ended. Usage charges, and the overage of seats that come with credits, are always billed in arrears. Default: Arrears for usage charges, Advance for the rest.

values
AdvanceArrears
chargeType
const:
recurring
read-only

Set by Spondo Billing from pricingType: the kind of charge. Returned, never sent.
pricePoints
Type:

One price point per currency. An order uses the one in its currency, else the first. Each carries the tiers the quantity is priced on.

Properties: 6
pricingModel
const:
graduatedPricing
read-only

Set by Spondo Billing from pricingType: how the charge is priced. Returned, never sent.

Examples

{
  "pricingType": "RecurringGraduated",
  "billingFrequency": "Monthly",
  "billingType": "Advance",
  "pricePoints": [
    {
      "currency": "USD",
      "unitPrice": 0,
      "tiers": [
        {
          "upperBound": 10,
          "unitAmount": 2000
        },
        {
          "upperBound": null,
          "unitAmount": 1500
        }
      ]
    }
  ]
}

RecurringPerUnit

RecurringVolume