UsageCostPlus

Your AI cost of serving the customer, passed on with a markup: the cost of the customer's traced AI calls in the period, converted from USD to the invoice's currency, × costPlusMultiplier. A period is converted at the exchange rate in force when it's first invoiced and keeps that rate, so a rate you change later applies only to periods invoiced from then on. It follows cost traces, not signals, so it takes no eventName.

Example: USD 200.00 of AI cost with costPlusMultiplier 1.3 bills USD 260.00.

pricingType
const:
UsageCostPlus
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:
usage
read-only

Set by Spondo Billing from pricingType: the kind of charge. Returned, never sent.
costPlusMultiplier
Type: number
min:
0

What the period's AI cost is multiplied by: 1.3 bills the cost plus 30%.
pricePoints
Type:

Only each price point's currency is used; send unitPrice 0.

Properties: 5
pricingModel
const:
costPlus
read-only

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

What a usage charge bills for: activity (work done) or outcome (a result delivered, such as a resolved ticket). Both bill the same way; it labels the charge.

values
activityoutcome

Examples

{
  "pricingType": "UsageCostPlus",
  "costPlusMultiplier": 1.3,
  "billingFrequency": "Monthly",
  "billingType": "Arrears",
  "pricePoints": [
    {
      "currency": "USD",
      "unitPrice": 0
    }
  ]
}

UsageBracketedPrepaidCredits

OneTimePerUnit