stripe 18.1.1 → 18.2.0

package/types/ConfirmationTokens.d.ts

@@ -755,7 +755,7 @@ declare module 'stripe' {
 
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -955,7 +955,7 @@ declare module 'stripe' {
         namespace CardPresent {
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -1221,7 +1221,7 @@ declare module 'stripe' {
         namespace InteracPresent {
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -1328,7 +1328,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular Naver Pay account. You can use this attribute to check whether two Naver Pay accounts are the same.
            */
-          buyer_id?: string | null;
+          buyer_id: string | null;
 
           /**
            * Whether to fund this transaction with Naver Pay points or a card.

package/types/CountrySpecs.d.ts

@@ -8,7 +8,7 @@ declare module 'stripe' {
      * Country Specs API makes these rules available to your integration.
      *
      * You can also view the information from this API call as [an online
-     * guide](https://stripe.com/docs/connect/required-verification-information).
+     * guide](https://docs.stripe.com/docs/connect/required-verification-information).
      */
     interface CountrySpec {
       /**

package/types/CreditNotes.d.ts

@@ -106,6 +106,16 @@ declare module 'stripe' {
        */
       pdf: string;
 
+      /**
+       * The amount of the credit note that was refunded to the customer, credited to the customer's balance, credited outside of Stripe, or any combination thereof.
+       */
+      post_payment_amount: number;
+
+      /**
+       * The amount of the credit note by which the invoice's `amount_remaining` and `amount_due` were reduced.
+       */
+      pre_payment_amount: number;
+
       /**
        * The pretax credit amounts (ex: discount, credit grants, etc) for all line items.
        */
@@ -261,9 +271,9 @@ declare module 'stripe' {
           amount: number;
 
           /**
-           * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+           * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
            *
-           * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+           * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
            */
           rate: Stripe.TaxRate;
 
@@ -358,7 +368,7 @@ declare module 'stripe' {
         }
       }
 
-      type Type = 'post_payment' | 'pre_payment';
+      type Type = 'mixed' | 'post_payment' | 'pre_payment';
     }
   }
 }

package/types/CreditNotesResource.d.ts

@@ -571,20 +571,19 @@ declare module 'stripe' {
 
     class CreditNotesResource {
       /**
-       * Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
-       * its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
-       * in any combination of the following:
+       * Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
+       * This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
        *
        *
-       * Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+       * Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
        * Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
        * Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
        *
        *
-       * For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+       * The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
        *
-       * You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
-       * or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+       * You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
+       * post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
        */
       create(
         params: CreditNoteCreateParams,
@@ -652,7 +651,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.CreditNote>>;
 
       /**
-       * Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+       * Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
        */
       voidCreditNote(
         id: string,

package/types/CustomerSessions.d.ts

@@ -6,9 +6,9 @@ declare module 'stripe' {
      * A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
      * control over a Customer.
      *
-     * Related guides: [Customer Session with the Payment Element](https://stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
-     * [Customer Session with the Pricing Table](https://stripe.com/payments/checkout/pricing-table#customer-session),
-     * [Customer Session with the Buy Button](https://stripe.com/payment-links/buy-button#pass-an-existing-customer).
+     * Related guides: [Customer Session with the Payment Element](https://docs.stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
+     * [Customer Session with the Pricing Table](https://docs.stripe.com/payments/checkout/pricing-table#customer-session),
+     * [Customer Session with the Buy Button](https://docs.stripe.com/payment-links/buy-button#pass-an-existing-customer).
      */
     interface CustomerSession {
       /**

package/types/CustomersResource.d.ts

@@ -1201,7 +1201,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.DeletedCustomer>>;
 
       /**
-       * Creates an immutable transaction that updates the customer's credit [balance](https://stripe.com/docs/billing/customer/balance).
+       * Creates an immutable transaction that updates the customer's credit [balance](https://docs.stripe.com/docs/billing/customer/balance).
        */
       createBalanceTransaction(
         id: string,
@@ -1225,7 +1225,7 @@ declare module 'stripe' {
        *
        * If the card's owner has no default card, then the new card will become the default.
        * However, if the owner already has a default, then it will not change.
-       * To change the default, you should [update the customer](https://stripe.com/docs/api#update_customer) to have a new default_source.
+       * To change the default, you should [update the customer](https://docs.stripe.com/docs/api#update_customer) to have a new default_source.
        */
       createSource(
         id: string,
@@ -1290,7 +1290,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.DeletedTaxId>>;
 
       /**
-       * Returns a list of transactions that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+       * Returns a list of transactions that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
        */
       listBalanceTransactions(
         id: string,
@@ -1303,7 +1303,7 @@ declare module 'stripe' {
       ): ApiListPromise<Stripe.CustomerBalanceTransaction>;
 
       /**
-       * Returns a list of transactions that modified the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+       * Returns a list of transactions that modified the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
        */
       listCashBalanceTransactions(
         id: string,
@@ -1355,7 +1355,7 @@ declare module 'stripe' {
       ): ApiListPromise<Stripe.TaxId>;
 
       /**
-       * Retrieves a specific customer balance transaction that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+       * Retrieves a specific customer balance transaction that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
        */
       retrieveBalanceTransaction(
         customerId: string,
@@ -1383,7 +1383,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.CashBalance>>;
 
       /**
-       * Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+       * Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
        */
       retrieveCashBalanceTransaction(
         customerId: string,
@@ -1443,7 +1443,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.TaxId>>;
 
       /**
-       * Search for customers you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+       * Search for customers you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
        * Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
        * conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
        * to an hour behind during outages. Search functionality is not available to merchants in India.

package/types/Disputes.d.ts

@@ -82,7 +82,7 @@ declare module 'stripe' {
       payment_method_details?: Dispute.PaymentMethodDetails;
 
       /**
-       * Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories).
+       * Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories).
        */
       reason: string;
 

package/types/DisputesResource.d.ts

@@ -348,7 +348,7 @@ declare module 'stripe' {
       /**
        * When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
        *
-       * Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+       * Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://docs.stripe.com/docs/disputes/categories).
        */
       update(
         id: string,

package/types/EventTypes.d.ts

@@ -109,6 +109,7 @@ declare module 'stripe' {
       | InvoiceUpdatedEvent
       | InvoiceVoidedEvent
       | InvoiceWillBeDueEvent
+      | InvoicePaymentPaidEvent
       | InvoiceItemCreatedEvent
       | InvoiceItemDeletedEvent
       | IssuingAuthorizationCreatedEvent
@@ -1955,6 +1956,22 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs when an InvoicePayment is successfully paid.
+     */
+    interface InvoicePaymentPaidEvent extends EventBase {
+      type: 'invoice_payment.paid';
+      data: InvoicePaymentPaidEvent.Data;
+    }
+
+    namespace InvoicePaymentPaidEvent {
+      interface Data extends Stripe.Event.Data {
+        object: Stripe.InvoicePayment;
+
+        previous_attributes?: Partial<Stripe.InvoicePayment>;
+      }
+    }
+
     /**
      * Occurs whenever an invoice item is created.
      */

package/types/Events.d.ts

@@ -133,6 +133,7 @@ declare module 'stripe' {
         | 'invoice.updated'
         | 'invoice.voided'
         | 'invoice.will_be_due'
+        | 'invoice_payment.paid'
         | 'invoiceitem.created'
         | 'invoiceitem.deleted'
         | 'issuing_authorization.created'
@@ -336,6 +337,9 @@ declare module 'stripe' {
        */
       api_version: string | null;
 
+      /**
+       * Authentication context needed to fetch the event or related object.
+       */
       context?: string;
 
       /**

package/types/Files.d.ts

@@ -7,7 +7,7 @@ declare module 'stripe' {
      * files with the [create file](https://stripe.com/docs/api#create_file) request
      * (for example, when uploading dispute evidence). Stripe also
      * creates files independently (for example, the results of a [Sigma scheduled
-     * query](https://stripe.com/docs/api#scheduled_queries)).
+     * query](https://docs.stripe.com/api#scheduled_queries)).
      *
      * Related guide: [File upload guide](https://stripe.com/docs/file-upload)
      */

package/types/FilesResource.d.ts

@@ -113,7 +113,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.File>>;
 
       /**
-       * Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://stripe.com/docs/file-upload#download-file-contents).
+       * Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://docs.stripe.com/docs/file-upload#download-file-contents).
        */
       retrieve(
         id: string,

package/types/Identity/VerificationReports.d.ts

@@ -137,6 +137,11 @@ declare module 'stripe' {
            */
           number?: string | null;
 
+          /**
+           * Sex of the person in the document.
+           */
+          sex?: Document.Sex | null;
+
           /**
            * Status of this `document` check.
            */
@@ -146,6 +151,16 @@ declare module 'stripe' {
            * Type of the document.
            */
           type: Document.Type | null;
+
+          /**
+           * Place of birth as it appears in the document.
+           */
+          unparsed_place_of_birth?: string | null;
+
+          /**
+           * Sex as it appears in the document.
+           */
+          unparsed_sex?: string | null;
         }
 
         namespace Document {
@@ -219,6 +234,8 @@ declare module 'stripe' {
             year: number | null;
           }
 
+          type Sex = '[redacted]' | 'female' | 'male' | 'unknown';
+
           type Status = 'unverified' | 'verified';
 
           type Type = 'driving_license' | 'id_card' | 'passport';

package/types/Identity/VerificationSessions.d.ts

@@ -6,11 +6,11 @@ declare module 'stripe' {
       /**
        * A VerificationSession guides you through the process of collecting and verifying the identities
        * of your users. It contains details about the type of verification, such as what [verification
-       * check](https://stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
+       * check](https://docs.stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
        * each verification in your system.
        *
        * A VerificationSession transitions through [multiple
-       * statuses](https://stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
+       * statuses](https://docs.stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
        * the verification flow. The VerificationSession contains the user's verified data after
        * verification checks are complete.
        *
@@ -268,6 +268,21 @@ declare module 'stripe' {
            * The user's verified phone number
            */
           phone: string | null;
+
+          /**
+           * The user's verified sex.
+           */
+          sex?: VerifiedOutputs.Sex | null;
+
+          /**
+           * The user's verified place of birth as it appears in the document.
+           */
+          unparsed_place_of_birth?: string | null;
+
+          /**
+           * The user's verified sex as it appears in the document.
+           */
+          unparsed_sex?: string | null;
         }
 
         namespace VerifiedOutputs {
@@ -289,6 +304,8 @@ declare module 'stripe' {
           }
 
           type IdNumberType = 'br_cpf' | 'sg_nric' | 'us_ssn';
+
+          type Sex = '[redacted]' | 'female' | 'male' | 'unknown';
         }
       }
     }

package/types/Identity/VerificationSessionsResource.d.ts

@@ -236,7 +236,7 @@ declare module 'stripe' {
          *
          * If your API key is in test mode, verification checks won't actually process, though everything else will occur as if in live mode.
          *
-         * Related guide: [Verify your users' identity documents](https://stripe.com/docs/identity/verify-identity-documents)
+         * Related guide: [Verify your users' identity documents](https://docs.stripe.com/docs/identity/verify-identity-documents)
          */
         create(
           params?: VerificationSessionCreateParams,
@@ -286,9 +286,9 @@ declare module 'stripe' {
         ): ApiListPromise<Stripe.Identity.VerificationSession>;
 
         /**
-         * A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+         * A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
          *
-         * Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+         * Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
          */
         cancel(
           id: string,
@@ -306,7 +306,7 @@ declare module 'stripe' {
          * request logs, etc.
          *
          * A VerificationSession object can be redacted when it is in requires_input or verified
-         * [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+         * [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
          * state will automatically cancel it.
          *
          * The redaction process may take up to four days. When the redaction process is in progress, the
@@ -319,7 +319,7 @@ declare module 'stripe' {
          * placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
          * used for any purpose.
          *
-         * [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+         * [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
          */
         redact(
           id: string,

package/types/InvoiceItems.d.ts

@@ -102,7 +102,7 @@ declare module 'stripe' {
       metadata: Stripe.Metadata | null;
 
       /**
-       * The parent that generated this invoice
+       * The parent that generated this invoice item.
        */
       parent: InvoiceItem.Parent | null;
 

package/types/InvoiceLineItems.d.ts

@@ -64,7 +64,7 @@ declare module 'stripe' {
       metadata: Stripe.Metadata;
 
       /**
-       * The parent that generated this invoice
+       * The parent that generated this line item.
        */
       parent: InvoiceLineItem.Parent | null;
 

package/types/InvoicePayments.d.ts

@@ -3,7 +3,14 @@
 declare module 'stripe' {
   namespace Stripe {
     /**
-     * The invoice payment object
+     * 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.
+     * 2. By using the Invoice Payment retrieve and list endpoints.
+     *
+     * Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices.
+     * This resource and its endpoints allows you to easily track if a payment is associated with a specific invoice and
+     * monitor the allocation details of the payments.
      */
     interface InvoicePayment {
       /**
@@ -64,7 +71,7 @@ declare module 'stripe' {
     namespace InvoicePayment {
       interface Payment {
         /**
-         * ID of the successful charge for this payment when `type` is `charge`.
+         * ID of the successful charge for this payment when `type` is `charge`.Note: charge is only surfaced if the charge object is not associated with a payment intent. If the charge object does have a payment intent, the Invoice Payment surfaces the payment intent instead.
          */
         charge?: string | Stripe.Charge;
 

package/types/Invoices.d.ts

@@ -47,7 +47,7 @@ declare module 'stripe' {
      * Stripe applies any customer credit on the account before determining the
      * amount due for the invoice (i.e., the amount that will be actually
      * charged). If the amount due for the invoice is less than Stripe's [minimum allowed charge
-     * per currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
+     * per currency](https://docs.stripe.com/docs/currencies#minimum-and-maximum-charge-amounts), the
      * invoice is automatically marked paid, and we add the amount due to the
      * customer's credit balance which is applied to the next invoice.
      *
@@ -58,7 +58,7 @@ declare module 'stripe' {
      */
     interface Invoice {
       /**
-       * Unique identifier for the object. This property is always present unless the invoice is an upcoming invoice. See [Retrieve an upcoming invoice](https://stripe.com/docs/api/invoices/upcoming) for more details.
+       * Unique identifier for the object. For preview invoices created using the [create preview](https://stripe.com/docs/api/invoices/create_preview) endpoint, this id will be prefixed with `upcoming_in`.
        */
       id?: string;
 
@@ -338,12 +338,12 @@ declare module 'stripe' {
       payments?: ApiList<Stripe.InvoicePayment>;
 
       /**
-       * End of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
+       * End of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
        */
       period_end: number;
 
       /**
-       * Start of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
+       * Start of the usage period during which invoice items were added to this invoice. This looks back one period for a subscription invoice. Use the [line item period](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-period) to get the service period for each price.
        */
       period_start: number;
 
@@ -883,6 +883,7 @@ declare module 'stripe' {
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
+          | 'forwarding_api_upstream_error'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'
@@ -1366,9 +1367,9 @@ declare module 'stripe' {
           amount: number;
 
           /**
-           * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+           * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
            *
-           * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+           * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
            */
           rate: Stripe.TaxRate;