SchedulePhaseItemWithPrice

Phase item referencing an existing catalog price.

One-time charge: omit recurring (or set null) — the item is charged once on phase creation and excluded from all future billing cycles.

  • price
    Type: string
    required

    Price ID from your product catalog.

  • currency
    Type: string | null
    min length:  
    3
    max length:  
    3

    Currency override. Falls back to schedule default_settings or subscription currency.

  • metadata
    Type: object | null

    Arbitrary key-value pairs for this item.

    • propertyName
      Type: anything
  • quantity
    Type: integer
    min:  
    1

    Quantity of this item.

  • recurring
    Type: object · RecurringConfig

    Recurring billing configuration.

    • interval
      Type: stringenum
      required

      Billing frequency (uppercase):

      • daily — every day
      • weekly — every week
      • monthly — every month
      • yearly — every year
      values
      • daily
      • weekly
      • monthly
      • yearly
    • interval_count
      Type: integer
      min:  
      1

      Number of intervals between billings. For example, interval=monthly and interval_count=3 bills every 3 months.

    • interval_total_cycles
      Type: integer | null
      min:  
      1

      Total number of billing cycles before the subscription ends. Null means unlimited.

    • usage_type
      Type: stringenum

      Usage type for billing:

      • licensed — a fixed recurring charge per billing cycle
      • metered — charge based on reported usage
      values
      • licensed
      • metered
  • unit_amount
    Type: number | null
    min:  
    0

    Unit amount override in cents. Falls back to the catalog price if omitted.