@leaflow/sdk 0.212.0 → 0.214.0

package/dist/billing/v1/generated/models.d.ts

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Billing API
- * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token. The account, its balance, payment options and quotes are also readable by members of the projects it currently pays for; changing the account and moving its funds need the owner. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, quote purchases, changes and renewals, preview cancellations, and, with the project permission `billing:finance.manage` granted in IAM, renew, cancel and turn automatic renewal of its subscriptions on or off, change its billing account and read its costs. A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
+ * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token. The account, its balance, payment options and checkout previews are also readable by members of the projects it currently pays for; changing the account and moving its funds need the owner. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, preview the checkout of purchases, changes and renewals, preview cancellations, and, with the project permission `billing:finance.manage` granted in IAM, renew, cancel and turn automatic renewal of its subscriptions on or off, change its billing account and read its costs. A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
 /**
@@ -43,275 +43,11 @@ export interface OrderCancel {
      */
     order_item_ids?: string[];
 }
-export type QuoteRenewalInterval = (typeof QuoteRenewalInterval)[keyof typeof QuoteRenewalInterval];
-export declare const QuoteRenewalInterval: {
-    readonly day: "day";
-    readonly month: "month";
-    readonly year: "year";
-};
-/**
- * Price renewing a licensed subscription. Give `price_id`, or `interval` with
- * `interval_count`, to renew for another term at the price currently sold for it. Naming
- * the current term, or giving neither, renews at the agreed amount. A term sold at several
- * prices that differ in cancellation policy is refused with 409
- * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` or `price_id` is given.
- */
-export interface QuoteRenewal {
-    subscription_id: string;
-    price_id?: string;
-    interval?: QuoteRenewalInterval;
-    /** @minimum 1 */
-    interval_count?: number;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
-    cancellation_policy?: CancellationPolicy;
-    /**
-     * How many consecutive periods to renew for.
-     * @minimum 1
-     * @maximum 100
-     */
-    periods?: number;
-}
-export type QuoteRenewalResultInterval = (typeof QuoteRenewalResultInterval)[keyof typeof QuoteRenewalResultInterval];
-export declare const QuoteRenewalResultInterval: {
-    readonly day: "day";
-    readonly month: "month";
-    readonly year: "year";
-};
-/**
- * A decimal string, in the currency stated alongside it.
- *
- * **The currency is not part of this type.** It is carried by a `currency` field next to the
- * amount, or by the account the amount belongs to. Reading an amount without that field is
- * reading a number with no unit.
- *
- * It is a string rather than a JSON number because a JSON number is a float in most parsers,
- * and a float loses precision on the first arithmetic. Nothing on this platform puts an amount
- * through a float.
- */
-export type Money = string;
-/**
- * What renewing would charge. Renewing the same subscription for the same term and periods charges exactly `total` unless prices or the account's discounts change first.
- */
-export interface QuoteRenewalResult {
-    /** Which renewal of the request this answers. */
-    index: number;
-    subscription_id: string;
-    /** The price the renewal is charged under. */
-    price_id: string;
-    interval: QuoteRenewalResultInterval;
-    interval_count: number;
-    periods: number;
-    /** The price of the periods before the account's discounts, with any discount the subscription carries already reflected; includes tax only where the price does. */
-    amount: Money;
-    /** The reduction from a discount the account holds. */
-    discount_amount: Money;
-    /** Tax on the discounted amount. */
-    tax_amount: Money;
-    /** The part of `tax_amount` already contained in `amount`. */
-    tax_included_amount: Money;
-    /**
-     * What renewing would charge: `amount` less `discount_amount`, plus `tax_amount`, less
-     * `tax_included_amount`.
-     */
-    total: Money;
-}
-/**
- * The billing period of a recurring licensed line; `none` otherwise.
- */
-export type QuoteItemInterval = (typeof QuoteItemInterval)[keyof typeof QuoteItemInterval];
-export declare const QuoteItemInterval: {
-    readonly none: "none";
-    readonly day: "day";
-    readonly month: "month";
-    readonly year: "year";
-};
-/**
- * The dimension values the line is priced at.
- */
-export type QuoteItemDimensions = {
-    [key: string]: string;
-};
-/**
- * The platform service's fixed identifier, such as compute, canopy or assistant.
- * @minLength 1
- * @maxLength 64
- * @pattern ^[a-z][a-z0-9]*(-[a-z0-9]+)*$
- */
-export type ProductID = string;
-/**
- * `one_time` charges once when bought. `recurring` charges again for every period, or for usage as it is settled.
- */
-export type PriceType = (typeof PriceType)[keyof typeof PriceType];
-export declare const PriceType: {
-    readonly one_time: "one_time";
-    readonly recurring: "recurring";
-};
-/**
- * `licensed` charges for the quantity bought, each period paid before it starts. `metered` charges for the usage
- * reported, after it is settled; a metered subscription lasts until it is canceled. A one-time price is licensed.
- */
-export type UsageType = (typeof UsageType)[keyof typeof UsageType];
-export declare const UsageType: {
-    readonly licensed: "licensed";
-    readonly metered: "metered";
-};
-/**
- * What an immediate downgrade would refund, estimated as of `proration_date`. The refund itself is determined when the change takes effect.
- */
-export interface QuoteDowngradeRefund {
-    /** Returned to the original payment sources, tax paid on it included. */
-    refundable_amount: Money;
-    /** Before tax, the part of the excess that the subscription's refund terms do not return. */
-    forfeited_amount: Money;
-}
-/**
- * One fully calculated purchase line. An item with no immediate charge, such as a metered purchase, has zero checkout amounts.
- */
-export interface QuoteItem {
-    tax_amount: Money;
-    tax_included_amount: Money;
-    /**
-     * The zero-based index of the item or change in the request, or the item's position for a Checkout Session quote.
-     * @minimum 0
-     */
-    index: number;
-    /**
-     * The subscription changed; null for a new purchase.
-     * @nullable
-     */
-    subscription_id: string | null;
-    product_id: ProductID;
-    plan_id: string;
-    /** The selected price, also when the request identified it indirectly. */
-    price_id: string;
-    plan_name: string;
-    type: PriceType;
-    usage_type: UsageType;
-    /** The billing period of a recurring licensed line; `none` otherwise. */
-    interval: QuoteItemInterval;
-    /**
-     * Periods per billing cycle of a recurring licensed line; null otherwise.
-     * @minimum 1
-     * @nullable
-     */
-    interval_count: number | null;
-    /** The dimension values the line is priced at. */
-    dimensions: QuoteItemDimensions;
-    /** The setup charge already included in `amount`; null when none applies. */
-    setup_amount: Money | null;
-    /** Recurring licensed lines only; null otherwise. What each later period renews at, before discounts and tax, which differs from `amount` when the first period is priced differently. `discount` says whether its discount continues on renewals. */
-    recurring_amount: Money | null;
-    /** Unit price before discounts. Null when no single unit price applies, such as tiered or multiple-rate pricing. */
-    unit_amount: Money | null;
-    /** The quantity priced. */
-    quantity: string;
-    /** Amount before discounts and including any setup charge. */
-    amount: Money;
-    discount_amount: Money;
-    /** Immediate changes only; null otherwise. Before tax, the new terms for the time from `proration_date` to the end of the paid period. An upgrade invoices `remaining_amount` minus `unused_amount`. */
-    remaining_amount: Money | null;
-    /** Immediate changes only; null otherwise. Before tax, for an upgrade or an unchanged period price, the amount paid for that time, up to the new terms' value for the same time; for a downgrade, the remaining value of what was paid, under the refund terms of each paid period. */
-    unused_amount: Money | null;
-    /** Immediate downgrades only, when `unused_amount` exceeds `remaining_amount`; null otherwise. */
-    downgrade_refund: QuoteDowngradeRefund | null;
-    total: Money;
-    currency: string;
-}
-/**
- * `complete`: tax is calculated for the billing account's invoice contact, or for `address` without an account. `requires_location_inputs`: a quote without an account or `address`, which leaves out tax that would be added; tax already contained in a price is included.
- */
-export type QuoteTaxStatus = (typeof QuoteTaxStatus)[keyof typeof QuoteTaxStatus];
-export declare const QuoteTaxStatus: {
-    readonly complete: "complete";
-    readonly requires_location_inputs: "requires_location_inputs";
-};
-/**
- * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
- * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
- * A licensed purchase may instead be paid with an online payment method.
- */
-export interface Funds {
-    /** Spendable balance after pending returns. */
-    available_balance_amount: Money;
-    /** Currently effective credits eligible for the quoted purchases or metered usage. Each grant is counted once. */
-    usable_credit_amount: Money;
-    /** Currently effective credits that cannot fund any quoted purchase or metered target. Unused eligible credits are not restricted. */
-    restricted_credit_amount: Money;
-    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement. */
-    required_balance_amount: Money;
-    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
-    balance_shortfall_amount: Money;
-    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
-    required_top_up_amount: Money;
-}
-export type QuotedDiscountType = (typeof QuotedDiscountType)[keyof typeof QuotedDiscountType];
-export declare const QuotedDiscountType: {
-    readonly promotion_code: "promotion_code";
-    readonly account_discount: "account_discount";
-};
-/**
- * Whether the discount continues on renewals of what is bought: `once` applies only to this purchase, `recurring` for `frequency_duration` periods including the first, `forever` on every renewal.
- */
-export type QuotedDiscountFrequency = (typeof QuotedDiscountFrequency)[keyof typeof QuotedDiscountFrequency];
-export declare const QuotedDiscountFrequency: {
-    readonly once: "once";
-    readonly recurring: "recurring";
-    readonly forever: "forever";
-};
-/**
- * `confirmed`: every condition of the discount holds for the billing account. `unverified`: a quote without an account, where conditions that depend on the account, such as a first purchase or a per-account limit, are checked only when a Checkout Session is completed.
- */
-export type QuotedDiscountEligibility = (typeof QuotedDiscountEligibility)[keyof typeof QuotedDiscountEligibility];
-export declare const QuotedDiscountEligibility: {
-    readonly confirmed: "confirmed";
-    readonly unverified: "unverified";
-};
-/**
- * The discount selected for this calculation, not applied and not reserved. Amounts are on the quote and its lines.
- */
-export interface QuotedDiscount {
-    type: QuotedDiscountType;
-    name: string;
-    /**
-     * Code text for a promotion_code discount; null for an account_discount.
-     * @minLength 1
-     * @maxLength 64
-     * @nullable
-     */
-    promotion_code: string | null;
-    /** Whether the discount continues on renewals of what is bought: `once` applies only to this purchase, `recurring` for `frequency_duration` periods including the first, `forever` on every renewal. */
-    frequency: QuotedDiscountFrequency;
-    /**
-     * For `recurring`, the periods the discount lasts; null otherwise.
-     * @minimum 1
-     * @nullable
-     */
-    frequency_duration: number | null;
-    /** `confirmed`: every condition of the discount holds for the billing account. `unverified`: a quote without an account, where conditions that depend on the account, such as a first purchase or a per-account limit, are checked only when a Checkout Session is completed. */
-    eligibility: QuotedDiscountEligibility;
-}
 /**
- * A complete calculation in `currency`; nothing is saved or reserved. The request fails if any item cannot be priced. A Checkout Session quote gives what completing the session would invoice.
+ * One subscription item to end, each at most once.
  */
