stripe 20.1.0-alpha.4 → 20.2.0-alpha.1

package/types/QuotePreviewSubscriptionSchedules.d.ts

@@ -72,7 +72,7 @@ declare module 'stripe' {
       /**
        * ID of the account who owns the subscription schedule.
        */
-      customer_account?: string | null;
+      customer_account: string | null;
 
       default_settings: QuotePreviewSubscriptionSchedule.DefaultSettings;
 
@@ -97,7 +97,7 @@ declare module 'stripe' {
       livemode: boolean;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
        */
       metadata: Stripe.Metadata | null;
 
@@ -122,7 +122,7 @@ declare module 'stripe' {
       released_subscription: string | null;
 
       /**
-       * The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://stripe.com/docs/billing/subscriptions/subscription-schedules).
+       * The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://docs.stripe.com/billing/subscriptions/subscription-schedules).
        */
       status: QuotePreviewSubscriptionSchedule.Status;
 
@@ -309,7 +309,7 @@ declare module 'stripe' {
         automatic_tax?: DefaultSettings.AutomaticTax;
 
         /**
-         * Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).
+         * Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
          */
         billing_cycle_anchor: DefaultSettings.BillingCycleAnchor;
 
@@ -341,14 +341,14 @@ declare module 'stripe' {
         on_behalf_of: string | Stripe.Account | null;
 
         /**
-         * The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
+         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
          */
-        transfer_data: DefaultSettings.TransferData | null;
+        phase_effective_at?: DefaultSettings.PhaseEffectiveAt;
 
         /**
-         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+         * The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
          */
-        phase_effective_at?: DefaultSettings.PhaseEffectiveAt;
+        transfer_data: DefaultSettings.TransferData | null;
       }
 
       namespace DefaultSettings {
@@ -499,7 +499,7 @@ declare module 'stripe' {
         automatic_tax?: Phase.AutomaticTax;
 
         /**
-         * Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).
+         * Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
          */
         billing_cycle_anchor: Phase.BillingCycleAnchor | null;
 
@@ -538,6 +538,11 @@ declare module 'stripe' {
          */
         discounts: Array<Phase.Discount>;
 
+        /**
+         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+         */
+        effective_at?: Phase.EffectiveAt | null;
+
         /**
          * The end of this phase of the subscription schedule.
          */
@@ -554,7 +559,7 @@ declare module 'stripe' {
         items: Array<Phase.Item>;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`.
          */
         metadata: Stripe.Metadata | null;
 
@@ -564,7 +569,7 @@ declare module 'stripe' {
         on_behalf_of: string | Stripe.Account | null;
 
         /**
-         * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
+         * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment).
          */
         pause_collection?: Phase.PauseCollection | null;
 
@@ -597,11 +602,6 @@ declare module 'stripe' {
          * Settings related to any trials on the subscription during this phase.
          */
         trial_settings?: Phase.TrialSettings | null;
-
-        /**
-         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
-         */
-        effective_at?: Phase.EffectiveAt | null;
       }
 
       namespace Phase {
@@ -612,7 +612,7 @@ declare module 'stripe' {
           discounts: Array<AddInvoiceItem.Discount>;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
            */
           metadata: Stripe.Metadata | null;
 
@@ -850,7 +850,7 @@ declare module 'stripe' {
           discounts: Array<Item.Discount>;
 
           /**
-           * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered.
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered.
            */
           metadata: Stripe.Metadata | null;
 

package/types/Quotes.d.ts

@@ -71,14 +71,14 @@ declare module 'stripe' {
       currency: string | null;
 
       /**
-       * The customer which this quote belongs to. A customer is required before finalizing the quote. Once specified, it cannot be changed.
+       * The customer who received this quote. A customer is required to finalize the quote. Once specified, you can't change it.
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
       /**
-       * The account which this quote belongs to. A customer or account is required before finalizing the quote. Once specified, it cannot be changed.
+       * The account representing the customer who received this quote. A customer or account is required to finalize the quote. Once specified, you can't change it.
        */
-      customer_account?: string | null;
+      customer_account: string | null;
 
       /**
        * The tax rates applied to this quote.
@@ -106,7 +106,7 @@ declare module 'stripe' {
       footer: string | null;
 
       /**
-       * Details of the quote that was cloned. See the [cloning documentation](https://stripe.com/docs/quotes/clone) for more details.
+       * Details of the quote that was cloned. See the [cloning documentation](https://docs.stripe.com/quotes/clone) for more details.
        */
       from_quote: Quote.FromQuote | null;
 
@@ -138,12 +138,12 @@ declare module 'stripe' {
       livemode: boolean;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
        */
       metadata: Stripe.Metadata;
 
       /**
-       * A unique number that identifies this particular quote. This number is assigned once the quote is [finalized](https://stripe.com/docs/quotes/overview#finalize).
+       * A unique number that identifies this particular quote. This number is assigned once the quote is [finalized](https://docs.stripe.com/quotes/overview#finalize).
        */
       number: string | null;
 
@@ -370,10 +370,10 @@ declare module 'stripe' {
                 amount: number;
 
                 /**
-                 * A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+                 * A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes).
                  * It contains information about when the discount began, when it will end, and what it is applied to.
                  *
-                 * Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
+                 * Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts)
                  */
                 discount: Stripe.Discount;
               }
@@ -484,10 +484,10 @@ declare module 'stripe' {
                 amount: number;
 
                 /**
-                 * A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+                 * A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes).
                  * It contains information about when the discount began, when it will end, and what it is applied to.
                  *
-                 * Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
+                 * Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts)
                  */
                 discount: Stripe.Discount;
               }
@@ -790,7 +790,7 @@ declare module 'stripe' {
         from_subscription?: string | Stripe.Subscription | null;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
          */
         metadata: Stripe.Metadata | null;
 
@@ -805,7 +805,7 @@ declare module 'stripe' {
         prebilling?: SubscriptionData.Prebilling | null;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the quote is accepted.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations) when the quote is accepted.
          */
         proration_behavior?: SubscriptionData.ProrationBehavior;
 
@@ -1115,7 +1115,7 @@ declare module 'stripe' {
         billing_schedules?: Array<SubscriptionDataOverride.BillingSchedule>;
 
         /**
-         * The customer which this quote belongs to. A customer is required before finalizing the quote. Once specified, it cannot be changed.
+         * The customer who received this quote. A customer is required to finalize the quote. Once specified, you can't change it.
          */
         customer: string | null;
 
@@ -1135,7 +1135,7 @@ declare module 'stripe' {
         phase_effective_at?: SubscriptionDataOverride.PhaseEffectiveAt;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the quote is accepted.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations) when the quote is accepted.
          */
         proration_behavior?: SubscriptionDataOverride.ProrationBehavior | null;
       }
@@ -1486,10 +1486,10 @@ declare module 'stripe' {
             amount: number;
 
             /**
-             * A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
+             * A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes).
              * It contains information about when the discount began, when it will end, and what it is applied to.
              *
-             * Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts)
+             * Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts)
              */
             discount: Stripe.Discount;
           }

package/types/QuotesResource.d.ts

@@ -94,7 +94,7 @@ declare module 'stripe' {
       lines?: Array<QuoteCreateParams.Line>;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
       metadata?: Stripe.MetadataParam;
 
@@ -283,6 +283,11 @@ declare module 'stripe' {
          */
         cancel_subscription_schedule?: Line.CancelSubscriptionSchedule;
 
+        /**
+         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+         */
+        effective_at?: Line.EffectiveAt;
+
         /**
          * Details to identify the end of the time range modified by the proposed change. If not supplied, the quote line is considered a point-in-time operation that only affects the exact timestamp at `starts_at`, and a restricted set of attributes is supported on the quote line.
          */
@@ -312,11 +317,6 @@ declare module 'stripe' {
          * Settings related to subscription trials.
          */
         trial_settings?: Line.TrialSettings;
-
-        /**
-         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
-         */
-        effective_at?: Line.EffectiveAt;
       }
 
       namespace Line {
@@ -420,7 +420,7 @@ declare module 'stripe' {
             discounts?: Array<AddItem.Discount>;
 
             /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+             * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
              */
             metadata?: Stripe.MetadataParam;
 
@@ -912,7 +912,7 @@ declare module 'stripe' {
         price?: string;
 
         /**
-         * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+         * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
          */
         price_data?: LineItem.PriceData;
 
@@ -1006,7 +1006,7 @@ declare module 'stripe' {
           recurring?: PriceData.Recurring;
 
           /**
-           * Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+           * Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -1089,7 +1089,7 @@ declare module 'stripe' {
         from_subscription?: string;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
          */
         metadata?: Stripe.MetadataParam;
 
@@ -1104,11 +1104,11 @@ declare module 'stripe' {
         prebilling?: Stripe.Emptyable<SubscriptionData.Prebilling>;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
          *
          * When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`.
          *
-         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
+         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
          *
          * Prorations can be disabled by passing `none`.
          */
@@ -1453,11 +1453,11 @@ declare module 'stripe' {
         phase_effective_at?: SubscriptionDataOverride.PhaseEffectiveAt;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
          *
          * When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`.
          *
-         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
+         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
          *
          * Prorations can be disabled by passing `none`.
          */
@@ -1854,7 +1854,7 @@ declare module 'stripe' {
       lines?: Array<QuoteUpdateParams.Line>;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
       metadata?: Stripe.MetadataParam;
 
@@ -2026,6 +2026,11 @@ declare module 'stripe' {
          */
         cancel_subscription_schedule?: Line.CancelSubscriptionSchedule;
 
+        /**
+         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+         */
+        effective_at?: Line.EffectiveAt;
+
         /**
          * Details to identify the end of the time range modified by the proposed change. If not supplied, the quote line is considered a point-in-time operation that only affects the exact timestamp at `starts_at`, and a restricted set of attributes is supported on the quote line.
          */
@@ -2060,11 +2065,6 @@ declare module 'stripe' {
          * Settings related to subscription trials.
          */
         trial_settings?: Line.TrialSettings;
-
-        /**
-         * Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
-         */
-        effective_at?: Line.EffectiveAt;
       }
 
       namespace Line {
@@ -2168,7 +2168,7 @@ declare module 'stripe' {
             discounts?: Array<AddItem.Discount>;
 
             /**
-             * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+             * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
              */
             metadata?: Stripe.MetadataParam;
 
@@ -2670,7 +2670,7 @@ declare module 'stripe' {
         price?: string;
 
         /**
-         * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+         * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
          */
         price_data?: LineItem.PriceData;
 
@@ -2764,7 +2764,7 @@ declare module 'stripe' {
           recurring?: PriceData.Recurring;
 
           /**
-           * Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+           * Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -2841,7 +2841,7 @@ declare module 'stripe' {
         end_behavior?: SubscriptionData.EndBehavior;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
          */
         metadata?: Stripe.MetadataParam;
 
@@ -2856,11 +2856,11 @@ declare module 'stripe' {
         prebilling?: Stripe.Emptyable<SubscriptionData.Prebilling>;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
          *
          * When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`.
          *
-         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
+         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
          *
          * Prorations can be disabled by passing `none`.
          */
@@ -3182,11 +3182,11 @@ declare module 'stripe' {
         phase_effective_at?: SubscriptionDataOverride.PhaseEffectiveAt;
 
         /**
-         * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
+         * Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`.
          *
          * When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`.
          *
-         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
+         * Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`.
          *
          * Prorations can be disabled by passing `none`.
          */
@@ -3491,12 +3491,12 @@ declare module 'stripe' {
 
     interface QuoteListParams extends PaginationParams {
       /**
-       * The ID of the customer whose quotes will be retrieved.
+       * The ID of the customer whose quotes you're retrieving.
        */
       customer?: string;
 
       /**
-       * The ID of the account whose quotes will be retrieved.
+       * The ID of the account representing the customer whose quotes you're retrieving.
        */
       customer_account?: string;
 

package/types/Radar/EarlyFraudWarnings.d.ts

@@ -7,7 +7,7 @@ declare module 'stripe' {
        * An early fraud warning indicates that the card issuer has notified us that a
        * charge may be fraudulent.
        *
-       * Related guide: [Early fraud warnings](https://stripe.com/docs/disputes/measuring#early-fraud-warnings)
+       * Related guide: [Early fraud warnings](https://docs.stripe.com/disputes/measuring#early-fraud-warnings)
        */
       interface EarlyFraudWarning {
         /**

package/types/Radar/ValueListItems.d.ts

@@ -26,7 +26,7 @@ declare module 'stripe' {
       /**
        * Value list items allow you to add specific values to a given Radar value list, which can then be used in rules.
        *
-       * Related guide: [Managing list items](https://stripe.com/docs/radar/lists#managing-list-items)
+       * Related guide: [Managing list items](https://docs.stripe.com/radar/lists#managing-list-items)
        */
       interface ValueListItem {
         /**

package/types/Radar/ValueLists.d.ts

@@ -26,7 +26,7 @@ declare module 'stripe' {
       /**
        * Value lists allow you to group values together which can then be referenced in rules.
        *
-       * Related guide: [Default Stripe lists](https://stripe.com/docs/radar/lists#managing-list-items)
+       * Related guide: [Default Stripe lists](https://docs.stripe.com/radar/lists#managing-list-items)
        */
       interface ValueList {
         /**
@@ -75,7 +75,7 @@ declare module 'stripe' {
         livemode: boolean;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
          */
         metadata: Stripe.Metadata;
 

package/types/Radar/ValueListsResource.d.ts

@@ -25,7 +25,7 @@ declare module 'stripe' {
         item_type?: ValueListCreateParams.ItemType;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
          */
         metadata?: Stripe.MetadataParam;
       }
@@ -63,7 +63,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
          */
         metadata?: Stripe.MetadataParam;
 

package/types/Refunds.d.ts

@@ -7,7 +7,7 @@ declare module 'stripe' {
      * refunded yet. Funds are refunded to the credit or debit card that's
      * initially charged.
      *
-     * Related guide: [Refunds](https://stripe.com/docs/refunds)
+     * Related guide: [Refunds](https://docs.stripe.com/refunds)
      */
     interface Refund {
       /**
@@ -68,7 +68,7 @@ declare module 'stripe' {
       instructions_email?: string;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
        */
       metadata: Stripe.Metadata | null;
 
@@ -102,7 +102,7 @@ declare module 'stripe' {
       source_transfer_reversal: string | Stripe.TransferReversal | null;
 
       /**
-       * Status of the refund. This can be `pending`, `requires_action`, `succeeded`, `failed`, or `canceled`. Learn more about [failed refunds](https://stripe.com/docs/refunds#failed-refunds).
+       * Status of the refund. This can be `pending`, `requires_action`, `succeeded`, `failed`, or `canceled`. Learn more about [failed refunds](https://docs.stripe.com/refunds#failed-refunds).
        */
       status: string | null;
 

package/types/RefundsResource.d.ts

@@ -31,7 +31,7 @@ declare module 'stripe' {
       instructions_email?: string;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
@@ -46,7 +46,7 @@ declare module 'stripe' {
       payment_intent?: string;
 
       /**
-       * String indicating the reason for the refund. If set, possible values are `duplicate`, `fraudulent`, and `requested_by_customer`. If you believe the charge to be fraudulent, specifying `fraudulent` as the reason will add the associated card and email to your [block lists](https://stripe.com/docs/radar/lists), and will also help us improve our fraud detection algorithms.
+       * String indicating the reason for the refund. If set, possible values are `duplicate`, `fraudulent`, and `requested_by_customer`. If you believe the charge to be fraudulent, specifying `fraudulent` as the reason will add the associated card and email to your [block lists](https://docs.stripe.com/radar/lists), and will also help us improve our fraud detection algorithms.
        */
       reason?: RefundCreateParams.Reason;
 
@@ -81,7 +81,7 @@ declare module 'stripe' {
       expand?: Array<string>;
 
       /**
-       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
     }

package/types/Reporting/ReportRuns.d.ts

@@ -8,10 +8,10 @@ declare module 'stripe' {
        * specific run parameters. Once the object is created, Stripe begins processing the report.
        * When the report has finished running, it will give you a reference to a file
        * where you can retrieve your results. For an overview, see
-       * [API Access to Reports](https://stripe.com/docs/reporting/statements/api).
+       * [API Access to Reports](https://docs.stripe.com/reporting/statements/api).
        *
        * Note that certain report types can only be run based on your live-mode data (not test-mode
-       * data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).
+       * data), and will error when queried without a [live-mode API key](https://docs.stripe.com/keys#test-live-modes).
        */
       interface ReportRun {
         /**
@@ -43,7 +43,7 @@ declare module 'stripe' {
         parameters: ReportRun.Parameters;
 
         /**
-         * The ID of the [report type](https://stripe.com/docs/reports/report-types) to run, such as `"balance.summary.1"`.
+         * The ID of the [report type](https://docs.stripe.com/reports/report-types) to run, such as `"balance.summary.1"`.
          */
         report_type: string;
 

package/types/Reporting/ReportRunsResource.d.ts

@@ -5,7 +5,7 @@ declare module 'stripe' {
     namespace Reporting {
       interface ReportRunCreateParams {
         /**
-         * The ID of the [report type](https://stripe.com/docs/reporting/statements/api#report-types) to run, such as `"balance.summary.1"`.
+         * The ID of the [report type](https://docs.stripe.com/reporting/statements/api#report-types) to run, such as `"balance.summary.1"`.
          */
         report_type: string;
 
@@ -15,7 +15,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the [API Access to Reports](https://stripe.com/docs/reporting/statements/api) documentation.
+         * Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the [API Access to Reports](https://docs.stripe.com/reporting/statements/api) documentation.
          */
         parameters?: ReportRunCreateParams.Parameters;
       }