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

package/types/Identity/VerificationSessions.d.ts

@@ -14,7 +14,7 @@ declare module 'stripe' {
        * the verification flow. The VerificationSession contains the user's verified data after
        * verification checks are complete.
        *
-       * Related guide: [The Verification Sessions API](https://stripe.com/docs/identity/verification-sessions)
+       * Related guide: [The Verification Sessions API](https://docs.stripe.com/identity/verification-sessions)
        */
       interface VerificationSession {
         /**
@@ -33,7 +33,7 @@ declare module 'stripe' {
         client_reference_id: string | null;
 
         /**
-         * The short-lived client secret used by Stripe.js to [show a verification modal](https://stripe.com/docs/js/identity/modal) inside your app. This client secret expires after 24 hours and can only be used once. Don't store it, log it, embed it in a URL, or expose it to anyone other than the user. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs on [passing the client secret to the frontend](https://stripe.com/docs/identity/verification-sessions#client-secret) to learn more.
+         * The short-lived client secret used by Stripe.js to [show a verification modal](https://docs.stripe.com/js/identity/modal) inside your app. This client secret expires after 24 hours and can only be used once. Don't store it, log it, embed it in a URL, or expose it to anyone other than the user. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs on [passing the client secret to the frontend](https://docs.stripe.com/identity/verification-sessions#client-secret) to learn more.
          */
         client_secret: string | null;
 
@@ -48,7 +48,7 @@ declare module 'stripe' {
         last_error: VerificationSession.LastError | null;
 
         /**
-         * ID of the most recent VerificationReport. [Learn more about accessing detailed verification results.](https://stripe.com/docs/identity/verification-sessions#results)
+         * ID of the most recent VerificationReport. [Learn more about accessing detailed verification results.](https://docs.stripe.com/identity/verification-sessions#results)
          */
         last_verification_report:
           | string
@@ -61,7 +61,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;
 
@@ -86,24 +86,24 @@ declare module 'stripe' {
         related_customer: string | null;
 
         /**
-         * Token referencing a Customer Account resource.
+         * The ID of the Account representing a customer.
          */
-        related_customer_account?: string | null;
+        related_customer_account: string | null;
 
         related_person?: VerificationSession.RelatedPerson;
 
         /**
-         * Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
+         * Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work).
          */
         status: VerificationSession.Status;
 
         /**
-         * The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed.
+         * The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed.
          */
         type: VerificationSession.Type;
 
         /**
-         * The short-lived URL that you use to redirect a user to Stripe to submit their identity information. This URL expires after 48 hours and can only be used once. Don't store it, log it, send it in emails or expose it to anyone other than the user. Refer to our docs on [verifying identity documents](https://stripe.com/docs/identity/verify-identity-documents?platform=web&type=redirect) to learn how to redirect users to Stripe.
+         * The short-lived URL that you use to redirect a user to Stripe to submit their identity information. This URL expires after 48 hours and can only be used once. Don't store it, log it, send it in emails or expose it to anyone other than the user. Refer to our docs on [verifying identity documents](https://docs.stripe.com/identity/verify-identity-documents?platform=web&type=redirect) to learn how to redirect users to Stripe.
          */
         url: string | null;
 
@@ -174,7 +174,7 @@ declare module 'stripe' {
             allowed_types?: Array<Document.AllowedType>;
 
             /**
-             * Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
+             * Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
              */
             require_id_number?: boolean;
 
@@ -184,7 +184,7 @@ declare module 'stripe' {
             require_live_capture?: boolean;
 
             /**
-             * Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie).
+             * Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie).
              */
             require_matching_selfie?: boolean;
           }

package/types/Identity/VerificationSessionsResource.d.ts

@@ -15,7 +15,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;
 
@@ -35,7 +35,7 @@ declare module 'stripe' {
         related_customer?: string;
 
         /**
-         * Token referencing a Customer Account resource.
+         * The ID of the Account representing a customer.
          */
         related_customer_account?: string;
 
@@ -50,7 +50,7 @@ declare module 'stripe' {
         return_url?: string;
 
         /**
-         * The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`.
+         * The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`.
          */
         type?: VerificationSessionCreateParams.Type;
 
@@ -63,7 +63,7 @@ declare module 'stripe' {
       namespace VerificationSessionCreateParams {
         interface Options {
           /**
-           * Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document).
+           * Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document).
            */
           document?: Stripe.Emptyable<Options.Document>;
         }
@@ -76,7 +76,7 @@ declare module 'stripe' {
             allowed_types?: Array<Document.AllowedType>;
 
             /**
-             * Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
+             * Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
              */
             require_id_number?: boolean;
 
@@ -86,7 +86,7 @@ declare module 'stripe' {
             require_live_capture?: boolean;
 
             /**
-             * Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie).
+             * Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie).
              */
             require_matching_selfie?: boolean;
           }
@@ -137,7 +137,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;
 
@@ -152,7 +152,7 @@ declare module 'stripe' {
         provided_details?: VerificationSessionUpdateParams.ProvidedDetails;
 
         /**
-         * The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed.
+         * The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed.
          */
         type?: VerificationSessionUpdateParams.Type;
       }
@@ -160,7 +160,7 @@ declare module 'stripe' {
       namespace VerificationSessionUpdateParams {
         interface Options {
           /**
-           * Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document).
+           * Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document).
            */
           document?: Stripe.Emptyable<Options.Document>;
         }
@@ -173,7 +173,7 @@ declare module 'stripe' {
             allowed_types?: Array<Document.AllowedType>;
 
             /**
-             * Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
+             * Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth.
              */
             require_id_number?: boolean;
 
@@ -183,7 +183,7 @@ declare module 'stripe' {
             require_live_capture?: boolean;
 
             /**
-             * Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie).
+             * Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie).
              */
             require_matching_selfie?: boolean;
           }
@@ -224,12 +224,18 @@ declare module 'stripe' {
          */
         expand?: Array<string>;
 
+        /**
+         * Customer ID
+         */
         related_customer?: string;
 
+        /**
+         * The ID of the Account representing a customer.
+         */
         related_customer_account?: string;
 
         /**
-         * Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
+         * Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work).
          */
         status?: VerificationSessionListParams.Status;
       }

package/types/InvoiceItems.d.ts

@@ -23,14 +23,14 @@ declare module 'stripe' {
     }
 
     /**
-     * Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). When you create an invoice item with an `invoice` field, it is attached to the specified invoice and included as [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines).
+     * Invoice Items represent the component lines of an [invoice](https://docs.stripe.com/api/invoices). When you create an invoice item with an `invoice` field, it is attached to the specified invoice and included as [an invoice line item](https://docs.stripe.com/api/invoices/line_item) within [invoice.lines](https://docs.stripe.com/api/invoices/object#invoice_object-lines).
      *
      * Invoice Items can be created before you are ready to actually send the invoice. This can be particularly useful when combined
-     * with a [subscription](https://stripe.com/docs/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge
+     * with a [subscription](https://docs.stripe.com/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge
      * or credit the customer's card only at the end of a regular billing cycle. This is useful for combining several charges
      * (to minimize per-transaction fees), or for having Stripe tabulate your usage-based billing totals.
      *
-     * Related guides: [Integrate with the Invoicing API](https://stripe.com/docs/invoicing/integration), [Subscription Invoices](https://stripe.com/docs/billing/invoices/subscription#adding-upcoming-invoice-items).
+     * Related guides: [Integrate with the Invoicing API](https://docs.stripe.com/invoicing/integration), [Subscription Invoices](https://docs.stripe.com/billing/invoices/subscription#adding-upcoming-invoice-items).
      */
     interface InvoiceItem {
       /**
@@ -54,14 +54,14 @@ declare module 'stripe' {
       currency: string;
 
       /**
-       * The ID of the customer who will be billed when this invoice item is billed.
+       * The ID of the customer to bill for this invoice item.
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
       /**
-       * The ID of the account who will be billed when this invoice item is billed.
+       * The ID of the account to bill for this invoice item.
        */
-      customer_account?: string | null;
+      customer_account: string | null;
 
       /**
        * Time at which the object was created. Measured in seconds since the Unix epoch.
@@ -104,7 +104,7 @@ declare module 'stripe' {
       margins?: Array<string | Stripe.Margin> | null;
 
       /**
-       * 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;
 
@@ -160,6 +160,11 @@ declare module 'stripe' {
          */
         rate_card_subscription_details?: Parent.RateCardSubscriptionDetails | null;
 
+        /**
+         * Details about the subscription schedule that generated this invoice item
+         */
+        schedule_details?: Parent.ScheduleDetails | null;
+
         /**
          * Details about the subscription that generated this invoice item
          */
@@ -169,11 +174,6 @@ declare module 'stripe' {
          * The type of parent that generated this invoice item
          */
         type: Parent.Type;
-
-        /**
-         * Details about the subscription schedule that generated this invoice item
-         */
-        schedule_details?: Parent.ScheduleDetails | null;
       }
 
       namespace Parent {

package/types/InvoiceItemsResource.d.ts

@@ -14,12 +14,12 @@ declare module 'stripe' {
       currency?: string;
 
       /**
-       * The ID of the customer who will be billed when this invoice item is billed.
+       * The ID of the customer to bill for this invoice item.
        */
       customer?: string;
 
       /**
-       * The ID of the account who will be billed when this invoice item is billed.
+       * The ID of the account representing the customer to bill for this invoice item.
        */
       customer_account?: string;
 
@@ -54,17 +54,17 @@ declare module 'stripe' {
       margins?: 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>;
 
       /**
-       * The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
+       * The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
        */
       period?: InvoiceItemCreateParams.Period;
 
       /**
-       * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline.
+       * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline.
        */
       price_data?: InvoiceItemCreateParams.PriceData;
 
@@ -84,12 +84,12 @@ declare module 'stripe' {
       subscription?: string;
 
       /**
-       * 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?: InvoiceItemCreateParams.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?: Stripe.Emptyable<string>;
 
@@ -190,7 +190,7 @@ declare module 'stripe' {
         product: string;
 
         /**
-         * 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;
 
@@ -258,17 +258,17 @@ declare module 'stripe' {
       margins?: Stripe.Emptyable<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>;
 
       /**
-       * The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
+       * The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
        */
       period?: InvoiceItemUpdateParams.Period;
 
       /**
-       * Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline.
+       * Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline.
        */
       price_data?: InvoiceItemUpdateParams.PriceData;
 
@@ -283,12 +283,12 @@ declare module 'stripe' {
       quantity?: number;
 
       /**
-       * 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?: InvoiceItemUpdateParams.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?: Stripe.Emptyable<string>;
 
@@ -389,7 +389,7 @@ declare module 'stripe' {
         product: string;
 
         /**
-         * 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;
 
@@ -425,12 +425,12 @@ declare module 'stripe' {
       created?: Stripe.RangeQueryParam | number;
 
       /**
-       * The identifier of the customer whose invoice items to return. If none is provided, all invoice items will be returned.
+       * The identifier of the customer whose invoice items to return. If none is provided, returns all invoice items.
        */
       customer?: string;
 
       /**
-       * The identifier of the account whose invoice items to return. If none is provided, all invoice items will be returned.
+       * The identifier of the account representing the customer whose invoice items to return. If none is provided, returns all invoice items.
        */
       customer_account?: string;
 

package/types/InvoiceLineItems.d.ts

@@ -3,9 +3,9 @@
 declare module 'stripe' {
   namespace Stripe {
     /**
-     * Invoice Line Items represent the individual lines within an [invoice](https://stripe.com/docs/api/invoices) and only exist within the context of an invoice.
+     * Invoice Line Items represent the individual lines within an [invoice](https://docs.stripe.com/api/invoices) and only exist within the context of an invoice.
      *
-     * Each line item is backed by either an [invoice item](https://stripe.com/docs/api/invoiceitems) or a [subscription item](https://stripe.com/docs/api/subscription_items).
+     * Each line item is backed by either an [invoice item](https://docs.stripe.com/api/invoiceitems) or a [subscription item](https://docs.stripe.com/api/subscription_items).
      */
     interface InvoiceLineItem {
       /**
@@ -69,7 +69,7 @@ declare module 'stripe' {
       margins?: Array<string | Stripe.Margin> | null;
 
       /**
-       * 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. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation.
+       * 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. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation.
        */
       metadata: Stripe.Metadata;
 
@@ -149,6 +149,11 @@ declare module 'stripe' {
          */
         rate_card_subscription_details?: Parent.RateCardSubscriptionDetails | null;
 
+        /**
+         * Details about the subscription schedule that generated this line item
+         */
+        schedule_details?: Parent.ScheduleDetails | null;
+
         /**
          * Details about the subscription item that generated this line item
          */
@@ -158,11 +163,6 @@ declare module 'stripe' {
          * The type of parent that generated this line item
          */
         type: Parent.Type;
-
-        /**
-         * Details about the subscription schedule that generated this line item
-         */
-        schedule_details?: Parent.ScheduleDetails | null;
       }
 
       namespace Parent {
@@ -501,6 +501,9 @@ declare module 'stripe' {
         type TaxBehavior = 'exclusive' | 'inclusive';
 
         interface TaxRateDetails {
+          /**
+           * ID of the tax rate
+           */
           tax_rate: string;
         }
       }

package/types/InvoicePayments.d.ts

@@ -5,7 +5,7 @@ declare module 'stripe' {
     /**
      * Invoice Payments represent payments made against invoices. Invoice Payments can
      * be accessed in two ways:
-     * 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource.
+     * 1. By expanding the `payments` field on the [Invoice](https://api.stripe.com#invoice) resource.
      * 2. By using the Invoice Payment retrieve and list endpoints.
      *
      * Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.

package/types/InvoiceRenderingTemplates.d.ts

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