ProductAttribute

One charge of a product, such as its platform fee or a usage charge, with its list pricing and credit benefits.

  • active
    Type: boolean
    required

    Whether the charge is offered. An inactive attribute stays on the plans and orders that use it, but a default plan made for the product leaves it out.

  • creditBenefits
    Type:
    required
    Properties: 12
  • name
    Type: string
    required

    The charge's name, unique within the product. It names the charge on invoices.

  • pricing
    required

    How one charge is priced. pricingType picks one of 15 types: recurring fees, usage (per unit, tiered, in credits or at cost plus), one-time fees and seats. Money is in minor units (cents for USD). The pricing is stored as you send it and returned as sent, plus chargeType and pricingModel, which Spondo Billing sets from pricingType.

    A fixed fee per unit, billed every period: unitPrice × the quantity (1 on a plan, the line's quantity on an order).

    Example: a platform fee of 9900 (USD 99.00) billed Monthly in Advance charges USD 99.00 at the start of each month. On an order line with quantity 3 it charges USD 297.00.

    • pricingType
      Discriminator
      const:  
      RecurringPerUnit
      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. unitPrice is the fee per unit per period.

      Properties: 5
    • pricingModel
      const:  
      perUnit
      read-only

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

  • productAttributeId
    Type: string
    required

    The attribute's ID (a UUID).

Previous
ProductUpdateInput
Next
ProductAttributeInput