ItemWithPrice

Subscription item referencing an existing price from your product catalog.

Currency Handling:

  • currency is optional at item level
  • Falls back to the subscription-level currency if not provided
  • At least one of item.currency or subscription.currency must be set
  • price
    Type: string
    required

    Price ID from your product catalog (ULID format).

  • quantity
    Type: integer
    min:  
    1

    Quantity of the subscription item.

  • unit_amount
    Type: number | null
    min:  
    0

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

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

    Three-letter ISO currency code (e.g. usd). Optional — falls back to subscription.currency if not provided.

  • recurring
    Type: RecurringConfig
    required

    Recurring billing configuration.

    Properties: 4