LatticeStripe.SubscriptionSchedule.PhaseItem (LatticeStripe v1.7.7)

A single item inside a SubscriptionSchedule phase.

A phase item is a template that Stripe materializes into a real %LatticeStripe.SubscriptionItem{} when the phase activates. Its shape differs from a live SubscriptionItem:

NO id, object, subscription, created, current_period_start, current_period_end — a template has no identity yet.
HAS price_data (inline price creation) and trial_data (phase-scoped trial settings) — a live item would use the parent subscription's trial settings instead.

See also: LatticeStripe.SubscriptionItem for live items on an active subscription.

Fields

billing_thresholds - Per-item billing threshold map
discounts - List of discount IDs or objects
metadata - Set of key-value pairs
plan - Plan object (legacy)
price - Price ID for an existing Price
price_data - Inline price data for ad-hoc pricing
quantity - Quantity for this item
tax_rates - List of tax rate objects
trial_data - Phase-scoped trial configuration map
extra - Unknown fields from Stripe not yet in this struct

Summary

Types

t()

A phase-item template on a Stripe Subscription Schedule phase.

Functions

from_map(map)

Converts a decoded Stripe API map to a %PhaseItem{} struct.

Types

t()

@type t() :: %LatticeStripe.SubscriptionSchedule.PhaseItem{
  billing_thresholds: map() | nil,
  discounts: list() | nil,
  extra: map(),
  metadata: map() | nil,
  plan: map() | nil,
  price: String.t() | map() | nil,
  price_data: map() | nil,
  quantity: integer() | nil,
  tax_rates: list() | nil,
  trial_data: map() | nil
}

A phase-item template on a Stripe Subscription Schedule phase.

Functions

from_map(map)

@spec from_map(map() | nil) :: t() | nil

Converts a decoded Stripe API map to a %PhaseItem{} struct.

Returns nil when given nil.