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

package/types/Tax/CalculationLineItems.d.ts

@@ -18,12 +18,12 @@ declare module 'stripe' {
         object: 'tax.calculation_line_item';
 
         /**
-         * The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+         * The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
          */
         amount: number;
 
         /**
-         * The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+         * The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
          */
         amount_tax: number;
 
@@ -33,12 +33,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 | null;
 
         /**
-         * The ID of an existing [Product](https://stripe.com/docs/api/products/object).
+         * The ID of an existing [Product](https://docs.stripe.com/api/products/object).
          */
         product: string | null;
 
@@ -63,7 +63,7 @@ declare module 'stripe' {
         tax_breakdown?: Array<CalculationLineItem.TaxBreakdown> | null;
 
         /**
-         * The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource.
+         * The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
          */
         tax_code: string;
       }
@@ -73,7 +73,7 @@ declare module 'stripe' {
 
         interface TaxBreakdown {
           /**
-           * The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           amount: number;
 
@@ -95,7 +95,7 @@ declare module 'stripe' {
           taxability_reason: TaxBreakdown.TaxabilityReason;
 
           /**
-           * The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           taxable_amount: number;
         }

package/types/Tax/Calculations.d.ts

@@ -6,7 +6,7 @@ declare module 'stripe' {
       /**
        * A Tax Calculation allows you to calculate the tax to collect from your customer.
        *
-       * Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom)
+       * Related guide: [Calculate tax in your custom payment flow](https://docs.stripe.com/tax/custom)
        */
       interface Calculation {
         /**
@@ -20,7 +20,7 @@ declare module 'stripe' {
         object: 'tax.calculation';
 
         /**
-         * Total amount after taxes in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+         * Total amount after taxes in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
          */
         amount_total: number;
 
@@ -30,7 +30,7 @@ declare module 'stripe' {
         currency: string;
 
         /**
-         * The ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource.
+         * The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
          */
         customer: string | null;
 
@@ -252,17 +252,17 @@ declare module 'stripe' {
 
         interface ShippingCost {
           /**
-           * The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+           * The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
            */
           amount: number;
 
           /**
-           * The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           amount_tax: number;
 
           /**
-           * The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object).
+           * The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object).
            */
           shipping_rate?: string;
 
@@ -277,7 +277,7 @@ declare module 'stripe' {
           tax_breakdown?: Array<ShippingCost.TaxBreakdown>;
 
           /**
-           * The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping.
+           * The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping.
            */
           tax_code: string;
         }
@@ -287,7 +287,7 @@ declare module 'stripe' {
 
           interface TaxBreakdown {
             /**
-             * The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+             * The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
              */
             amount: number;
 
@@ -309,7 +309,7 @@ declare module 'stripe' {
             taxability_reason: TaxBreakdown.TaxabilityReason;
 
             /**
-             * The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+             * The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
              */
             taxable_amount: number;
           }
@@ -399,7 +399,7 @@ declare module 'stripe' {
 
         interface TaxBreakdown {
           /**
-           * The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           amount: number;
 
@@ -416,7 +416,7 @@ declare module 'stripe' {
           taxability_reason: TaxBreakdown.TaxabilityReason;
 
           /**
-           * The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           taxable_amount: number;
         }
@@ -461,7 +461,7 @@ declare module 'stripe' {
             rate_type: TaxRateDetails.RateType | null;
 
             /**
-             * State, county, province, or region.
+             * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
              */
             state: string | null;
 

package/types/Tax/CalculationsResource.d.ts

@@ -242,13 +242,13 @@ declare module 'stripe' {
 
         interface LineItem {
           /**
-           * A positive integer representing the line item's total price in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * A positive integer representing the line item's total price in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            * If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount.
            */
           amount: number;
 
           /**
-           * 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.MetadataParam;
 
@@ -263,7 +263,7 @@ declare module 'stripe' {
           quantity?: number;
 
           /**
-           * A custom identifier for this line item, which must be unique across the line items in the calculation. The reference helps identify each line item in exported [tax reports](https://stripe.com/docs/tax/reports).
+           * A custom identifier for this line item, which must be unique across the line items in the calculation. The reference helps identify each line item in exported [tax reports](https://docs.stripe.com/tax/reports).
            */
           reference?: string;
 
@@ -273,7 +273,7 @@ declare module 'stripe' {
           tax_behavior?: LineItem.TaxBehavior;
 
           /**
-           * A [tax code](https://stripe.com/docs/tax/tax-categories) ID to use for this line item. If not provided, we will use the tax code from the provided `product` param. If neither `tax_code` nor `product` is provided, we will use the default tax code from your Tax Settings.
+           * A [tax code](https://docs.stripe.com/tax/tax-categories) ID to use for this line item. If not provided, we will use the tax code from the provided `product` param. If neither `tax_code` nor `product` is provided, we will use the default tax code from your Tax Settings.
            */
           tax_code?: string;
         }
@@ -325,12 +325,12 @@ declare module 'stripe' {
 
         interface ShippingCost {
           /**
-           * A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) representing the shipping charge. If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount.
+           * A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) representing the shipping charge. If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount.
            */
           amount?: number;
 
           /**
-           * If provided, the [shipping rate](https://stripe.com/docs/api/shipping_rates/object)'s `amount`, `tax_code` and `tax_behavior` are used. If you provide a shipping rate, then you cannot pass the `amount`, `tax_code`, or `tax_behavior` parameters.
+           * If provided, the [shipping rate](https://docs.stripe.com/api/shipping_rates/object)'s `amount`, `tax_code` and `tax_behavior` are used. If you provide a shipping rate, then you cannot pass the `amount`, `tax_code`, or `tax_behavior` parameters.
            */
           shipping_rate?: string;
 
@@ -340,7 +340,7 @@ declare module 'stripe' {
           tax_behavior?: ShippingCost.TaxBehavior;
 
           /**
-           * The [tax code](https://stripe.com/docs/tax/tax-categories) used to calculate tax on shipping. If not provided, the default shipping tax code from your [Tax Settings](https://dashboard.stripe.com/settings/tax) is used.
+           * The [tax code](https://docs.stripe.com/tax/tax-categories) used to calculate tax on shipping. If not provided, the default shipping tax code from your [Tax Settings](https://dashboard.stripe.com/settings/tax) is used.
            */
           tax_code?: string;
         }

package/types/Tax/Registrations.d.ts

@@ -4,11 +4,11 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Tax {
       /**
-       * A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://stripe.com/docs/tax).
+       * A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://docs.stripe.com/tax).
        *
-       * Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://stripe.com/docs/tax/registering).
+       * Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://docs.stripe.com/tax/registering).
        *
-       * Related guide: [Using the Registrations API](https://stripe.com/docs/tax/registrations-api)
+       * Related guide: [Using the Registrations API](https://docs.stripe.com/tax/registrations-api)
        */
       interface Registration {
         /**

package/types/Tax/Settings.d.ts

@@ -6,7 +6,7 @@ declare module 'stripe' {
       /**
        * You can use Tax `Settings` to manage configurations used by Stripe Tax calculations.
        *
-       * Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
+       * Related guide: [Using the Settings API](https://docs.stripe.com/tax/settings-api)
        */
       interface Settings {
         /**

package/types/Tax/SettingsResource.d.ts

@@ -35,7 +35,7 @@ declare module 'stripe' {
           tax_behavior?: Defaults.TaxBehavior;
 
           /**
-           * A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+           * A [tax code](https://docs.stripe.com/tax/tax-categories) ID.
            */
           tax_code?: string;
         }

package/types/Tax/TransactionLineItems.d.ts

@@ -18,12 +18,12 @@ declare module 'stripe' {
         object: 'tax.transaction_line_item';
 
         /**
-         * The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+         * The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
          */
         amount: number;
 
         /**
-         * The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+         * The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
          */
         amount_tax: number;
 
@@ -33,12 +33,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 | null;
 
         /**
-         * The ID of an existing [Product](https://stripe.com/docs/api/products/object).
+         * The ID of an existing [Product](https://docs.stripe.com/api/products/object).
          */
         product: string | null;
 
@@ -63,7 +63,7 @@ declare module 'stripe' {
         tax_behavior: TransactionLineItem.TaxBehavior;
 
         /**
-         * The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource.
+         * The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
          */
         tax_code: string;
 

package/types/Tax/Transactions.d.ts

@@ -6,7 +6,7 @@ declare module 'stripe' {
       /**
        * A Tax Transaction records the tax collected from or refunded to your customer.
        *
-       * Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction)
+       * Related guide: [Calculate tax in your custom payment flow](https://docs.stripe.com/tax/custom#tax-transaction)
        */
       interface Transaction {
         /**
@@ -30,7 +30,7 @@ declare module 'stripe' {
         currency: string;
 
         /**
-         * The ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource.
+         * The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
          */
         customer: string | null;
 
@@ -47,7 +47,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;
 
@@ -264,17 +264,17 @@ declare module 'stripe' {
 
         interface ShippingCost {
           /**
-           * The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+           * The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
            */
           amount: number;
 
           /**
-           * The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+           * The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
            */
           amount_tax: number;
 
           /**
-           * The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object).
+           * The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object).
            */
           shipping_rate?: string;
 
@@ -289,7 +289,7 @@ declare module 'stripe' {
           tax_breakdown?: Array<ShippingCost.TaxBreakdown>;
 
           /**
-           * The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping.
+           * The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping.
            */
           tax_code: string;
         }
@@ -299,7 +299,7 @@ declare module 'stripe' {
 
           interface TaxBreakdown {
             /**
-             * The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+             * The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
              */
             amount: number;
 
@@ -321,7 +321,7 @@ declare module 'stripe' {
             taxability_reason: TaxBreakdown.TaxabilityReason;
 
             /**
-             * The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+             * The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
              */
             taxable_amount: number;
           }

package/types/Tax/TransactionsResource.d.ts

@@ -27,7 +27,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;
 
@@ -49,7 +49,7 @@ declare module 'stripe' {
         original_transaction: string;
 
         /**
-         * A custom identifier for this reversal, such as `myOrder_123-refund_1`, which must be unique across all transactions. The reference helps identify this reversal transaction in exported [tax reports](https://stripe.com/docs/tax/reports).
+         * A custom identifier for this reversal, such as `myOrder_123-refund_1`, which must be unique across all transactions. The reference helps identify this reversal transaction in exported [tax reports](https://docs.stripe.com/tax/reports).
          */
         reference: string;
 
@@ -59,7 +59,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * A flat amount to reverse across the entire transaction, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes.
+         * A flat amount to reverse across the entire transaction, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes.
          */
         flat_amount?: number;
 
@@ -69,7 +69,7 @@ declare module 'stripe' {
         line_items?: Array<TransactionCreateReversalParams.LineItem>;
 
         /**
-         * 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;
 
@@ -82,17 +82,17 @@ declare module 'stripe' {
       namespace TransactionCreateReversalParams {
         interface LineItem {
           /**
-           * The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+           * The amount to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative.
            */
           amount: number;
 
           /**
-           * The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+           * The amount of tax to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative.
            */
           amount_tax: number;
 
           /**
-           * 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.MetadataParam;
 
@@ -102,7 +102,7 @@ declare module 'stripe' {
           original_line_item: string;
 
           /**
-           * The quantity reversed. Appears in [tax exports](https://stripe.com/docs/tax/reports), but does not affect the amount of tax reversed.
+           * The quantity reversed. Appears in [tax exports](https://docs.stripe.com/tax/reports), but does not affect the amount of tax reversed.
            */
           quantity?: number;
 
@@ -116,12 +116,12 @@ declare module 'stripe' {
 
         interface ShippingCost {
           /**
-           * The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+           * The amount to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative.
            */
           amount: number;
 
           /**
-           * The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative.
+           * The amount of tax to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative.
            */
           amount_tax: number;
         }

package/types/TaxIds.d.ts

@@ -23,10 +23,10 @@ declare module 'stripe' {
     }
 
     /**
-     * You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account.
+     * You can add one or multiple tax IDs to a [customer](https://docs.stripe.com/api/customers) or account.
      * Customer and account tax IDs get displayed on related invoices and credit notes.
      *
-     * Related guides: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids), [Account tax IDs](https://stripe.com/docs/invoicing/connect#account-tax-ids)
+     * Related guides: [Customer tax identification numbers](https://docs.stripe.com/billing/taxes/tax-ids), [Account tax IDs](https://docs.stripe.com/invoicing/connect#account-tax-ids)
      */
     interface TaxId {
       /**
@@ -55,9 +55,9 @@ declare module 'stripe' {
       customer: string | Stripe.Customer | null;
 
       /**
-       * ID of the account.
+       * ID of the Account representing the customer.
        */
-      customer_account?: string | null;
+      customer_account: string | null;
 
       /**
        * Always true for a deleted object
@@ -108,9 +108,9 @@ declare module 'stripe' {
         customer?: string | Stripe.Customer;
 
         /**
-         * The account being referenced when `type` is `customer`.
+         * The Account representing the customer being referenced when `type` is `customer`.
          */
-        customer_account?: string | null;
+        customer_account: string | null;
 
         /**
          * Type of owner referenced.

package/types/TaxIdsResource.d.ts

@@ -27,7 +27,7 @@ declare module 'stripe' {
     namespace TaxIdCreateParams {
       interface Owner {
         /**
-         * Account the tax ID belongs to. Required when `type=account`
+         * Connected Account the tax ID belongs to. Required when `type=account`
          */
         account?: string;
 
@@ -37,7 +37,7 @@ declare module 'stripe' {
         customer?: string;
 
         /**
-         * v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer`
+         * ID of the Account representing the customer that the tax ID belongs to. Can be used in place of `customer` when `type=customer`
          */
         customer_account?: string;
 
@@ -186,7 +186,7 @@ declare module 'stripe' {
     namespace TaxIdListParams {
       interface Owner {
         /**
-         * Account the tax ID belongs to. Required when `type=account`
+         * Connected Account the tax ID belongs to. Required when `type=account`
          */
         account?: string;
 
@@ -196,7 +196,7 @@ declare module 'stripe' {
         customer?: string;
 
         /**
-         * v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer`
+         * ID of the Account representing the customer that the tax ID belongs to. Can be used in place of `customer` when `type=customer`
          */
         customer_account?: string;
 

package/types/TaxRates.d.ts

@@ -76,7 +76,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;
 

package/types/TaxRatesResource.d.ts

@@ -44,7 +44,7 @@ declare module 'stripe' {
       jurisdiction?: 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;
 
@@ -116,7 +116,7 @@ declare module 'stripe' {
       jurisdiction?: 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/Terminal/ConnectionTokens.d.ts

@@ -6,7 +6,7 @@ declare module 'stripe' {
       /**
        * A Connection Token is used by the Stripe Terminal SDK to connect to a reader.
        *
-       * Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
+       * Related guide: [Fleet management](https://docs.stripe.com/terminal/fleet/locations)
        */
       interface ConnectionToken {
         /**

package/types/Terminal/Locations.d.ts

@@ -26,7 +26,7 @@ declare module 'stripe' {
       /**
        * A Location represents a grouping of readers.
        *
-       * Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
+       * Related guide: [Fleet management](https://docs.stripe.com/terminal/fleet/locations)
        */
       interface Location {
         /**
@@ -76,7 +76,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/Terminal/LocationsResource.d.ts

@@ -45,7 +45,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>;
 
@@ -83,7 +83,7 @@ declare module 'stripe' {
           postal_code?: string;
 
           /**
-           * State, county, province, or region.
+           * State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
            */
           state?: string;
         }
@@ -138,7 +138,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>;