-export interface Quote {
-    /** Account funds for the quoted purchase. Null without an account. */
-    funds: Funds | null;
-    subtotal: Money;
-    discount_amount: Money;
-    tax_amount: Money;
-    /** The discount a purchase would get, not yet applied. Null when there is none, and for renewals. */
-    discount: QuotedDiscount | null;
-    items: QuoteItem[];
-    renewals: QuoteRenewalResult[];
-    total: Money;
-    currency: string;
-    /**
-     * Immediate changes only; null otherwise. The instant the change is priced from; pass it when confirming the Checkout Session so it is priced from the same instant.
-     * @nullable
-     */
-    proration_date: string | null;
-    /** `complete`: tax is calculated for the billing account's invoice contact, or for `address` without an account. `requires_location_inputs`: a quote without an account or `address`, which leaves out tax that would be added; tax already contained in a price is included. */
-    tax_status: QuoteTaxStatus;
+export interface CancellationItemInput {
+    subscription_item_id: string;
 }
 /**
  * When subscriptions end. immediate ends them now and refunds the unused value under their refund terms; period_end
@@ -326,22 +62,34 @@ export declare const CancellationMode: {
     readonly period_end: "period_end";
 };
 /**
- * What ending these subscriptions together would return, for one mode; preview `immediate` and `period_end` separately to compare. Refused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a paid change waiting to switch (`meta.order_id`).
+ * What ending these items together would return, for one mode; preview `immediate` and `period_end` separately to compare. Refused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when an item is already being canceled (`meta.cancellation_id`), its subscription is being reclaimed (`meta.reason` `reclaim_requested`) or the item has a paid change waiting to switch (`meta.order_id`).
  */
 export interface CancellationPreviewRequest {
     /**
-     * A billing account you own that currently pays for every subscription.
+     * A billing account you own that currently pays for every item.
      * @minimum 1
      */
     billing_account_id: number;
     /**
-     * The subscriptions to end together, all of one service, including every subscription released with a resource.
+     * The items to end together, all of one service, including every item released with a resource.
      * @minItems 1
      * @maxItems 50
      */
-    subscription_ids: string[];
+    items: CancellationItemInput[];
     mode: CancellationMode;
 }
+/**
+ * A decimal string, in the currency stated alongside it.
+ *
+ * **The currency is not part of this type.** It is carried by a `currency` field next to the
+ * amount, or by the account the amount belongs to. Reading an amount without that field is
+ * reading a number with no unit.
+ *
+ * It is a string rather than a JSON number because a JSON number is a float in most parsers,
+ * and a float loses precision on the first arithmetic. Nothing on this platform puts an amount
+ * through a float.
+ */
+export type Money = string;
 /**
  * Which object this is, together with what a person currently calls it.
  *
@@ -358,9 +106,28 @@ export interface NamedIdentity {
     name: string;
 }
 /**
- * One subscription of the previewed cancellation.
+ * `one_time` charges once when bought. `recurring` charges again for every period, or for usage as it is settled.
+ */
+export type PriceType = (typeof PriceType)[keyof typeof PriceType];
+export declare const PriceType: {
+    readonly one_time: "one_time";
+    readonly recurring: "recurring";
+};
+/**
+ * `licensed` charges for the quantity bought, each period paid before it starts. `metered` charges for the usage
+ * reported, after it is settled; a metered subscription lasts until it is canceled. A one-time price is licensed.
+ */
+export type UsageType = (typeof UsageType)[keyof typeof UsageType];
+export declare const UsageType: {
+    readonly licensed: "licensed";
+    readonly metered: "metered";
+};
+/**
+ * One subscription item of the previewed cancellation.
  */
 export interface CancellationPreviewItem {
+    subscription_item_id: string;
+    /** The subscription the item belongs to. */
     subscription_id: string;
     plan_id: string;
     plan_name: string;
@@ -368,7 +135,7 @@ export interface CancellationPreviewItem {
     project?: NamedIdentity | null;
     type: PriceType;
     usage_type: UsageType;
-    /** Whether automatic renewal is on now. Creating the cancellation turns it off; withdrawing it turns it back on for a metered subscription but not for a licensed one. */
+    /** Whether the item's subscription renews automatically now. Creating a cancellation of every continuing item of the subscription turns it off; withdrawing it turns it back on for a subscription with only metered items but not for one with licensed items. */
     auto_renew: boolean;
     unused_amount: Money;
     short_rate_surcharge_amount: Money;
@@ -379,7 +146,7 @@ export interface CancellationPreviewItem {
     forfeited_amount: Money;
 }
 /**
- * What the cancellation would return, per subscription and in total, as of now. Give `proration_date` and
+ * What the cancellation would return, per item and in total, as of now. Give `proration_date` and
  * `refundable_amount` when creating the cancellation.
  *
  * - `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.
@@ -392,11 +159,11 @@ export interface CancellationPreviewItem {
  * - `tax_amount`: the tax included in `refundable_amount`.
  * - `forfeited_amount`: before tax, the part of `unused_amount` the refund terms do not return.
  *
- * Metered and one-time subscriptions show zero; their usage until release is charged as usual.
+ * Metered and one-time items show zero; their usage until release is charged as usual.
  */
 export interface CancellationPreview {
     mode: CancellationMode;
-    /** For `period_end`, when release begins, the end of the paid terms. */
+    /** For `period_end`, when release begins, the end of the subscriptions' current terms. */
     scheduled_at?: string;
     /** For `immediate`, the second the refund is computed as of. Give it when creating the cancellation. */
     proration_date?: string;
@@ -416,7 +183,7 @@ export interface CancellationCreate {
      * @minItems 1
      * @maxItems 50
      */
-    subscription_ids: string[];
+    items: CancellationItemInput[];
     mode: CancellationMode;
     /** For `immediate`, the preview's `proration_date`: a whole second, not in the future and at most ten minutes old; the refund is computed as of it. Now when omitted. */
     proration_date?: string;
@@ -456,18 +223,21 @@ export declare const CancellationItemStatus: {
     readonly failed: "failed";
 };
 /**
- * One subscription of the cancellation.
+ * One subscription item of the cancellation.
  */
 export interface CancellationItem {
-    /** The subscription's cancellation item, the same as `Subscription.cancellation.id`. */
+    /** The item's entry in the cancellation, the same as `SubscriptionItem.cancellation.id`. */
     id: string;
+    subscription_item_id: string;
+    /** The subscription the item belongs to. */
     subscription_id: string;
     plan_id: string;
     plan_name: string;
     type: PriceType;
     /**
-     * Creating the cancellation turned automatic renewal off; withdrawing it turns renewal back on
-     * for a `metered` subscription and leaves it off for a `licensed` one.
+     * When the cancellation covers every continuing item of a subscription, creating it turned the
+     * subscription's automatic renewal off; withdrawing it turns renewal back on for a subscription with
+     * only `metered` items and leaves it off for one with `licensed` items.
      */
     usage_type: UsageType;
     status: CancellationItemStatus;
@@ -484,15 +254,15 @@ export interface CancellationItem {
     gateway_amount?: Money;
 }
 /**
- * One cancellation of a set of subscriptions of one service, released together at one time.
+ * One cancellation of a set of subscription items of one service, released together at one time.
  *
  * - `requested`: `immediate`, release has not begun.
  * - `scheduled`: `period_end`, waiting for `scheduled_at`.
  * - `releasing`: release has begun; it can no longer be withdrawn.
- * - `completed`: every subscription has ended and its refund has been made.
- * - `canceled`: withdrawn before release began; the subscriptions continue.
+ * - `completed`: every item has ended and its refund has been made.
+ * - `canceled`: withdrawn before release began; the items continue.
  * - `failed`: the service could not carry it out, for the reason in `failure_code`; the
- *   subscriptions continue and can be canceled again.
+ *   items continue and can be canceled again.
  */
 export interface Cancellation {
     id: string;
@@ -503,7 +273,7 @@ export interface Cancellation {
     proration_date?: string;
     /** Who requested it; `project_deletion` means the project was deleted. */
     origin: CancellationOrigin;
-    /** The billing account paying for these subscriptions when the cancellation was created: the purchasing account of an account-level purchase, or the project's linked account. */
+    /** The billing account paying for these items when the cancellation was created: the purchasing account of an account-level purchase, or the project's linked account. */
     billing_account_id: number;
     currency: string;
     /** The refund confirmed when the cancellation was created. Absent when the platform created it. */
@@ -530,8 +300,8 @@ export interface CancellationList {
     items: Cancellation[];
     pagination: OffsetPagination;
 }
-export type SubscriptionCancellationStatus = (typeof SubscriptionCancellationStatus)[keyof typeof SubscriptionCancellationStatus];
-export declare const SubscriptionCancellationStatus: {
+export type SubscriptionItemCancellationStatus = (typeof SubscriptionItemCancellationStatus)[keyof typeof SubscriptionItemCancellationStatus];
+export declare const SubscriptionItemCancellationStatus: {
     readonly requested: "requested";
     readonly scheduled: "scheduled";
     readonly releasing: "releasing";
@@ -540,15 +310,15 @@ export declare const SubscriptionCancellationStatus: {
     readonly canceled: "canceled";
 };
 /**
- * The latest cancellation including the subscription, with this subscription's item: `id` is the item and `cancellation_id` the cancellation. scheduled_at is the intended time and effective_at the confirmed end of service.
+ * The latest cancellation including the subscription item, with this item's entry: `id` is the entry and `cancellation_id` the cancellation. scheduled_at is the intended time and effective_at the confirmed end of service.
  */
-export interface SubscriptionCancellation {
+export interface SubscriptionItemCancellation {
     reason?: string;
-    /** The cancellation this item belongs to, with the other subscriptions released together. */
+    /** The cancellation this entry belongs to, with the other items released together. */
     cancellation_id?: string;
     id: string;
-    subscription_id: string;
-    status: SubscriptionCancellationStatus;
+    subscription_item_id: string;
+    status: SubscriptionItemCancellationStatus;
     mode: CancellationMode;
     requested_at: string;
     scheduled_at?: string;
@@ -619,8 +389,15 @@ export interface ErrorStatus {
 export interface Error {
     error: ErrorStatus;
 }
+/**
+ * The platform service's fixed identifier, such as compute, canopy or assistant.
+ * @minLength 1
+ * @maxLength 64
+ * @pattern ^[a-z][a-z0-9]*(-[a-z0-9]+)*$
+ */
+export type ProductId = string;
 export interface Product {
-    id: ProductID;
+    id: ProductId;
     name: string;
     description?: string;
 }
@@ -1105,6 +882,25 @@ export interface PaymentPreviewInvoice {
     credit_applied: Money;
     balance_applied: Money;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A licensed purchase may instead be paid with an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the purchases being checked out or metered usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any purchase being checked out or metered target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this purchase. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 /**
  * What paying would take, calculated as paying does. Nothing is charged or reserved.
  */
@@ -1310,7 +1106,7 @@ export type InvoiceItemDimensions = {
     [key: string]: string;
 };
 /**
- * The value of one paid period moved to the new configuration of a subscription.
+ * The value of one paid period moved to the new configuration of a subscription item.
  */
 export interface InvoiceItemProration {
     /** The earlier invoice line that paid for the period. */
@@ -1371,7 +1167,7 @@ export interface InvoiceItem {
     /** For a usage line, the values of its meter's presentation dimensions, such as the model and token kind. Empty for other lines. */
     dimensions?: InvoiceItemDimensions;
     /**
-     * Present on a line that changes a subscription immediately, one entry for each paid period it
+     * Present on a line that changes a subscription item immediately, one entry for each paid period it
      * covers. `amount` is the sum of `remaining_amount` minus `credited_amount` over the entries.
      */
     prorations?: InvoiceItemProration[];
@@ -1508,7 +1304,7 @@ export declare const RefundStatus: {
  * - `order_canceled`: the order was canceled after part of it was paid.
  * - `change_canceled`: a scheduled change was withdrawn after part of it was paid.
  * - `change_expired`: a scheduled change could not take effect in time.
- * - `subscription_canceled`: the unused value of a canceled subscription, under its refund terms.
+ * - `subscription_canceled`: the unused value of a canceled subscription item, under its refund terms.
  * - `future_period_canceled`: a renewal that had not started was withdrawn.
  * - `downgrade_difference`: after a downgrade, the remaining paid value, valued under each paid period's refund
  *   policy and as `prorated` where that policy is `none`, minus the new configuration's value for the remaining
@@ -1580,6 +1376,9 @@ export type UsageChargeDimensions = {
     [key: string]: string;
 };
 export interface UsageCharge {
+    /** The subscription item the usage belongs to. */
+    subscription_item_id: string;
+    /** The subscription the item belongs to. */
     subscription_id: string;
     id: string;
     project_id?: string;
@@ -1623,6 +1422,22 @@ export interface UsageChargeList {
     items: UsageCharge[];
     pagination: OffsetPagination;
 }
+/**
+ * `pending`: the order has not been accepted. `provisioning`: the owning service accepted the order and is delivering. `active`: delivery was confirmed; payment alone does not make a subscription active. `trialing`: in a free trial, in service, with its licensed items not charged until `trial_end`; metered usage is charged as usual. `suspended`: service is stopped while a lien restricts its use. `canceled`: cancellation of every item completed, or an undelivered purchase was canceled or failed. `terminated`: an operator or the owning service ended it immediately.
+ */
+export type SubscriptionStatus = (typeof SubscriptionStatus)[keyof typeof SubscriptionStatus];
+export declare const SubscriptionStatus: {
+    readonly pending: "pending";
+    readonly provisioning: "provisioning";
+    readonly active: "active";
+    readonly trialing: "trialing";
+    readonly suspended: "suspended";
+    readonly canceled: "canceled";
+    readonly terminated: "terminated";
+};
+/**
+ * The renewal term of its licensed items, `interval_count` intervals long; `none` when every item is metered.
+ */
 export type SubscriptionInterval = (typeof SubscriptionInterval)[keyof typeof SubscriptionInterval];
 export declare const SubscriptionInterval: {
     readonly none: "none";
@@ -1631,15 +1446,39 @@ export declare const SubscriptionInterval: {
     readonly year: "year";
 };
 /**
- * An operation prevented on the subscription. `billing.subscriptions.use` stops the service. `renew` prevents renewal and paying a renewal order. `modify` prevents placing a change order. `cancel` prevents cancellation. `terminate` prevents immediate termination.
+ * What happens when the trial ends while automatic renewal is off. With it on, the first paid period is charged to the account's funds or saved payment method, and this applies only when that charge fails. `cancel`: the subscription ends and its resources are released. `pause`: service stops, and renewing before the retention period ends restores it, with the first paid period starting at payment. `create_invoice`: as `pause`, and an invoice for the first paid period is issued to pay.
  */
-export type SubscriptionRestriction = (typeof SubscriptionRestriction)[keyof typeof SubscriptionRestriction];
-export declare const SubscriptionRestriction: {
-    readonly billingsubscriptionsuse: "billing.subscriptions.use";
-    readonly billingsubscriptionsrenew: "billing.subscriptions.renew";
-    readonly billingsubscriptionsmodify: "billing.subscriptions.modify";
-    readonly billingsubscriptionscancel: "billing.subscriptions.cancel";
-    readonly billingsubscriptionsterminate: "billing.subscriptions.terminate";
+export type TrialEndBehaviorMissingPaymentMethod = (typeof TrialEndBehaviorMissingPaymentMethod)[keyof typeof TrialEndBehaviorMissingPaymentMethod];
+export declare const TrialEndBehaviorMissingPaymentMethod: {
+    readonly cancel: "cancel";
+    readonly pause: "pause";
+    readonly create_invoice: "create_invoice";
+};
+export interface TrialEndBehavior {
+    /** What happens when the trial ends while automatic renewal is off. With it on, the first paid period is charged to the account's funds or saved payment method, and this applies only when that charge fails. `cancel`: the subscription ends and its resources are released. `pause`: service stops, and renewing before the retention period ends restores it, with the first paid period starting at payment. `create_invoice`: as `pause`, and an invoice for the first paid period is issued to pay. */
+    missing_payment_method: TrialEndBehaviorMissingPaymentMethod;
+    /**
+     * How long a subscription stopped at the end of its trial keeps its resources before they are reclaimed; null for the platform's retention period.
+     * @nullable
+     */
+    retention_seconds: number | null;
+}
+/**
+ * How a free trial ends, as Stripe's trial_settings.
+ */
+export interface TrialSettings {
+    end_behavior: TrialEndBehavior;
+}
+/**
+ * An operation prevented on the subscription. `billing.subscriptions.use` stops the service. `renew` prevents renewal and paying a renewal order. `modify` prevents placing a change order. `cancel` prevents cancellation. `terminate` prevents immediate termination.
+ */
+export type SubscriptionRestriction = (typeof SubscriptionRestriction)[keyof typeof SubscriptionRestriction];
+export declare const SubscriptionRestriction: {
+    readonly billingsubscriptionsuse: "billing.subscriptions.use";
+    readonly billingsubscriptionsrenew: "billing.subscriptions.renew";
+    readonly billingsubscriptionsmodify: "billing.subscriptions.modify";
+    readonly billingsubscriptionscancel: "billing.subscriptions.cancel";
+    readonly billingsubscriptionsterminate: "billing.subscriptions.terminate";
 };
 /**
  * Follows the items. `pending`: not yet accepted, paid or unpaid; its invoice shows whether payment is needed, and it can expire or be canceled. `accepted`: items are being set up. `completed`: every item was set up. `partially_completed`: some items were set up and the others failed or were canceled and refunded to their original payment sources. `failed`: no item was delivered and at least one failed; amounts collected for undelivered items are refunded. `canceled`: every item was withdrawn without delivery; collected amounts are returned to their original payment sources. No status by itself means the service was delivered.
@@ -1660,7 +1499,7 @@ export declare const ScheduledChangeInterval: {
     readonly year: "year";
 };
 /**
- * The next accepted period-end change of the subscription: the target terms, applied at effective_at.
+ * The next accepted period-end change of the item: the target terms, applied at effective_at.
  */
 export interface ScheduledChange {
     order_id: string;
@@ -1678,51 +1517,30 @@ export interface ScheduledChange {
     /** @minimum 1 */
     interval_count: number;
 }
-/**
- * `pending`: the order has not been accepted. `provisioning`: the owning service accepted the order and is delivering. `active`: delivery was confirmed; payment alone does not make a subscription active. `suspended`: service is stopped while a lien restricts its use. `canceled`: cancellation completed, or an undelivered purchase was canceled or failed. `terminated`: an operator or the owning service ended it immediately.
- */
-export type SubscriptionStatus = (typeof SubscriptionStatus)[keyof typeof SubscriptionStatus];
-export declare const SubscriptionStatus: {
-    readonly pending: "pending";
-    readonly provisioning: "provisioning";
-    readonly active: "active";
-    readonly suspended: "suspended";
-    readonly canceled: "canceled";
-    readonly terminated: "terminated";
-};
 /**
  * The dimension values of what was bought, such as region and instance type. Empty when the purchase gave none.
  */
-export type SubscriptionDimensions = {
+export type SubscriptionItemDimensions = {
     [key: string]: string;
 };
 /**
- * A purchase that is billed, renewed and changed on its own, separate from the owning service's resource. A new
- * recurring purchase creates a pending subscription for each order line; its ID is returned on the order item
- * and stays the same through checkout, delivery, renewals and changes. A one-time purchase may create none.
- *
- * Pending and provisioning subscriptions grant no service. A subscription becomes provisioning when the owning
- * service accepts the order, and active when the service confirms delivery, which sets started_at; payment
- * changes neither. Licensed service periods start at delivery, and metered usage is charged as the service
- * reports it. Canceling or failing an undelivered purchase cancels its subscriptions without starting a period.
- * Renewals use recurring_amount and the agreed interval; paid periods keep their value.
- *
- * A shared capacity limit, such as a regional snapshot quota, has one subscription for the purchased quantity
- * rather than one per item.
+ * One priced part of a subscription, as a Stripe subscription item, such as the instance, a volume or the bandwidth of an elastic IP. It renews with its subscription and can be changed or canceled alone.
  */
-export interface Subscription {
-    /** Whether new account discounts may apply to future renewals. A fixed operator renewal agreement disables automatic discounts; catalog repricing or a newly selected purchase agreement enables them. */
-    renewal_discounts_enabled?: boolean;
-    currency: string;
+export interface SubscriptionItem {
+    id: string;
+    subscription_id: string;
+    plan_id: string;
+    plan_name: string;
+    price_id: string;
     type: PriceType;
     usage_type: UsageType;
     /** The dimension values of what was bought, such as region and instance type. Empty when the purchase gave none. */
-    dimensions: SubscriptionDimensions;
-    interval: SubscriptionInterval;
-    /** @minimum 1 */
-    interval_count?: number;
-    /** The whole licensed subscription's renewal amount, after continuing discounts and before tax. A pending subscription shows base terms until paying the order fixes any new discount. Absent for metered and one-time subscriptions. */
+    dimensions: SubscriptionItemDimensions;
+    quantity: string;
+    /** This item's renewal amount, after continuing discounts and before tax. A pending item shows base terms until paying the order fixes any new discount. Absent for metered and one-time items. */
     recurring_amount?: string;
+    /** Whether new account discounts may apply to this item in future renewals. A fixed operator renewal agreement disables automatic discounts; catalog repricing or a newly selected purchase agreement enables them. */
+    renewal_discounts_enabled?: boolean;
     cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
     /** Refund policy `short_rate` only, as on the price bought. */
@@ -1731,28 +1549,46 @@ export interface Subscription {
     short_rate_threshold_seconds?: number;
     /** Licensed recurring only, the `monthly_list_amount` that a renewal at the agreed amount keeps; see the order item. */
     monthly_list_amount?: string;
-    order_item_id?: string;
     coupon_id?: string;
     coupon?: ObjectIdentity;
     /** @minimum 0 */
     discounted_renewals_remaining?: number;
-    /** The operations currently prevented on the subscription, sorted; it is suspended while this contains `billing.subscriptions.use`. */
-    restrictions?: SubscriptionRestriction[];
-    billing_cycle_anchor?: string;
-    cancellation?: SubscriptionCancellation;
-    /** The accepted period-end change scheduled for this subscription; null when there is none. */
+    /** The order item that created it. */
+    order_item_id?: string;
+    cancellation?: SubscriptionItemCancellation;
+    /** The accepted period-end change scheduled for this item; null when there is none. */
     scheduled_change?: ScheduledChange | null;
+    created_at?: string;
     /**
-     * The saved payment method automatic renewal charges after balance and credits, before the account's default payment method. Set when a purchase, renewal or change is paid with a saved payment method. Used only while it belongs to the account paying the renewal.
+     * When the item's service started. Null until its delivery is confirmed.
      * @nullable
      */
-    default_payment_method_id?: string | null;
-    created_at?: string;
+    started_at?: string | null;
+    /**
+     * When the item ended, alone or with its subscription.
+     * @nullable
+     */
+    ended_at?: string | null;
+}
+/**
+ * A billing relationship that renews as a whole, as a Stripe subscription: one term, one renewal date, one
+ * automatic renewal setting and one service state for all of its items. The owning service decides which order
+ * lines form one subscription, such as a machine and the volumes and elastic IP bought with it; a resource bought
+ * on its own has its own. A purchase creates pending subscriptions and items whose IDs are returned on the order
+ * items and stay the same through checkout, delivery, renewals and changes.
+ *
+ * Pending and provisioning subscriptions grant no service. A subscription becomes provisioning when the owning
+ * service accepts the order, and active, or trialing during a free trial, when the service confirms delivery,
+ * which sets started_at; payment changes neither. Renewing buys further periods for every continuing licensed
+ * item at once; items cannot be renewed on their own, but each can be changed or canceled alone.
+ */
+export interface Subscription {
     id: string;
     /** The billing account that made the purchase. Renewals of a project subscription are charged to the project's current billing account. */
     billing_account_id: number;
     account: AccountIdentity;
-    product_id: ProductID;
+    product_id: ProductId;
+    product: Product;
     /**
      * The project it is for. Absent for an account-level purchase, such as a membership.
      * @nullable
@@ -1760,29 +1596,52 @@ export interface Subscription {
     project_id?: string | null;
     /** The project and its current name. Absent for an account-level purchase or when the project cannot be read; `project_id` still identifies it. */
     project?: NamedIdentity | null;
-    product: Product;
-    plan_id: string;
-    plan_name: string;
-    price_id: string;
-    quantity: string;
+    currency: string;
+    status: SubscriptionStatus;
+    /** The renewal term of its licensed items, `interval_count` intervals long; `none` when every item is metered. */
+    interval: SubscriptionInterval;
+    /** @minimum 1 */
+    interval_count?: number;
     /**
-     * When a licensed subscription renews or expires: the end of the last period bought, moved by renewing in advance. Null until the subscription becomes active, even when its purchase has been paid, and for metered subscriptions.
+     * When the subscription renews or expires: the end of the free trial or of the last period bought for its licensed items, moved by renewing in advance. Null until the subscription becomes active, even when its purchase has been paid, and when every item is metered.
      * @nullable
      */
     current_term_end?: string | null;
     /**
-     * Start of the service period in effect now. Null when none is, including for metered subscriptions.
+     * Start of the service period in effect now. Null when none is, including when every item is metered.
      * @nullable
      */
     current_period_start?: string | null;
     /**
-     * End of the service period in effect now; renewing in advance moves `current_term_end`, not this. Null when no period is in effect, including for metered subscriptions.
+     * End of the service period in effect now; renewing in advance moves `current_term_end`, not this. Null when no period is in effect, including when every item is metered.
      * @nullable
      */
     current_period_end?: string | null;
-    /** Whether a licensed subscription renews automatically. A metered subscription continues until it is canceled; for it this is true until a cancellation is requested, and cannot be set. */
+    billing_cycle_anchor?: string;
+    /** Whether the subscription renews automatically, or converts to paid when its free trial ends. Without licensed items it continues until it is canceled; then this is true until a cancellation is requested, and cannot be set. */
     auto_renew: boolean;
-    status: SubscriptionStatus;
+    /**
+     * Start of the free trial; null without one. During the trial the licensed items are free, while metered usage is charged as usual.
+     * @nullable
+     */
+    trial_start?: string | null;
+    /**
+     * End of the free trial; null without one. It is `current_term_end` until the first paid period is bought.
+     * @nullable
+     */
+    trial_end?: string | null;
+    /** How the free trial ends; null without one. */
+    trial_settings?: TrialSettings | null;
+    /** The operations currently prevented on the subscription, sorted; it is suspended while this contains `billing.subscriptions.use`. */
+    restrictions?: SubscriptionRestriction[];
+    /**
+     * The saved payment method automatic renewal charges after balance and credits, before the account's default payment method. Set when a purchase, renewal or change is paid with a saved payment method. Used only while it belongs to the account paying the renewal.
+     * @nullable
+     */
+    default_payment_method_id?: string | null;
+    /** Every item, ended ones included, oldest first. */
+    items: SubscriptionItem[];
+    created_at?: string;
     /**
      * When service started. Null until a new subscription becomes active, also after payment.
      * @nullable
@@ -1795,31 +1654,47 @@ export interface SubscriptionList {
     items: Subscription[];
     pagination: OffsetPagination;
 }
-export type RenewalPriceInterval = (typeof RenewalPriceInterval)[keyof typeof RenewalPriceInterval];
-export declare const RenewalPriceInterval: {
+export type RenewalOptionInterval = (typeof RenewalOptionInterval)[keyof typeof RenewalOptionInterval];
+export declare const RenewalOptionInterval: {
     readonly day: "day";
     readonly month: "month";
     readonly year: "year";
 };
-export interface RenewalPrice {
+/**
+ * What one item renews at under a renewal option.
+ */
+export interface RenewalOptionItem {
+    subscription_item_id: string;
+    /**
+     * The price the item renews at; null on the current option, which keeps the agreed amount.
+     * @nullable
+     */
+    price_id: string | null;
+    /** One period of this item, before tax and discounts. */
+    amount: Money;
     cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
     /** Refund policy `short_rate` only. */
     short_rate_multiplier?: string;
     /** Refund policy `short_rate` only. */
     short_rate_threshold_seconds?: number;
-    price_id: string;
-    /** How many periods one renewal covers. */
+}
+/**
+ * One term the whole subscription can renew for. Every continuing licensed item renews at it; items with an open cancellation end with the current term and are left out.
+ */
+export interface RenewalOption {
+    interval: RenewalOptionInterval;
+    /** How many intervals one renewal covers. */
     interval_count: number;
-    interval: RenewalPriceInterval;
-    /** What renewing for this term costs, for the quantity held. */
-    amount?: Money;
-    currency?: string;
-    /** The term the subscription renews at now; renewing for it keeps the agreed price. */
+    /** The term the subscription renews at now; renewing for it keeps every item's agreed price. */
     current: boolean;
+    /** One period for every item, before tax and discounts. */
+    amount: Money;
+    currency: string;
+    items: RenewalOptionItem[];
 }
-export interface RenewalPriceList {
-    items: RenewalPrice[];
+export interface RenewalOptionList {
+    items: RenewalOption[];
     pagination: OffsetPagination;
 }
 /**
@@ -1835,7 +1710,7 @@ export interface RenewRequest {
     /** The order ID, chosen by the caller. Creating it again conflicts; read the order after an unknown outcome. */
     order_id: string;
     /**
-     * How many further periods to buy, each at the price the subscription already renews at. To buy a longer term at its own price, give `interval` and `interval_count` instead.
+     * How many further periods to buy for every renewed item, each at the price it already renews at. To buy a longer term at its own price, give `interval` and `interval_count` instead.
      * @minimum 1
      */
     periods?: number;
@@ -1843,19 +1718,21 @@ export interface RenewRequest {
      * Renew for a term of this length instead, at the price currently sold for it. Give
      * `interval` with it.
      *
-     * Leaving both out renews at the price this item already bills at, which a later price
+     * Leaving both out renews every item at the price it already bills at, which a later price
      * change does not affect. Naming a term that differs from the current one is a fresh
-     * choice, so it is bought at today's price. Naming the current term changes nothing. A
-     * term sold at several prices that differ in cancellation policy is refused with 409
+     * choice, so every item is bought at today's price for that term, with its own cancellation
+     * policy or, without one, the only price of that term. Naming the current term changes
+     * nothing. A term an item does not sell is refused with 409 `BILLING_RENEWAL_PRICE_UNAVAILABLE`
+     * and `meta.subscription_item_id`; prices the rule cannot choose between, with 409
      * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` is given.
      *
-     * List the terms on offer with the renewal prices operation.
+     * List the terms on offer with the renewal options operation.
      * @minimum 1
      */
     interval_count?: number;
     /** The unit interval_count counts in. */
     interval?: RenewRequestInterval;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
+    /** With `interval` and `interval_count`, renews every item at its price of that term with this cancellation policy. */
     cancellation_policy?: CancellationPolicy;
     payment_method_id?: string;
     /** Whether to pay from the balance, with or without `payment_method_id`. */
@@ -1864,11 +1741,16 @@ export interface RenewRequest {
     use_credits?: boolean;
     return_url?: string;
 }
-export interface AutoRenewSet {
-    auto_renew: boolean;
+/**
+ * The settings to change; settings left out keep their values.
+ */
+export interface SubscriptionUpdate {
+    auto_renew?: boolean;
 }
 /**
- * `open`: waiting for you to complete checkout; nothing is ordered, invoiced or reserved. `complete`: the order and its issued invoice exist; read the order for payment and delivery. `expired`: ended without an order.
+ * "`open`: waiting for you to complete checkout; nothing is ordered, invoiced or reserved. `complete`:
+ * the order and its issued invoice exist; read the order for payment and delivery. `expired`: ended without an
+ * order."
  */
 export type CheckoutSessionStatus = (typeof CheckoutSessionStatus)[keyof typeof CheckoutSessionStatus];
 export declare const CheckoutSessionStatus: {
@@ -1877,7 +1759,8 @@ export declare const CheckoutSessionStatus: {
     readonly expired: "expired";
 };
 /**
- * `new` buys, `renew` extends a licensed subscription, `modify` changes a subscription's configuration or billing terms.
+ * "`new` buys, `renew` extends subscriptions, `modify` changes subscription items' configuration or
+ * billing terms."
  */
 export type CheckoutSessionType = (typeof CheckoutSessionType)[keyof typeof CheckoutSessionType];
 export declare const CheckoutSessionType: {
@@ -1894,6 +1777,16 @@ export declare const CheckoutSessionChangeEffective: {
     readonly immediate: "immediate";
     readonly period_end: "period_end";
 };
+/**
+ * "`complete`: tax is calculated for the billing account's invoice contact, or for `address` in a preview
+ * without an account. `requires_location_inputs`: a preview without an account or `address`, which leaves out
+ * tax that would be added; tax already contained in a price is included."
+ */
+export type CheckoutSessionTaxStatus = (typeof CheckoutSessionTaxStatus)[keyof typeof CheckoutSessionTaxStatus];
+export declare const CheckoutSessionTaxStatus: {
+    readonly complete: "complete";
+    readonly requires_location_inputs: "requires_location_inputs";
+};
 /**
  * automatic completes checkout with the purchase: the best applicable account discount is applied, and the
  * order is created with its invoice issued and paid from eligible credit grants and available balance.
@@ -1930,85 +1823,630 @@ export interface CheckoutOptions {
      * target; each client validates its own.
      * @maxLength 2048
      */
-    return_url?: string;
+    return_url?: string;
+    /**
+     * Turns on automatic renewal of every subscription with licensed items that the purchase opens. Off
+     * when omitted. It must be the customer's own choice. For a free trial, it converts the trial to paid
+     * when the trial ends.
+     */
+    auto_renew?: boolean;
+    /**
+     * A free trial grant of the paying billing account that the customer chose to use. The first new
+     * subscription of the purchase whose lines the grant's offer all covers, and that has a licensed line and
+     * no trial of its own, opens with the offer's free trial. Accepted only in automatic mode; with deferred it is refused with
+     * HTTP 400, and the grant is chosen when completing the checkout through Billing. Refused with
+     * BILLING_TRIAL_GRANT_INAPPLICABLE when no subscription qualifies or the grant cannot be used now.
+     */
+    trial_grant_id?: string;
+}
+export type CheckoutSessionDiscountType = (typeof CheckoutSessionDiscountType)[keyof typeof CheckoutSessionDiscountType];
+export declare const CheckoutSessionDiscountType: {
+    readonly promotion_code: "promotion_code";
+    readonly account_discount: "account_discount";
+};
+/**
+ * "Whether the discount continues on renewals of what is bought: `once` applies only to this
+ * purchase, `recurring` for `frequency_duration` periods including the first, `forever` on every renewal."
+ */
+export type CheckoutSessionDiscountFrequency = (typeof CheckoutSessionDiscountFrequency)[keyof typeof CheckoutSessionDiscountFrequency];
+export declare const CheckoutSessionDiscountFrequency: {
+    readonly once: "once";
+    readonly recurring: "recurring";
+    readonly forever: "forever";
+};
+/**
+ * "`confirmed`: every condition of the discount holds for the billing account. `unverified`: a preview
+ * without an account, where conditions that depend on the account, such as a first purchase or a per-account
+ * limit, are checked only when a session is completed."
+ */
+export type CheckoutSessionDiscountEligibility = (typeof CheckoutSessionDiscountEligibility)[keyof typeof CheckoutSessionDiscountEligibility];
+export declare const CheckoutSessionDiscountEligibility: {
+    readonly confirmed: "confirmed";
+    readonly unverified: "unverified";
+};
+/**
+ * The discount a session gets. It is redeemed only when the session completes.
+ */
+export interface CheckoutSessionDiscount {
+    type: CheckoutSessionDiscountType;
+    name: string;
+    /**
+     * Code text for a promotion_code discount; null for an account_discount.
+     * @minLength 1
+     * @maxLength 64
+     * @nullable
+     */
+    promotion_code: string | null;
+    /**
+     * "Whether the discount continues on renewals of what is bought: `once` applies only to this
+     * purchase, `recurring` for `frequency_duration` periods including the first, `forever` on every renewal."
+     */
+    frequency: CheckoutSessionDiscountFrequency;
+    /**
+     * For `recurring`, the periods the discount lasts; null otherwise.
+     * @minimum 1
+     * @nullable
+     */
+    frequency_duration: number | null;
+    /**
+     * "`confirmed`: every condition of the discount holds for the billing account. `unverified`: a preview
+     * without an account, where conditions that depend on the account, such as a first purchase or a per-account
+     * limit, are checked only when a session is completed."
+     */
+    eligibility: CheckoutSessionDiscountEligibility;
+}
+/**
+ * The terms of a free trial. The licensed items of the subscription it is used for are free for `trial_period_days`, while metered usage is charged as usual. When the trial ends it converts to paid if automatic renewal is on; otherwise `trial_settings` applies.
+ */
+export interface TrialOffer {
+    id: string;
+    name: string;
+    description: string;
+    /**
+     * @minimum 1
+     * @maximum 730
+     */
+    trial_period_days: number;
+    trial_settings: TrialSettings;
+    /** The purchases it can be used for. Every line of the subscription must be covered. */
+    applies_to: Applicability;
+}
+/**
+ * `scheduled` before valid_from, `available` to be chosen at checkout, `redeemed` once used for a subscription, `expired` after valid_until without being used, or `voided` once withdrawn.
+ */
+export type TrialGrantStatus = (typeof TrialGrantStatus)[keyof typeof TrialGrantStatus];
+export declare const TrialGrantStatus: {
+    readonly scheduled: "scheduled";
+    readonly available: "available";
+    readonly redeemed: "redeemed";
+    readonly expired: "expired";
+    readonly voided: "voided";
+};
+/**
+ * One free trial held by a billing account for a period. It is used for one subscription; if the order it was used for is canceled or fails, it can be used again while it is valid.
+ */
+export interface TrialGrant {
+    id: string;
+    billing_account_id: number;
+    trial_offer: TrialOffer;
+    status: TrialGrantStatus;
+    valid_from: string;
+    /**
+     * Null when the grant does not expire.
+     * @nullable
+     */
+    valid_until: string | null;
+    /** @nullable */
+    voided_at: string | null;
+    /**
+     * The order the grant was used for; null until it is used.
+     * @nullable
+     */
+    order_id: string | null;
+    /**
+     * The subscription the grant was used for; null until it is used.
+     * @nullable
+     */
+    subscription_id: string | null;
+    /** @nullable */
+    redeemed_at: string | null;
+}
+/**
+ * Settings of a subscription a purchase opens, as Stripe Checkout's subscription_data.
+ */
+export interface SubscriptionData {
+    /**
+     * A free trial of this many days; null without one or when given as `trial_end`.
+     * @minimum 1
+     * @maximum 730
+     * @nullable
+     */
+    trial_period_days: number | null;
+    /**
+     * The end of the free trial; null without one or when given in days.
+     * @nullable
+     */
+    trial_end: string | null;
+    /** How the free trial ends; null without a trial. */
+    trial_settings: TrialSettings | null;
+}
+/**
+ * A free trial a subscription opens with. Its licensed items are free until `trial_end`; metered usage is
+ * charged as usual. For an open session the times are as if it were completed now.
+ */
+export interface CheckoutSessionTrial {
+    trial_start: string;
+    trial_end: string;
+    trial_settings: TrialSettings;
+}
+/**
+ * The term every item of the subscription renews for, for renewals; `none` otherwise.
+ */
+export type CheckoutSessionSubscriptionInterval = (typeof CheckoutSessionSubscriptionInterval)[keyof typeof CheckoutSessionSubscriptionInterval];
+export declare const CheckoutSessionSubscriptionInterval: {
+    readonly none: "none";
+    readonly day: "day";
+    readonly month: "month";
+    readonly year: "year";
+};
+/**
+ * The billing period of a recurring licensed price; `none` otherwise, and when `price_id` is null.
+ */
+export type CheckoutSessionItemInterval = (typeof CheckoutSessionItemInterval)[keyof typeof CheckoutSessionItemInterval];
+export declare const CheckoutSessionItemInterval: {
+    readonly none: "none";
+    readonly day: "day";
+    readonly month: "month";
+    readonly year: "year";
+};
+/**
+ * What an immediate downgrade would refund, estimated as of `proration_date`. The refund itself is determined
+ * when the change takes effect.
+ */
+export interface CheckoutSessionItemDowngradeRefund {
+    /** Returned to the original payment sources, tax paid on it included. */
+    refundable_amount: Money;
+    /** Before tax, the part of the excess that the item's refund terms do not return. */
+    forfeited_amount: Money;
+}
+/**
+ * The dimension values of what is bought, such as region and instance type.
+ */
+export type CheckoutSessionItemDimensions = {
+    [key: string]: string;
+};
+/**
+ * One item of the session; it becomes the order item at the same position. Its price is selected as when
+ * checkout completes, and amounts are this item's share of the session's.
+ */
+export interface CheckoutSessionItem {
+    /**
+     * Counted across the session's subscriptions in order, starting from zero.
+     * @minimum 0
+     */
+    position: number;
+    /**
+     * The subscription item changed or renewed. Null for an item the purchase adds.
+     * @nullable
+     */
+    subscription_item_id: string | null;
+    product_id: ProductId;
+    plan_id: string;
+    plan_name: string;
+    /**
+     * The price the item is charged under: the one it named, or the one selected by billing terms or from the
+     * subscription item changed or renewed. Null for an expired session whose item did not name one.
+     * @nullable
+     */
+    price_id: string | null;
+    /** The price type; null when `price_id` is. */
+    type: PriceType | null;
+    /** The usage type; null when `price_id` is. */
+    usage_type: UsageType | null;
+    /** The billing period of a recurring licensed price; `none` otherwise, and when `price_id` is null. */
+    interval: CheckoutSessionItemInterval;
+    /**
+     * Periods per billing cycle of a recurring licensed price; null otherwise.
+     * @minimum 1
+     * @nullable
+     */
+    interval_count: number | null;
+    quantity: string;
+    /** The dimension values of what is bought, such as region and instance type. */
+    dimensions: CheckoutSessionItemDimensions;
+    /**
+     * Renewals only; null otherwise. How many consecutive periods are renewed.
+     * @minimum 1
+     * @nullable
+     */
+    periods: number | null;
+    /** Unit price before discounts. Null when no single unit price applies, such as tiered or multiple-rate pricing. */
+    unit_amount: Money | null;
+    /** The setup charge already included in `amount`; null when none applies. */
+    setup_amount: Money | null;
+    /**
+     * Recurring licensed items only; null otherwise. What each later period renews at, before discounts and
+     * tax, which differs from `amount` when the first period is priced differently, such as in a free trial. The
+     * session's `discount` says whether its discount continues on renewals.
+     */
+    recurring_amount: Money | null;
+    /** Amount before discounts, including any setup charge. */
+    amount: Money | null;
+    /** Total reduction on this item, including any continuing renewal discount. */
+    discount_amount: Money | null;
+    /** Tax on the discounted amount, including any tax already contained in that amount. */
+    tax_amount: Money | null;
+    /** The part of tax_amount already contained in amount minus discount_amount. */
+    tax_included_amount: Money | null;
+    /** amount minus discount_amount plus tax_amount minus tax_included_amount. */
+    total: Money | null;
+    /**
+     * Immediate changes only; null otherwise. Before tax, the new terms for the time from `proration_date` to
+     * the end of the paid period. An upgrade invoices `remaining_amount` minus `unused_amount`.
+     */
+    remaining_amount: Money | null;
+    /**
+     * Immediate changes only; null otherwise. Before tax, for an upgrade or an unchanged period price, the
+     * amount paid for that time, up to the new terms' value for the same time; for a downgrade, the remaining value
+     * of what was paid, under the refund terms of each paid period.
+     */
+    unused_amount: Money | null;
+    /** Immediate downgrades only, when `unused_amount` exceeds `remaining_amount`; null otherwise. */
+    downgrade_refund: CheckoutSessionItemDowngradeRefund | null;
+}
+/**
+ * One subscription of the session and its items, with its share of the session's amounts.
+ */
+export interface CheckoutSessionSubscription {
+    /**
+     * The existing subscription renewed or changed, or that new items are added to. Null for a subscription the purchase opens.
+     * @nullable
+     */
+    subscription_id: string | null;
+    /** The settings the owning service gave a subscription the purchase opens; null without any. */
+    subscription_data: SubscriptionData | null;
+    /**
+     * The free trial grant this subscription uses, saved on an open session or used by a complete one; null otherwise.
+     * @nullable
+     */
+    trial_grant_id: string | null;
+    /** The free trial the subscription opens with, from `subscription_data` or the trial grant. Null without one, and for an expired session. */
+    trial: CheckoutSessionTrial | null;
+    /** The term every item of the subscription renews for, for renewals; `none` otherwise. */
+    interval: CheckoutSessionSubscriptionInterval;
+    /**
+     * Renewals only; null otherwise.
+     * @minimum 1
+     * @nullable
+     */
+    interval_count: number | null;
+    /**
+     * Renewals only; null otherwise. How many consecutive terms are renewed.
+     * @minimum 1
+     * @nullable
+     */
+    periods: number | null;
+    /** The items' amounts before discounts, including any setup charge. */
+    amount: Money | null;
+    discount_amount: Money | null;
+    /** Tax on the discounted amount, including any tax already contained in it. */
+    tax_amount: Money | null;
+    /** The part of `tax_amount` already contained in `amount` minus `discount_amount`. */
+    tax_included_amount: Money | null;
+    /** amount minus discount_amount plus tax_amount minus tax_included_amount; this subscription's share of the session's `total`. */
+    total: Money | null;
+    /** The subscription's items, in order. */
+    items: CheckoutSessionItem[];
+}
+/**
+ * A purchase, a change of subscriptions or their renewal, waiting for checkout to be completed, and what
+ * completing it invoices. Completing it applies the choices saved on it and creates the order with its invoice
+ * issued; the order carries the session's ID. A preview returns the same object without saving it.
+ *
+ * Amounts are what completing an open session would invoice at the time it is read, and for a complete session
+ * those of its order's invoice. An expired session has no amounts; they are null.
+ */
+export interface CheckoutSession {
+    /**
+     * Null in a preview.
+     * @nullable
+     */
+    id: string | null;
+    product_id: ProductId;
+    /**
+     * Null in a preview without an account.
+     * @nullable
+     */
+    billing_account_id: number | null;
+    /** Null in a preview without an account. */
+    account: AccountIdentity | null;
+    /**
+     * The project the purchase is for. Null for an account-level purchase, such as a membership, and in a preview.
+     * @nullable
+     */
+    project_id: string | null;
+    /**
+     * The project and its current name. Null when `project_id` is, or when the project cannot be read;
+     * `project_id` still identifies it.
+     */
+    project: NamedIdentity | null;
+    /**
+     * "`new` buys, `renew` extends subscriptions, `modify` changes subscription items' configuration or
+     * billing terms."
+     */
+    type: CheckoutSessionType;
+    /** When a change takes effect, as on the order it creates; `none` for anything that is not a change. */
+    change_effective: CheckoutSessionChangeEffective;
+    /** `open` in a preview. */
+    status: CheckoutSessionStatus;
+    currency: string;
+    /**
+     * The checkout choices, as the purchase gave them and as you saved them since. Billing does not check
+     * `return_url`; validate it before navigating.
+     */
+    checkout: CheckoutOptions;
+    /**
+     * The promotion code saved on the session, or used to complete it; null without one.
+     * @nullable
+     */
+    promotion_code: string | null;
+    /** The discount the session gets, from its promotion code or otherwise the best applicable account discount. Null when there is none, and for an expired session. */
+    discount: CheckoutSessionDiscount | null;
+    /** Sum before discounts, excluding tax already included in the item amounts. */
+    subtotal: Money | null;
+    /** Total item discounts. */
+    discount_amount: Money | null;
+    /** Total tax on the discounted amounts. */
+    tax_amount: Money | null;
+    /** subtotal minus discount_amount plus tax_amount, before credit grants and balance. Confirm an open session with it as `expected_amount`. */
+    total: Money | null;
+    /**
+     * "`complete`: tax is calculated for the billing account's invoice contact, or for `address` in a preview
+     * without an account. `requires_location_inputs`: a preview without an account or `address`, which leaves out
+     * tax that would be added; tax already contained in a price is included."
+     */
+    tax_status: CheckoutSessionTaxStatus;
+    /**
+     * Immediate changes and items added to an existing subscription of an open session only; null otherwise.
+     * The instant they are priced from; confirm the session with it so it is priced from the same instant.
+     * @nullable
+     */
+    proration_date: string | null;
+    /** Account funds for completing an open session; null for other sessions and without an account. */
+    funds: Funds | null;
+    /**
+     * The free trial grants of the account that the session can use now, soonest to expire first. Empty for a
+     * session that is not open, without an account, and for changes and renewals.
+     */
+    trial_grants: TrialGrant[];
+    /**
+     * When an open session expires; null in a preview. The order a complete session created has its own payment deadline.
+     * @nullable
+     */
+    expires_at: string | null;
+    /**
+     * Null in a preview.
+     * @nullable
+     */
+    created_at: string | null;
+    /** @nullable */
+    completed_at: string | null;
+    /** @nullable */
+    expired_at: string | null;
+    /**
+     * The order created when the session completed. Null otherwise.
+     * @nullable
+     */
+    order_id: string | null;
+    /** The subscriptions the session buys, renews or changes, in order, each with its items. */
+    subscriptions: CheckoutSessionSubscription[];
+}
+export interface CheckoutSessionList {
+    items: CheckoutSession[];
+    pagination: OffsetPagination;
+}
+/**
+ * Settings of a subscription a previewed purchase opens, as the owning service would give them.
+ */
+export interface SubscriptionDataInput {
+    /**
+     * Give this or `trial_end`, not both.
+     * @minimum 1
+     * @maximum 730
+     */
+    trial_period_days?: number;
+    trial_end?: string;
+    trial_settings?: TrialSettings;
+}
+/**
+ * `new` previews a purchase, `modify` a change of subscription items, `renew` a renewal.
+ */
+export type CheckoutSessionPreviewRequestType = (typeof CheckoutSessionPreviewRequestType)[keyof typeof CheckoutSessionPreviewRequestType];
+export declare const CheckoutSessionPreviewRequestType: {
+    readonly new: "new";
+    readonly renew: "renew";
+    readonly modify: "modify";
+};
+/**
+ * For `modify` only; defaults to `immediate`. `immediate` prices the rest of the paid period from
+ * `proration_date`, charging an upgrade the difference and showing what a downgrade refunds. `period_end`
+ * prices the first period at the new terms, which replaces the renewal when the paid period ends.
+ */
+export type CheckoutSessionPreviewRequestChangeEffective = (typeof CheckoutSessionPreviewRequestChangeEffective)[keyof typeof CheckoutSessionPreviewRequestChangeEffective];
+export declare const CheckoutSessionPreviewRequestChangeEffective: {
+    readonly immediate: "immediate";
+    readonly period_end: "period_end";
+};
+/**
+ * For `renew` only, as in creating a renewal Checkout Session.
+ */
+export type CheckoutSessionPreviewRequestInterval = (typeof CheckoutSessionPreviewRequestInterval)[keyof typeof CheckoutSessionPreviewRequestInterval];
+export declare const CheckoutSessionPreviewRequestInterval: {
+    readonly day: "day";
+    readonly month: "month";
+    readonly year: "year";
+};
+/**
+ * Where a customer is, for the tax that would be added there.
+ */
+export interface CustomerAddress {
+    /**
+     * ISO 3166-1 alpha-2, two uppercase letters.
+     * @pattern ^[A-Z]{2}$
+     */
+    country: string;
+    /**
+     * The state or province, as the tax rates name it.
+     * @minLength 1
+     * @maxLength 128
+     */
+    state?: string;
+}
+export type CheckoutSessionItemInputInterval = (typeof CheckoutSessionItemInputInterval)[keyof typeof CheckoutSessionItemInputInterval];
+export declare const CheckoutSessionItemInputInterval: {
+    readonly none: "none";
+    readonly day: "day";
+    readonly month: "month";
+    readonly year: "year";
+};
+/**
+ * The dimension values of what is bought, such as region and instance type, or after a change, given in full. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to.
+ */
+export type CheckoutSessionItemInputDimensions = {
+    [key: string]: string;
+};
+/**
+ * Identify a price, or select one for a plan; give each resource's ID or lookup key, never both, and
+ * product_id with lookup keys. A change names its `subscription_item_id`; without a price or billing terms the
+ * plan's price with the item's price type, usage type, interval, interval count and cancellation policy is
+ * selected, and omitted dimensions keep the item's. A metered item includes only any setup charge; its usage is
+ * estimated with `estimate-usage`.
+ */
+export interface CheckoutSessionItemInput {
+    /** For `modify` only. The subscription item changed. */
+    subscription_item_id?: string;
+    /**
+     * @minLength 1
+     * @maxLength 128
+     */
+    price_lookup_key?: string;
+    /**
+     * @minLength 1
+     * @maxLength 128
+     */
+    plan_lookup_key?: string;
+    price_id?: string;
+    product_id?: ProductId;
+    plan_id?: string;
+    /** Narrows the selection when a plan offers more than one price type. */
+    price_type?: PriceType;
+    /** Narrows the selection when a plan offers more than one usage type. */
+    usage_type?: UsageType;
+    interval?: CheckoutSessionItemInputInterval;
+    /** @minimum 1 */
+    interval_count?: number;
+    /** Selects among licensed prices with otherwise identical billing terms. Ambiguous terms are refused instead of choosing a price arbitrarily. */
+    cancellation_policy?: CancellationPolicy;
+    /**
+     * The quantity bought, or after a change.
+     * @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$
+     */
+    quantity: string;
+    /** The dimension values of what is bought, such as region and instance type, or after a change, given in full. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to. */
+    dimensions?: CheckoutSessionItemInputDimensions;
+}
+/**
+ * One subscription of the previewed session. For `new`, give its items, with `subscription_id` to add them to
+ * that existing subscription and otherwise optionally `subscription_data`; for `modify`, the subscription and the
+ * items changed; for `renew`, only the subscription.
+ */
+export interface CheckoutSessionPreviewSubscription {
+    subscription_id?: string;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    items?: CheckoutSessionItemInput[];
+    subscription_data?: SubscriptionDataInput;
 }
 /**
- * A purchase waiting for you to complete checkout. Completing it applies the discount and creates the order with its invoice issued; the order carries the session's ID.
+ * The session to preview, as it would be created. Give exactly one of `billing_account_id` and `currency`;
+ * changes, renewals, items added to an existing subscription and trial grants need the account. A request that
+ * does not fit `type` fails with `BILLING_PURCHASE_INVALID` and the field.
  */
-export interface CheckoutSession {
-    id: string;
-    product_id: ProductID;
-    billing_account_id: number;
-    account: AccountIdentity;
+export interface CheckoutSessionPreviewRequest {
+    /** `new` previews a purchase, `modify` a change of subscription items, `renew` a renewal. */
+    type: CheckoutSessionPreviewRequestType;
     /**
-     * The project the purchase is for. Null for an account-level purchase, such as a membership.
-     * @nullable
+     * The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Subscriptions changed or renewed must currently be paid by it.
+     * @minimum 1
      */
-    project_id: string | null;
-    /** The project and its current name. Null for an account-level purchase or when the project cannot be read; `project_id` still identifies it. */
-    project: NamedIdentity | null;
-    /** `new` buys, `renew` extends a licensed subscription, `modify` changes a subscription's configuration or billing terms. */
-    type: CheckoutSessionType;
-    /** When a change takes effect, as on the order it creates; `none` for anything that is not a change. */
-    change_effective: CheckoutSessionChangeEffective;
-    status: CheckoutSessionStatus;
-    currency: string;
-    /** The checkout choices as the purchase gave them. Billing does not check `return_url`; validate it before navigating. */
-    checkout: CheckoutOptions;
-    /** When an open session expires. The order a complete session created has its own payment deadline. */
-    expires_at: string;
-    created_at: string;
-    /** @nullable */
-    completed_at: string | null;
-    /** @nullable */
-    expired_at: string | null;
+    billing_account_id?: number;
     /**
-     * The order created when the session completed. Null otherwise.
-     * @nullable
+     * For `new` only. The ISO 4217 currency to price in without an account.
+     * @minLength 3
+     * @maxLength 3
      */
-    order_id: string | null;
-}
-export interface CheckoutSessionList {
-    items: CheckoutSession[];
-    pagination: OffsetPagination;
+    currency?: string;
+    /**
+     * Only with `currency`. Where the customer is, to include the tax that would be added there for a customer
+     * who is not tax exempt; `tax_status` is then `complete`. Refused with `billing_account_id`, whose invoice
+     * contact decides tax.
+     */
+    address?: CustomerAddress;
+    /**
+     * For `modify` only; defaults to `immediate`. `immediate` prices the rest of the paid period from
+     * `proration_date`, charging an upgrade the difference and showing what a downgrade refunds. `period_end`
+     * prices the first period at the new terms, which replaces the renewal when the paid period ends.
+     */
+    change_effective?: CheckoutSessionPreviewRequestChangeEffective;
+    /**
+     * At most 100 items in all for `new` and `modify`, and each subscription at most once for `renew`.
+     * @minItems 1
+     * @maxItems 100
+     */
+    subscriptions: CheckoutSessionPreviewSubscription[];
+    /**
+     * For `renew` only, as in creating a renewal Checkout Session.
+     * @minimum 1
+     */
+    periods?: number;
+    /**
+     * For `renew` only, as in creating a renewal Checkout Session.
+     * @minimum 1
+     */
+    interval_count?: number;
+    /** For `renew` only, as in creating a renewal Checkout Session. */
+    interval?: CheckoutSessionPreviewRequestInterval;
+    /** For `renew` only, as in creating a renewal Checkout Session. */
+    cancellation_policy?: CancellationPolicy;
+    /**
+     * For `new` and `modify`. Evaluated without being applied.
+     * @minLength 1
+     * @maxLength 64
+     */
+    promotion_code?: string;
+    /** For `new` with `billing_account_id`. A free trial grant of the account to preview the purchase with. */
+    trial_grant_id?: string;
 }
 /**
- * The dimension values of what is bought, such as region and instance type.
- */
-export type CheckoutSessionItemDimensions = {
-    [key: string]: string;
-};
-/**
- * One item of the session. It becomes the order item at the same position; its price is chosen when checkout completes.
+ * Give at least one choice. Saving a choice equal to the current one changes nothing.
  */
-export interface CheckoutSessionItem {
-    /** @minimum 0 */
-    position: number;
-    plan_id: string;
-    plan_name: string;
+export interface CheckoutSessionUpdate {
     /**
-     * The price the item named. Null when Billing selects it by billing terms or from the subscription being changed or renewed.
-     * @nullable
-     */
-    price_id: string | null;
-    quantity: string;
-    /** The dimension values of what is bought, such as region and instance type. */
-    dimensions: CheckoutSessionItemDimensions;
-    /**
-     * The subscription changed or renewed. Null for a new purchase.
+     * The promotion code to complete the session with; null removes it, and the best applicable account discount applies instead.
+     * @minLength 1
+     * @maxLength 64
      * @nullable
      */
-    subscription_id: string | null;
+    promotion_code?: string | null;
     /**
-     * Renewals only; null otherwise. How many consecutive periods are renewed.
-     * @minimum 1
+     * A free trial grant of the session's billing account to use; null removes it.
      * @nullable
      */
-    periods: number | null;
-}
-export interface CheckoutSessionItemList {
-    items: CheckoutSessionItem[];
-    pagination: OffsetPagination;
+    trial_grant_id?: string | null;
+    /** Turns on or off automatic renewal of every subscription with licensed items the session opens. It must be your own choice. */
+    auto_renew?: boolean;
 }
 /**
  * As in renewing.
@@ -2020,12 +2458,23 @@ export declare const CheckoutSessionCreateInterval: {
     readonly year: "year";
 };
 /**
- * The subscription to renew, and its periods and price chosen as in renewing.
+ * One subscription to renew.
+ */
+export interface CheckoutSessionSubscriptionInput {
+    subscription_id: string;
+}
+/**
+ * The subscriptions to renew together, and the periods and price chosen as in renewing, applied to each.
  */
 export interface CheckoutSessionCreate {
     /** Chosen by the caller. Creating it again conflicts; read the session after an unknown outcome. */
     checkout_session_id: string;
-    subscription_id: string;
+    /**
+     * Each subscription at most once.
+     * @minItems 1
+     * @maxItems 20
+     */
+    subscriptions: CheckoutSessionSubscriptionInput[];
     /**
      * As in renewing.
      * @minimum 1
@@ -2042,15 +2491,13 @@ export interface CheckoutSessionCreate {
     cancellation_policy?: CancellationPolicy;
 }
 export interface CheckoutSessionConfirm {
+    /** The session's `total` as read, after discounts and tax and before credit grants or balance. */
+    expected_amount: Money & string;
     /**
-     * As quoted. Omit to apply the best applicable account discount.
-     * @minLength 1
-     * @maxLength 64
+     * Immediate changes and items added to an existing subscription only. The session's `proration_date` as
+     * read; it must be a whole second, not in the future and at most 10 minutes old, otherwise the request is
+     * refused with `BILLING_CHANGE_INVALID`. Defaults to the time of the request.
      */
-    promotion_code?: string;
-    /** The quote's `total`, after discounts and tax and before credit grants or balance. */
-    expected_amount: Money & string;
-    /** Immediate changes only. The quote's `proration_date`; it must be a whole second, not in the future and at most 10 minutes old, otherwise the request is refused with `BILLING_CHANGE_INVALID`. Defaults to the time of the request. */
     proration_date?: string;
 }
 /**
@@ -2101,7 +2548,7 @@ export interface PaidWith {
     last4?: string;
 }
 /**
- * `new` buys, `renew` extends a licensed subscription, `modify` changes a subscription's configuration or billing terms.
+ * `new` buys, `renew` extends subscriptions, `modify` changes subscription items' configuration or billing terms.
  */
 export type OrderType = (typeof OrderType)[keyof typeof OrderType];
 export declare const OrderType: {
@@ -2110,7 +2557,7 @@ export declare const OrderType: {
     readonly modify: "modify";
 };
 /**
- * When a plan change takes effect; `none` for anything that is not a change. A `period_end` order stays pending until the first period at the new price is paid. That period is invoiced when the order is created and starts when the current paid period ends; if the invoice is unpaid by then, the order is canceled and the subscription renews or ends as usual.
+ * When a plan change takes effect; `none` for anything that is not a change. A `period_end` order stays pending until the first period at the new price is paid. That period is invoiced when the order is created and starts when the current paid period ends; if the invoice is unpaid by then, the order is canceled and the item renews or ends with its subscription as usual.
  */
 export type OrderChangeEffective = (typeof OrderChangeEffective)[keyof typeof OrderChangeEffective];
 export declare const OrderChangeEffective: {
@@ -2126,7 +2573,7 @@ export declare const OrderItemInterval: {
     readonly year: "year";
 };
 /**
- * `pending`: waiting to be set up. `completed`: set up, as confirmed by the service. `failed`: not set up; its amount was refunded to the original payment sources. `canceled`: withdrawn without delivery; any collected amount is returned. A completed item ends when its subscription is canceled.
+ * `pending`: waiting to be set up. `completed`: set up, as confirmed by the service. `failed`: not set up; its amount was refunded to the original payment sources. `canceled`: withdrawn without delivery; any collected amount is returned. A completed item ends when its subscription item is canceled.
  */
 export type OrderItemStatus = (typeof OrderItemStatus)[keyof typeof OrderItemStatus];
 export declare const OrderItemStatus: {
@@ -2145,7 +2592,7 @@ export type OrderItemDimensions = {
     [key: string]: string;
 };
 /**
- * The purchase terms frozen at placement. Monetary fields come from the order's invoice lines and are zero without an immediate charge, such as for a metered purchase. Later catalog changes do not reprice the line. A new service purchase has its pending subscription from placement.
+ * The purchase terms frozen at placement. Monetary fields come from the order's invoice lines and are zero without an immediate charge, such as for a metered purchase. Later catalog changes do not reprice the line. A new service purchase has its pending subscription and subscription item from placement.
  */
 export interface OrderItem {
     /** Whether new account discounts may apply to future renewals. A fixed operator renewal agreement disables automatic discounts; catalog repricing or a newly selected purchase agreement enables them. */
@@ -2155,8 +2602,10 @@ export interface OrderItem {
     /** @minimum 0 */
     position?: number;
     configuration?: OrderItemConfiguration;
-    /** The Billing subscription: the new pending subscription of a recurring purchase, or the existing one renewed or changed, which keeps its ID. Absent for a purchase without a subscription. */
+    /** The Billing subscription the line belongs to: a new pending one, the existing one an added item joins, or the one renewed or changed, which keeps its ID. Absent for a purchase without a subscription. */
     subscription_id?: string;
+    /** The subscription item the line created, renewed or changed, which keeps its ID. Absent for a purchase without a subscription. */
+    subscription_item_id?: string;
     interval: OrderItemInterval;
     /** @minimum 1 */
     interval_count?: number;
@@ -2190,7 +2639,7 @@ export interface OrderItem {
     id: string;
     order_id?: string;
     price_id: string;
-    product_id?: ProductID;
+    product_id?: ProductId;
     product?: Product;
     /** Which plan was bought. */
     plan_id: string;
@@ -2253,10 +2702,10 @@ export interface Order {
     /** The billing account the order was placed with, unchanged when the project is later linked to another account. While it is suspended or closed, the order cannot be accepted, and a period-end change is called off when the current period ends; such requests fail with `BILLING_ACCOUNT_UNAVAILABLE`. */
     billing_account_id?: number;
     currency: string;
-    /** `new` buys, `renew` extends a licensed subscription, `modify` changes a subscription's configuration or billing terms. */
+    /** `new` buys, `renew` extends subscriptions, `modify` changes subscription items' configuration or billing terms. */
     type: OrderType;
     status: OrderStatus;
-    /** When a plan change takes effect; `none` for anything that is not a change. A `period_end` order stays pending until the first period at the new price is paid. That period is invoiced when the order is created and starts when the current paid period ends; if the invoice is unpaid by then, the order is canceled and the subscription renews or ends as usual. */
+    /** When a plan change takes effect; `none` for anything that is not a change. A `period_end` order stays pending until the first period at the new price is paid. That period is invoiced when the order is created and starts when the current paid period ends; if the invoice is unpaid by then, the order is canceled and the item renews or ends with its subscription as usual. */
     change_effective?: OrderChangeEffective;
     /**
      * Acceptance deadline; a pending order expires after it.
@@ -2347,6 +2796,10 @@ export interface DiscountList {
     items: Discount[];
     pagination: OffsetPagination;
 }
+export interface TrialGrantList {
+    items: TrialGrant[];
+    pagination: OffsetPagination;
+}
 export interface OrderItemList {
     items: OrderItem[];
     pagination: OffsetPagination;
@@ -2376,6 +2829,9 @@ export declare const AllowanceStatus: {
 export interface Allowance {
     /** Optional issuance key, unique within this billing account. */
     idempotency_key?: string;
+    /** The subscription item whose purchase includes the allowance; absent for an allowance not included in a purchase. */
+    subscription_item_id?: string;
+    /** The subscription that item belongs to. */
     subscription_id?: string;
     id: string;
     billing_account_id?: number;
@@ -2443,7 +2899,7 @@ export interface Entitlement {
     name?: string;
     enabled: boolean;
     /**
-     * When the providing subscription ends. Absent for a metered subscription.
+     * When the providing subscription item ends with its current term. Absent for a metered item.
      * @nullable
      */
     expires_at?: string | null;
@@ -2467,7 +2923,7 @@ export interface Plan {
     product: Product;
     features: PlanFeature[];
     id: string;
-    product_id: ProductID;
+    product_id: ProductId;
     name: string;
     description?: string;
 }
@@ -2573,7 +3029,7 @@ export interface Price {
     short_rate_multiplier?: string;
     /** Refund policy `short_rate` only, how long after the period start `short_rate_multiplier` applies. */
     short_rate_threshold_seconds?: number;
-    product_id?: ProductID;
+    product_id?: ProductId;
     id: string;
     plan_id: string;
     currency: string;
@@ -2602,50 +3058,6 @@ export interface PriceList {
     items: Price[];
     pagination: OffsetPagination;
 }
-export type QuoteItemInputInterval = (typeof QuoteItemInputInterval)[keyof typeof QuoteItemInputInterval];
-export declare const QuoteItemInputInterval: {
-    readonly none: "none";
-    readonly day: "day";
-    readonly month: "month";
-    readonly year: "year";
-};
-/**
- * The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to.
- */
-export type QuoteItemInputDimensions = {
-    [key: string]: string;
-};
-/**
- * Identify a price, or select one for a plan; give each resource's ID or lookup key, never both, and product_id with lookup keys. A metered item includes only any setup charge; its usage is estimated with `estimate-usage`.
- */
-export interface QuoteItemInput {
-    /**
-     * @minLength 1
-     * @maxLength 128
-     */
-    price_lookup_key?: string;
-    /**
-     * @minLength 1
-     * @maxLength 128
-     */
-    plan_lookup_key?: string;
-    price_id?: string;
-    product_id?: ProductID;
-    plan_id?: string;
-    /** Narrows the selection when a plan offers more than one price type. */
-    price_type?: PriceType;
-    /** Narrows the selection when a plan offers more than one usage type. */
-    usage_type?: UsageType;
-    interval?: QuoteItemInputInterval;
-    /** @minimum 1 */
-    interval_count?: number;
-    /** Selects among licensed prices with otherwise identical billing terms. Ambiguous terms are refused instead of choosing a price arbitrarily. */
-    cancellation_policy?: CancellationPolicy;
-    /** @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$ */
-    quantity: string;
-    /** The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to. */
-    dimensions?: QuoteItemInputDimensions;
-}
 /**
  * The values of the meter's presentation dimensions, present only when grouped by meter.
  */
@@ -2694,7 +3106,9 @@ export interface ActiveResource {
     ended_at?: string;
     suspended_at?: string;
     state_changed_at?: string;
-    /** The metered subscription charged for this metering record. */
+    /** The metered subscription item charged for this metering record. */
+    subscription_item_id: string;
+    /** The subscription the item belongs to. */
     subscription_id: string;
     resource_id: string;
     product: Product;
@@ -2716,7 +3130,7 @@ export interface ActiveResourceList {
     pagination: OffsetPagination;
 }
 /**
- * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed cancellation terms. Nothing is refunded by the quote; the amount is fixed when cancellation or termination is confirmed.
+ * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed cancellation terms. Nothing is refunded by the preview; the amount is fixed when cancellation or termination is confirmed.
  */
 export interface OrderRefundPreview {
     order_id: string;
@@ -2735,7 +3149,7 @@ export type UsageEstimateInputDimensions = {
  * Future usage of one metered price. Give the price, or the plan to use its metered price in the currency, and the meter that measures the usage; give each resource's ID or lookup key, never both, and product_id with lookup keys.
  */
 export interface UsageEstimateInput {
-    product_id?: ProductID;
+    product_id?: ProductId;
     plan_id?: string;
     /**
      * @minLength 1
@@ -2807,118 +3221,6 @@ export interface UsageEstimate {
     /** One per request item, in request order. */
     items: UsageEstimateItem[];
 }
-/**
- * When the changes take effect; defaults to `immediate`. `immediate` prices the rest of the paid period from `proration_date`, charging an upgrade the difference and showing what a downgrade refunds. `period_end` prices the first period at the new terms, which replaces the renewal when the paid period ends.
- */
-export type QuoteRequestChangeEffective = (typeof QuoteRequestChangeEffective)[keyof typeof QuoteRequestChangeEffective];
-export declare const QuoteRequestChangeEffective: {
-    readonly immediate: "immediate";
-    readonly period_end: "period_end";
-};
-export type QuoteChangeInputInterval = (typeof QuoteChangeInputInterval)[keyof typeof QuoteChangeInputInterval];
-export declare const QuoteChangeInputInterval: {
-    readonly none: "none";
-    readonly day: "day";
-    readonly month: "month";
-    readonly year: "year";
-};
-/**
- * The dimension values after the change, given in full; omit to keep the subscription's.
- */
-export type QuoteChangeInputDimensions = {
-    [key: string]: string;
-};
-/**
- * The new terms of one subscription. Identify the price, or the plan to select one from, as for a proposed item. Without a price or billing terms, the plan's price with the subscription's price type, usage type, interval, interval count and cancellation policy is selected. Omitted dimensions keep the subscription's.
- */
-export interface QuoteChangeInput {
-    subscription_id: string;
-    /**
-     * @minLength 1
-     * @maxLength 128
-     */
-    price_lookup_key?: string;
-    /**
-     * @minLength 1
-     * @maxLength 128
-     */
-    plan_lookup_key?: string;
-    price_id?: string;
-    product_id?: ProductID;
-    plan_id?: string;
-    /** Selects the price type instead of keeping the subscription's. */
-    price_type?: PriceType;
-    /** Selects the usage type instead of keeping the subscription's. */
-    usage_type?: UsageType;
-    interval?: QuoteChangeInputInterval;
-    /** @minimum 1 */
-    interval_count?: number;
-    /** Selects among licensed prices with otherwise identical billing terms. */
-    cancellation_policy?: CancellationPolicy;
-    /**
-     * The quantity after the change.
-     * @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$
-     */
-    quantity: string;
-    /** The dimension values after the change, given in full; omit to keep the subscription's. */
-    dimensions?: QuoteChangeInputDimensions;
-}
-export interface QuoteAddress {
-    /**
-     * ISO 3166-1 alpha-2, two uppercase letters.
-     * @pattern ^[A-Z]{2}$
-     */
-    country: string;
-    /**
-     * The state or province, as the tax rates name it.
-     * @minLength 1
-     * @maxLength 128
-     */
-    state?: string;
-}
-/**
- * Quote proposed items, changes or renewals: exactly one of them. Give exactly one of `billing_account_id` and `currency`; changes and renewals need the account. Promotion codes apply to proposed items and changes. An invalid combination fails with `BILLING_PURCHASE_INVALID` and the field.
- */
-export interface QuoteRequest {
-    /**
-     * The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Renewals must currently be paid by it.
-     * @minimum 1
-     */
-    billing_account_id?: number;
-    /**
-     * The ISO 4217 currency to price in without an account.
-     * @minLength 3
-     * @maxLength 3
-     */
-    currency?: string;
-    /**
-     * A proposed purchase.
-     * @minItems 1
-     * @maxItems 100
-     */
-    items?: QuoteItemInput[];
-    /**
-     * Preview renewing these subscriptions, each at most once; each entry is a separate renewal order. Each must currently be paid by `billing_account_id` and be yours to read, as the owner of that account or a member of the subscription's project. To apply a promotion code, create a renewal Checkout Session and quote it.
-     * @minItems 1
-     * @maxItems 100
-     */
-    renewals?: QuoteRenewal[];
-    /**
-     * Preview changing these subscriptions in one order, each at most once. Each must currently be paid by `billing_account_id` and be yours to read, as the owner of that account or a member of the subscription's project; all must belong to the same project, or all to no project.
-     * @minItems 1
-     * @maxItems 100
-     */
-    changes?: QuoteChangeInput[];
-    /** When the changes take effect; defaults to `immediate`. `immediate` prices the rest of the paid period from `proration_date`, charging an upgrade the difference and showing what a downgrade refunds. `period_end` prices the first period at the new terms, which replaces the renewal when the paid period ends. */
-    change_effective?: QuoteRequestChangeEffective;
-    /** Only with `currency`. Where the customer is, to include the tax that would be added there for a customer who is not tax exempt; `tax_status` is then `complete`. Refused with `billing_account_id`, whose invoice contact decides tax. */
-    address?: QuoteAddress;
-    /**
-     * @minLength 1
-     * @maxLength 64
-     */
-    promotion_code?: string;
-}
 /**
  * Pagination metadata for keyset traversal. Pass next_cursor as cursor to read the following page; null means there is no following page.
  */
@@ -3206,7 +3508,7 @@ export interface PriceSearch {
      * @maxItems 200
      */
     plan_ids?: string[];
-    product_id?: ProductID;
+    product_id?: ProductId;
     /** Narrows to one price type. */
     type?: PriceType;
     /** Narrows to one usage type. */
@@ -3663,6 +3965,30 @@ export type ListAccountDiscountsParams = {
      */
     status?: DiscountStatus[];
 };
+export type ListTrialGrantsParams = {
+    /**
+     * 1-based page number. Defaults to 1.
+     * @minimum 1
+     * @maximum 2147483647
+     */
+    page?: number;
+    /**
+     * Items per page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
+     */
+    page_size?: number;
+    /**
+     * Only this account; all of yours when omitted.
+     */
+    billing_account_id?: AccountIdQueryParameter;
+    /**
+     * Only grants in these statuses; omit for every status. Comma-separated, for example `status=available,scheduled`.
+     * @minItems 1
+     * @maxItems 5
+     */
+    status?: TrialGrantStatus[];
+};
 export type ListCreditGrantsParams = {
     /**
      * 1-based page number. Defaults to 1.
@@ -3778,7 +4104,7 @@ export type ListUsageChargesParams = {
      * Only this account; all of yours when omitted.
      */
     billing_account_id?: AccountIdQueryParameter;
-    product_id?: ProductID;
+    product_id?: ProductId;
     resource_id?: string;
     /**
      * Only the charges summed into this usage invoice line.
@@ -3800,6 +4126,12 @@ export type ListUsageChargesParams = {
 };
 export type ListSubscriptionsParams = {
     expiring_before?: string;
+    /**
+     * Only these subscriptions, such as those of the resources shown on one page. Comma-separated.
+     * @minItems 1
+     * @maxItems 200
+     */
+    subscription_ids?: string[];
     /**
      * 1-based page number. Defaults to 1.
      * @minimum 1
@@ -3825,7 +4157,7 @@ export type ListSubscriptionsParams = {
     /**
      * Only subscriptions in these statuses; omit for every status. Comma-separated, for example `status=active,suspended`.
      * @minItems 1
-     * @maxItems 6
+     * @maxItems 7
      */
     status?: SubscriptionStatus[];
 };
@@ -3847,9 +4179,13 @@ export type ListCancellationsParams = {
      */
     billing_account_id?: AccountIdQueryParameter;
     /**
-     * Only cancellations that include this subscription.
+     * Only cancellations that include an item of this subscription.
      */
     subscription_id?: string;
+    /**
+     * Only cancellations that include this subscription item.
+     */
+    subscription_item_id?: string;
     /**
      * Only cancellations in these statuses; omit for every status. `open` means requested, scheduled or releasing. Comma-separated, for example `status=open,failed`.
      * @minItems 1
@@ -3873,7 +4209,7 @@ export declare const ListCancellationsStatusItem: {
     readonly canceled: "canceled";
     readonly failed: "failed";
 };
-export type ListRenewalPricesParams = {
+export type ListRenewalOptionsParams = {
     /**
      * 1-based page number. Defaults to 1.
      * @minimum 1
@@ -3914,7 +4250,7 @@ export type ListAllowancesParams = {
      * @maxItems 4
      */
     status?: AllowanceStatus[];
-    product_id?: ProductID;
+    product_id?: ProductId;
     /**
      * Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees.
      * @minItems 1
@@ -3952,27 +4288,6 @@ export type ListCheckoutSessionsParams = {
      */
     project_ids?: ProjectIdsQueryParameter;
 };
-export type ListCheckoutSessionItemsParams = {
-    /**
-     * 1-based page number. Defaults to 1.
-     * @minimum 1
-     * @maximum 2147483647
-     */
-    page?: number;
-    /**
-     * Items per page. Defaults to 50; at most 200.
-     * @minimum 1
-     * @maximum 200
-     */
-    page_size?: number;
-};
-export type GetCheckoutSessionQuoteParams = {
-    /**
-     * @minLength 1
-     * @maxLength 64
-     */
-    promotion_code?: string;
-};
 export type ListOrdersParams = {
     /**
      * 1-based page number. Defaults to 1.
@@ -4053,7 +4368,7 @@ export type ListEntitlementsParams = {
      * @maxItems 100
      */
     project_ids?: ProjectIdsQueryParameter;
-    product_id?: ProductID;
+    product_id?: ProductId;
 };
 export type ListFeatureGrantsParams = {
     /**
@@ -4072,7 +4387,7 @@ export type ListFeatureGrantsParams = {
      * Only this account; all of yours when omitted.
      */
     billing_account_id?: AccountIdQueryParameter;
-    product_id?: ProductID;
+    product_id?: ProductId;
     /**
      * Only feature grants in these statuses; omit for every status. Comma-separated, for example `status=scheduled,active`.
      * @minItems 1
@@ -4099,7 +4414,7 @@ export type ListPricesParams = {
      * @maxLength 3
      */
     currency: string;
-    product_id?: ProductID;
+    product_id?: ProductId;
     /**
      * Narrows to one price type.
      */
@@ -4154,7 +4469,7 @@ export type GetPriceHeaders = {
     "If-None-Match"?: IfNoneMatchParameter;
 };
 export type ListPlansParams = {
-    product_id: ProductID;
+    product_id: ProductId;
     /**
      * 1-based page number. Defaults to 1.
      * @minimum 1
@@ -4228,7 +4543,7 @@ export type ListActiveResourcesParams = {
      */
     project_ids?: ProjectIdsQueryParameter;
     meter_id?: string;
-    product_id?: ProductID;
+    product_id?: ProductId;
     /**
      * Only metering in these statuses; omit for every status. Comma-separated, for example `status=active,suspended`.
      * @minItems 1
@@ -4249,7 +4564,7 @@ export type ListSpendParams = {
     /**
      * Filter by the fixed platform service ID.
      */
-    product_id?: ProductID;
+    product_id?: ProductId;
     /**
      * 1-based page number. Defaults to 1.
      * @minimum 1