Struct SubscriptionItem

pub struct SubscriptionItem {
    pub billing_thresholds: Option<Value>,
    pub created: i64,
    pub id: String,
    pub metadata: Value,
    pub object: String,
    pub price: Price,
    pub quantity: Option<i64>,
    pub subscription: String,
    pub tax_rates: Option<Vec<TaxRate>>,
}

Subscription items allow you to create customer subscriptions with more than one plan, making it easy to represent complex billing relationships.

Fields

billing_thresholds: Option<Value>

Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period

created: i64

Time at which the object was created. Measured in seconds since the Unix epoch.

id: String

Unique identifier for the object.

metadata: Value

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

object: String

String representing the object’s type. Objects of the same type share the same value.

price: Price

Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. Products help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme.

For example, you might have a single “gold” product that has prices for $10/month, $100/year, and €9 once.

Related guides: Set up a subscription, create an invoice, and more about products and prices.

quantity: Option<i64>

The quantity of the plan to which the customer should be subscribed.

subscription: String

The subscription this subscription_item belongs to.

tax_rates: Option<Vec<TaxRate>>

The tax rates which apply to this subscription_item. When set, the default_tax_rates on the subscription do not apply to this subscription_item.

Trait Implementations

impl Clone for SubscriptionItem

fn clone(&self) -> SubscriptionItem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SubscriptionItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SubscriptionItem

fn default() -> SubscriptionItem

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SubscriptionItem

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SubscriptionItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Serialize for SubscriptionItem

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.