stripe 11.17.0 → 11.18.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 11.18.0 - 2023-04-06
+* [#1738](https://github.com/stripe/stripe-node/pull/1738) Update generated code
+  * Add support for new value `link` on enums `Charge.payment_method_details.card.wallet.type` and `PaymentMethod.card.wallet.type`
+  * Change `IssuingCardholderCreateParams.type` to be optional
+  * Add support for `country` on `PaymentMethod.link`
+  * Add support for `status_details` on `PaymentMethod.us_bank_account`
+* [#1747](https://github.com/stripe/stripe-node/pull/1747) (Typescript) remove deprecated properties
+
 ## 11.17.0 - 2023-03-30
 * [#1734](https://github.com/stripe/stripe-node/pull/1734) Update generated code
   * Remove support for `create` method on resource `Tax.Transaction`

package/VERSION

@@ -1 +1 @@
-11.17.0
+11.18.0

package/cjs/StripeMethod.js

@@ -29,12 +29,7 @@ function stripeMethod(spec) {
         const callback = typeof args[args.length - 1] == 'function' && args.pop();
         spec.urlParams = (0, utils_js_1.extractUrlParams)(spec.fullPath || this.createResourcePathWithSymbols(spec.path || ''));
         const requestPromise = (0, utils_js_1.callbackifyPromiseWithTimeout)(this._makeRequest(args, spec, {}), callback);
-        // Please note `spec.methodType === 'search'` is beta functionality and this
-        // interface is subject to change/removal at any time.
-        if (spec.methodType === 'list' || spec.methodType === 'search') {
-            const autoPaginationMethods = (0, autoPagination_js_1.makeAutoPaginationMethods)(this, args, spec, requestPromise);
-            Object.assign(requestPromise, autoPaginationMethods);
-        }
+        Object.assign(requestPromise, (0, autoPagination_js_1.makeAutoPaginationMethods)(this, args, spec, requestPromise));
         return requestPromise;
     };
 }

package/cjs/autoPagination.js

@@ -2,72 +2,101 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeAutoPaginationMethods = void 0;
 const utils_js_1 = require("./utils.js");
-function makeAutoPaginationMethods(self, requestArgs, spec, firstPagePromise) {
-    const promiseCache = { currentPromise: null };
-    const reverseIteration = isReverseIteration(requestArgs);
-    let pagePromise = firstPagePromise;
-    let i = 0;
-    // Search and List methods iterate differently.
-    // Search relies on a `next_page` token and can only iterate in one direction.
-    // List relies on either an `ending_before` or `starting_after` field with
-    // an item ID to paginate and is bi-directional.
-    //
-    // Please note: spec.methodType === 'search' is beta functionality and is
-    // subject to change/removal at any time.
-    let getNextPagePromise;
-    if (spec.methodType === 'search') {
-        getNextPagePromise = (pageResult) => {
-            if (!pageResult.next_page) {
-                throw Error('Unexpected: Stripe API response does not have a well-formed `next_page` field, but `has_more` was true.');
-            }
-            return self._makeRequest(requestArgs, spec, {
-                page: pageResult.next_page,
-            });
-        };
+class StripeIterator {
+    constructor(firstPagePromise, requestArgs, spec, stripeResource) {
+        this.index = 0;
+        this.pagePromise = firstPagePromise;
+        this.promiseCache = { currentPromise: null };
+        this.requestArgs = requestArgs;
+        this.spec = spec;
+        this.stripeResource = stripeResource;
     }
-    else {
-        getNextPagePromise = (pageResult) => {
-            const lastId = getLastId(pageResult, reverseIteration);
-            return self._makeRequest(requestArgs, spec, {
-                [reverseIteration ? 'ending_before' : 'starting_after']: lastId,
-            });
-        };
-    }
-    function iterate(pageResult) {
+    async iterate(pageResult) {
         if (!(pageResult &&
             pageResult.data &&
             typeof pageResult.data.length === 'number')) {
             throw Error('Unexpected: Stripe API response does not have a well-formed `data` array.');
         }
-        if (i < pageResult.data.length) {
-            const idx = reverseIteration ? pageResult.data.length - 1 - i : i;
+        const reverseIteration = isReverseIteration(this.requestArgs);
+        if (this.index < pageResult.data.length) {
+            const idx = reverseIteration
+                ? pageResult.data.length - 1 - this.index
+                : this.index;
             const value = pageResult.data[idx];
-            i += 1;
+            this.index += 1;
             return { value, done: false };
         }
         else if (pageResult.has_more) {
             // Reset counter, request next page, and recurse.
-            i = 0;
-            pagePromise = getNextPagePromise(pageResult);
-            return pagePromise.then(iterate);
+            this.index = 0;
+            this.pagePromise = this.getNextPage(pageResult);
+            const nextPageResult = await this.pagePromise;
+            return this.iterate(nextPageResult);
         }
-        return { value: undefined, done: true };
+        return { done: true, value: undefined };
     }
-    function asyncIteratorNext() {
-        return memoizedPromise(promiseCache, (resolve, reject) => {
-            return pagePromise
-                .then(iterate)
-                .then(resolve)
-                .catch(reject);
+    /** @abstract */
+    getNextPage(_pageResult) {
+        throw new Error('Unimplemented');
+    }
+    async _next() {
+        return this.iterate(await this.pagePromise);
+    }
+    next() {
+        /**
+         * If a user calls `.next()` multiple times in parallel,
+         * return the same result until something has resolved
+         * to prevent page-turning race conditions.
+         */
+        if (this.promiseCache.currentPromise) {
+            return this.promiseCache.currentPromise;
+        }
+        const nextPromise = (async () => {
+            const ret = await this._next();
+            this.promiseCache.currentPromise = null;
+            return ret;
+        })();
+        this.promiseCache.currentPromise = nextPromise;
+        return nextPromise;
+    }
+}
+class ListIterator extends StripeIterator {
+    getNextPage(pageResult) {
+        const reverseIteration = isReverseIteration(this.requestArgs);
+        const lastId = getLastId(pageResult, reverseIteration);
+        return this.stripeResource._makeRequest(this.requestArgs, this.spec, {
+            [reverseIteration ? 'ending_before' : 'starting_after']: lastId,
         });
     }
-    const autoPagingEach = makeAutoPagingEach(asyncIteratorNext);
+}
+class SearchIterator extends StripeIterator {
+    getNextPage(pageResult) {
+        if (!pageResult.next_page) {
+            throw Error('Unexpected: Stripe API response does not have a well-formed `next_page` field, but `has_more` was true.');
+        }
+        return this.stripeResource._makeRequest(this.requestArgs, this.spec, {
+            page: pageResult.next_page,
+        });
+    }
+}
+const makeAutoPaginationMethods = (stripeResource, requestArgs, spec, firstPagePromise) => {
+    if (spec.methodType === 'search') {
+        return makeAutoPaginationMethodsFromIterator(new SearchIterator(firstPagePromise, requestArgs, spec, stripeResource));
+    }
+    if (spec.methodType === 'list') {
+        return makeAutoPaginationMethodsFromIterator(new ListIterator(firstPagePromise, requestArgs, spec, stripeResource));
+    }
+    return null;
+};
+exports.makeAutoPaginationMethods = makeAutoPaginationMethods;
+const makeAutoPaginationMethodsFromIterator = (iterator) => {
+    const autoPagingEach = makeAutoPagingEach((...args) => iterator.next(...args));
     const autoPagingToArray = makeAutoPagingToArray(autoPagingEach);
     const autoPaginationMethods = {
         autoPagingEach,
         autoPagingToArray,
         // Async iterator functions:
-        next: asyncIteratorNext,
+        next: () => iterator.next(),
         return: () => {
             // This is required for `break`.
             return {};
@@ -77,8 +106,7 @@ function makeAutoPaginationMethods(self, requestArgs, spec, firstPagePromise) {
         },
     };
     return autoPaginationMethods;
-}
-exports.makeAutoPaginationMethods = makeAutoPaginationMethods;
+};
 /**
  * ----------------
  * Private Helpers:
@@ -145,21 +173,6 @@ function getLastId(listResult, reverseIteration) {
     }
     return lastId;
 }
-/**
- * If a user calls `.next()` multiple times in parallel,
- * return the same result until something has resolved
- * to prevent page-turning race conditions.
- */
-function memoizedPromise(promiseCache, cb) {
-    if (promiseCache.currentPromise) {
-        return promiseCache.currentPromise;
-    }
-    promiseCache.currentPromise = new Promise(cb).then((ret) => {
-        promiseCache.currentPromise = undefined;
-        return ret;
-    });
-    return promiseCache.currentPromise;
-}
 function makeAutoPagingEach(asyncIteratorNext) {
     return function autoPagingEach( /* onItem?, onDone? */) {
         const args = [].slice.call(arguments);
@@ -215,7 +228,7 @@ function wrapAsyncIteratorWithCallback(asyncIteratorNext, onItem) {
                 onItem(item, next);
             }).then((shouldContinue) => {
                 if (shouldContinue === false) {
-                    return handleIteration({ done: true });
+                    return handleIteration({ done: true, value: undefined });
                 }
                 else {
                     return asyncIteratorNext().then(handleIteration);

package/cjs/stripe.core.js

@@ -33,7 +33,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '11.17.0';
+    Stripe.PACKAGE_VERSION = '11.18.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/StripeMethod.js

@@ -26,12 +26,7 @@ export function stripeMethod(spec) {
         const callback = typeof args[args.length - 1] == 'function' && args.pop();
         spec.urlParams = extractUrlParams(spec.fullPath || this.createResourcePathWithSymbols(spec.path || ''));
         const requestPromise = callbackifyPromiseWithTimeout(this._makeRequest(args, spec, {}), callback);
-        // Please note `spec.methodType === 'search'` is beta functionality and this
-        // interface is subject to change/removal at any time.
-        if (spec.methodType === 'list' || spec.methodType === 'search') {
-            const autoPaginationMethods = makeAutoPaginationMethods(this, args, spec, requestPromise);
-            Object.assign(requestPromise, autoPaginationMethods);
-        }
+        Object.assign(requestPromise, makeAutoPaginationMethods(this, args, spec, requestPromise));
         return requestPromise;
     };
 }

package/esm/autoPagination.js

@@ -1,70 +1,98 @@
 import { callbackifyPromiseWithTimeout, getDataFromArgs } from './utils.js';
-export function makeAutoPaginationMethods(self, requestArgs, spec, firstPagePromise) {
-    const promiseCache = { currentPromise: null };
-    const reverseIteration = isReverseIteration(requestArgs);
-    let pagePromise = firstPagePromise;
-    let i = 0;
-    // Search and List methods iterate differently.
-    // Search relies on a `next_page` token and can only iterate in one direction.
-    // List relies on either an `ending_before` or `starting_after` field with
-    // an item ID to paginate and is bi-directional.
-    //
-    // Please note: spec.methodType === 'search' is beta functionality and is
-    // subject to change/removal at any time.
-    let getNextPagePromise;
-    if (spec.methodType === 'search') {
-        getNextPagePromise = (pageResult) => {
-            if (!pageResult.next_page) {
-                throw Error('Unexpected: Stripe API response does not have a well-formed `next_page` field, but `has_more` was true.');
-            }
-            return self._makeRequest(requestArgs, spec, {
-                page: pageResult.next_page,
-            });
-        };
+class StripeIterator {
+    constructor(firstPagePromise, requestArgs, spec, stripeResource) {
+        this.index = 0;
+        this.pagePromise = firstPagePromise;
+        this.promiseCache = { currentPromise: null };
+        this.requestArgs = requestArgs;
+        this.spec = spec;
+        this.stripeResource = stripeResource;
     }
-    else {
-        getNextPagePromise = (pageResult) => {
-            const lastId = getLastId(pageResult, reverseIteration);
-            return self._makeRequest(requestArgs, spec, {
-                [reverseIteration ? 'ending_before' : 'starting_after']: lastId,
-            });
-        };
-    }
-    function iterate(pageResult) {
+    async iterate(pageResult) {
         if (!(pageResult &&
             pageResult.data &&
             typeof pageResult.data.length === 'number')) {
             throw Error('Unexpected: Stripe API response does not have a well-formed `data` array.');
         }
-        if (i < pageResult.data.length) {
-            const idx = reverseIteration ? pageResult.data.length - 1 - i : i;
+        const reverseIteration = isReverseIteration(this.requestArgs);
+        if (this.index < pageResult.data.length) {
+            const idx = reverseIteration
+                ? pageResult.data.length - 1 - this.index
+                : this.index;
             const value = pageResult.data[idx];
-            i += 1;
+            this.index += 1;
             return { value, done: false };
         }
         else if (pageResult.has_more) {
             // Reset counter, request next page, and recurse.
-            i = 0;
-            pagePromise = getNextPagePromise(pageResult);
-            return pagePromise.then(iterate);
+            this.index = 0;
+            this.pagePromise = this.getNextPage(pageResult);
+            const nextPageResult = await this.pagePromise;
+            return this.iterate(nextPageResult);
         }
-        return { value: undefined, done: true };
+        return { done: true, value: undefined };
     }
-    function asyncIteratorNext() {
-        return memoizedPromise(promiseCache, (resolve, reject) => {
-            return pagePromise
-                .then(iterate)
-                .then(resolve)
-                .catch(reject);
+    /** @abstract */
+    getNextPage(_pageResult) {
+        throw new Error('Unimplemented');
+    }
+    async _next() {
+        return this.iterate(await this.pagePromise);
+    }
+    next() {
+        /**
+         * If a user calls `.next()` multiple times in parallel,
+         * return the same result until something has resolved
+         * to prevent page-turning race conditions.
+         */
+        if (this.promiseCache.currentPromise) {
+            return this.promiseCache.currentPromise;
+        }
+        const nextPromise = (async () => {
+            const ret = await this._next();
+            this.promiseCache.currentPromise = null;
+            return ret;
+        })();
+        this.promiseCache.currentPromise = nextPromise;
+        return nextPromise;
+    }
+}
+class ListIterator extends StripeIterator {
+    getNextPage(pageResult) {
+        const reverseIteration = isReverseIteration(this.requestArgs);
+        const lastId = getLastId(pageResult, reverseIteration);
+        return this.stripeResource._makeRequest(this.requestArgs, this.spec, {
+            [reverseIteration ? 'ending_before' : 'starting_after']: lastId,
         });
     }
-    const autoPagingEach = makeAutoPagingEach(asyncIteratorNext);
+}
+class SearchIterator extends StripeIterator {
+    getNextPage(pageResult) {
+        if (!pageResult.next_page) {
+            throw Error('Unexpected: Stripe API response does not have a well-formed `next_page` field, but `has_more` was true.');
+        }
+        return this.stripeResource._makeRequest(this.requestArgs, this.spec, {
+            page: pageResult.next_page,
+        });
+    }
+}
+export const makeAutoPaginationMethods = (stripeResource, requestArgs, spec, firstPagePromise) => {
+    if (spec.methodType === 'search') {
+        return makeAutoPaginationMethodsFromIterator(new SearchIterator(firstPagePromise, requestArgs, spec, stripeResource));
+    }
+    if (spec.methodType === 'list') {
+        return makeAutoPaginationMethodsFromIterator(new ListIterator(firstPagePromise, requestArgs, spec, stripeResource));
+    }
+    return null;
+};
+const makeAutoPaginationMethodsFromIterator = (iterator) => {
+    const autoPagingEach = makeAutoPagingEach((...args) => iterator.next(...args));
     const autoPagingToArray = makeAutoPagingToArray(autoPagingEach);
     const autoPaginationMethods = {
         autoPagingEach,
         autoPagingToArray,
         // Async iterator functions:
-        next: asyncIteratorNext,
+        next: () => iterator.next(),
         return: () => {
             // This is required for `break`.
             return {};
@@ -74,7 +102,7 @@ export function makeAutoPaginationMethods(self, requestArgs, spec, firstPageProm
         },
     };
     return autoPaginationMethods;
-}
+};
 /**
  * ----------------
  * Private Helpers:
@@ -141,21 +169,6 @@ function getLastId(listResult, reverseIteration) {
     }
     return lastId;
 }
-/**
- * If a user calls `.next()` multiple times in parallel,
- * return the same result until something has resolved
- * to prevent page-turning race conditions.
- */
-function memoizedPromise(promiseCache, cb) {
-    if (promiseCache.currentPromise) {
-        return promiseCache.currentPromise;
-    }
-    promiseCache.currentPromise = new Promise(cb).then((ret) => {
-        promiseCache.currentPromise = undefined;
-        return ret;
-    });
-    return promiseCache.currentPromise;
-}
 function makeAutoPagingEach(asyncIteratorNext) {
     return function autoPagingEach( /* onItem?, onDone? */) {
         const args = [].slice.call(arguments);
@@ -211,7 +224,7 @@ function wrapAsyncIteratorWithCallback(asyncIteratorNext, onItem) {
                 onItem(item, next);
             }).then((shouldContinue) => {
                 if (shouldContinue === false) {
-                    return handleIteration({ done: true });
+                    return handleIteration({ done: true, value: undefined });
                 }
                 else {
                     return asyncIteratorNext().then(handleIteration);

package/esm/stripe.core.js

@@ -30,7 +30,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '11.17.0';
+    Stripe.PACKAGE_VERSION = '11.18.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "11.17.0",
+  "version": "11.18.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Cards.d.ts

@@ -71,7 +71,7 @@ declare module 'stripe' {
       available_payout_methods?: Array<Card.AvailablePayoutMethod> | null;
 
       /**
-       * Card brand. Can be `American Express`, `Diners Club`, `Discover`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
+       * Card brand. Can be `American Express`, `Diners Club`, `Discover`, `Eftpos Australia`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
        */
       brand: string;
 

package/types/Charges.d.ts

@@ -693,7 +693,7 @@ declare module 'stripe' {
 
         interface Card {
           /**
-           * Card brand. Can be `amex`, `diners`, `discover`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
            */
           brand: string | null;
 
@@ -767,7 +767,7 @@ declare module 'stripe' {
           moto?: boolean | null;
 
           /**
-           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
            */
           network: string | null;
 
@@ -891,7 +891,7 @@ declare module 'stripe' {
             samsung_pay?: Wallet.SamsungPay;
 
             /**
-             * The type of the card wallet, one of `amex_express_checkout`, `apple_pay`, `google_pay`, `masterpass`, `samsung_pay`, or `visa_checkout`. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.
+             * The type of the card wallet, one of `amex_express_checkout`, `apple_pay`, `google_pay`, `masterpass`, `samsung_pay`, `visa_checkout`, or `link`. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.
              */
             type: Wallet.Type;
 
@@ -933,6 +933,7 @@ declare module 'stripe' {
               | 'amex_express_checkout'
               | 'apple_pay'
               | 'google_pay'
+              | 'link'
               | 'masterpass'
               | 'samsung_pay'
               | 'visa_checkout';
@@ -968,7 +969,7 @@ declare module 'stripe' {
           amount_authorized: number | null;
 
           /**
-           * Card brand. Can be `amex`, `diners`, `discover`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
            */
           brand: string | null;
 
@@ -1045,7 +1046,7 @@ declare module 'stripe' {
           last4: string | null;
 
           /**
-           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
            */
           network: string | null;
 
@@ -1387,7 +1388,7 @@ declare module 'stripe' {
           last4: string | null;
 
           /**
-           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+           * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
            */
           network: string | null;
 

package/types/Checkout/SessionsResource.d.ts

@@ -564,7 +564,7 @@ declare module 'stripe' {
             recurring?: PriceData.Recurring;
 
             /**
-             * 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://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.
              */
             tax_behavior?: PriceData.TaxBehavior;
 

package/types/InvoiceItemsResource.d.ts

@@ -74,7 +74,7 @@ declare module 'stripe' {
       subscription?: string;
 
       /**
-       * 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://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.
        */
       tax_behavior?: InvoiceItemCreateParams.TaxBehavior;
 
@@ -136,7 +136,7 @@ declare module 'stripe' {
         product: string;
 
         /**
-         * 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://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.
          */
         tax_behavior?: PriceData.TaxBehavior;
 
@@ -217,7 +217,7 @@ declare module 'stripe' {
       quantity?: number;
 
       /**
-       * 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://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.
        */
       tax_behavior?: InvoiceItemUpdateParams.TaxBehavior;
 
@@ -279,7 +279,7 @@ declare module 'stripe' {
         product: string;
 
         /**
-         * 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://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.
          */
         tax_behavior?: PriceData.TaxBehavior;
 

package/types/InvoicesResource.d.ts

@@ -1576,7 +1576,7 @@ declare module 'stripe' {
         quantity?: number;
 
         /**
-         * 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://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.
          */
         tax_behavior?: InvoiceItem.TaxBehavior;
 
@@ -1638,7 +1638,7 @@ declare module 'stripe' {
           product: string;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -1741,7 +1741,7 @@ declare module 'stripe' {
           recurring: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -2146,7 +2146,7 @@ declare module 'stripe' {
         quantity?: number;
 
         /**
-         * 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://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.
          */
         tax_behavior?: InvoiceItem.TaxBehavior;
 
@@ -2208,7 +2208,7 @@ declare module 'stripe' {
           product: string;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -2311,7 +2311,7 @@ declare module 'stripe' {
           recurring: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 

package/types/Issuing/Cardholders.d.ts

@@ -74,7 +74,7 @@ declare module 'stripe' {
         status: Cardholder.Status;
 
         /**
-         * One of `individual` or `company`.
+         * One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details.
          */
         type: Cardholder.Type;
       }

package/types/Issuing/CardholdersResource.d.ts

@@ -14,11 +14,6 @@ declare module 'stripe' {
          */
         name: string;
 
-        /**
-         * One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details.
-         */
-        type: CardholderCreateParams.Type;
-
         /**
          * Additional information about a `company` cardholder.
          */
@@ -58,6 +53,11 @@ declare module 'stripe' {
          * Specifies whether to permit authorizations on this cardholder's cards. Defaults to `active`.
          */
         status?: CardholderCreateParams.Status;
+
+        /**
+         * One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details.
+         */
+        type?: CardholderCreateParams.Type;
       }
 
       namespace CardholderCreateParams {

package/types/PaymentMethods.d.ts

@@ -218,7 +218,7 @@ declare module 'stripe' {
 
       interface Card {
         /**
-         * Card brand. Can be `amex`, `diners`, `discover`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
+         * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
          */
         brand: string;
 
@@ -344,7 +344,7 @@ declare module 'stripe' {
           samsung_pay?: Wallet.SamsungPay;
 
           /**
-           * The type of the card wallet, one of `amex_express_checkout`, `apple_pay`, `google_pay`, `masterpass`, `samsung_pay`, or `visa_checkout`. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.
+           * The type of the card wallet, one of `amex_express_checkout`, `apple_pay`, `google_pay`, `masterpass`, `samsung_pay`, `visa_checkout`, or `link`. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.
            */
           type: Wallet.Type;
 
@@ -386,6 +386,7 @@ declare module 'stripe' {
             | 'amex_express_checkout'
             | 'apple_pay'
             | 'google_pay'
+            | 'link'
             | 'masterpass'
             | 'samsung_pay'
             | 'visa_checkout';
@@ -580,6 +581,12 @@ declare module 'stripe' {
       interface Konbini {}
 
       interface Link {
+        /**
+         * Two-letter ISO code representing the funding source (i.e. card, bank) country beneath the Link payment method.
+         * You could use this attribute to get a sense of the international breakdown of funding sources you've collected.
+         */
+        country?: string;
+
         /**
          * Account owner's email address.
          */
@@ -768,6 +775,11 @@ declare module 'stripe' {
          * Routing number of the bank account.
          */
         routing_number: string | null;
+
+        /**
+         * Contains information about the future reusability of this PaymentMethod.
+         */
+        status_details?: UsBankAccount.StatusDetails | null;
       }
 
       namespace UsBankAccount {
@@ -790,6 +802,48 @@ declare module 'stripe' {
         namespace Networks {
           type Supported = 'ach' | 'us_domestic_wire';
         }
+
+        interface StatusDetails {
+          blocked?: StatusDetails.Blocked;
+        }
+
+        namespace StatusDetails {
+          interface Blocked {
+            /**
+             * The ACH network code that resulted in this block.
+             */
+            network_code: Blocked.NetworkCode | null;
+
+            /**
+             * The reason why this PaymentMethod's fingerprint has been blocked
+             */
+            reason: Blocked.Reason | null;
+          }
+
+          namespace Blocked {
+            type NetworkCode =
+              | 'R02'
+              | 'R03'
+              | 'R04'
+              | 'R05'
+              | 'R07'
+              | 'R08'
+              | 'R10'
+              | 'R11'
+              | 'R16'
+              | 'R20'
+              | 'R29'
+              | 'R31';
+
+            type Reason =
+              | 'bank_account_closed'
+              | 'bank_account_frozen'
+              | 'bank_account_invalid_details'
+              | 'bank_account_restricted'
+              | 'bank_account_unusable'
+              | 'debit_not_authorized';
+          }
+        }
       }
 
       interface WechatPay {}

package/types/Prices.d.ts

@@ -86,7 +86,7 @@ declare module 'stripe' {
       recurring: Price.Recurring | null;
 
       /**
-       * 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://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.
        */
       tax_behavior: Price.TaxBehavior | null;
 
@@ -131,7 +131,7 @@ declare module 'stripe' {
         custom_unit_amount: CurrencyOptions.CustomUnitAmount | null;
 
         /**
-         * 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://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.
          */
         tax_behavior: CurrencyOptions.TaxBehavior | null;
 

package/types/PricesResource.d.ts

@@ -66,7 +66,7 @@ declare module 'stripe' {
       recurring?: PriceCreateParams.Recurring;
 
       /**
-       * 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://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.
        */
       tax_behavior?: PriceCreateParams.TaxBehavior;
 
@@ -111,7 +111,7 @@ declare module 'stripe' {
         custom_unit_amount?: CurrencyOptions.CustomUnitAmount;
 
         /**
-         * 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://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.
          */
         tax_behavior?: CurrencyOptions.TaxBehavior;
 
@@ -378,7 +378,7 @@ declare module 'stripe' {
       recurring?: Stripe.Emptyable<PriceUpdateParams.Recurring>;
 
       /**
-       * 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://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.
        */
       tax_behavior?: PriceUpdateParams.TaxBehavior;
 
@@ -396,7 +396,7 @@ declare module 'stripe' {
         custom_unit_amount?: CurrencyOptions.CustomUnitAmount;
 
         /**
-         * 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://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.
          */
         tax_behavior?: CurrencyOptions.TaxBehavior;
 

package/types/ProductsResource.d.ts

@@ -117,7 +117,7 @@ declare module 'stripe' {
         recurring?: DefaultPriceData.Recurring;
 
         /**
-         * 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://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.
          */
         tax_behavior?: DefaultPriceData.TaxBehavior;
 
@@ -140,7 +140,7 @@ declare module 'stripe' {
           custom_unit_amount?: CurrencyOptions.CustomUnitAmount;
 
           /**
-           * 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://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.
            */
           tax_behavior?: CurrencyOptions.TaxBehavior;
 

package/types/QuotesResource.d.ts

@@ -185,7 +185,7 @@ declare module 'stripe' {
           recurring?: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -429,7 +429,7 @@ declare module 'stripe' {
           recurring?: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 

package/types/Refunds.d.ts

@@ -61,7 +61,7 @@ declare module 'stripe' {
       failure_reason?: string;
 
       /**
-       * Email to which refund instructions, if required, are sent to.
+       * For payment methods without native refund support (e.g., Konbini, PromptPay), email for the customer to receive refund instructions.
        */
       instructions_email?: string;
 

package/types/RefundsResource.d.ts

@@ -26,7 +26,7 @@ declare module 'stripe' {
       expand?: Array<string>;
 
       /**
-       * Address to send refund email, use customer email if not specified
+       * For payment methods without native refund support (e.g., Konbini, PromptPay), use this email from the customer to receive refund instructions.
        */
       instructions_email?: string;
 

package/types/SubscriptionItemsResource.d.ts

@@ -103,7 +103,7 @@ declare module 'stripe' {
         recurring: PriceData.Recurring;
 
         /**
-         * 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://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.
          */
         tax_behavior?: PriceData.TaxBehavior;
 
@@ -249,7 +249,7 @@ declare module 'stripe' {
         recurring: PriceData.Recurring;
 
         /**
-         * 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://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.
          */
         tax_behavior?: PriceData.TaxBehavior;
 

package/types/SubscriptionSchedulesResource.d.ts

@@ -288,7 +288,7 @@ declare module 'stripe' {
             product: string;
 
             /**
-             * 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://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.
              */
             tax_behavior?: PriceData.TaxBehavior;
 
@@ -400,7 +400,7 @@ declare module 'stripe' {
             recurring: PriceData.Recurring;
 
             /**
-             * 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://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.
              */
             tax_behavior?: PriceData.TaxBehavior;
 
@@ -743,7 +743,7 @@ declare module 'stripe' {
             product: string;
 
             /**
-             * 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://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.
              */
             tax_behavior?: PriceData.TaxBehavior;
 
@@ -855,7 +855,7 @@ declare module 'stripe' {
             recurring: PriceData.Recurring;
 
             /**
-             * 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://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.
              */
             tax_behavior?: PriceData.TaxBehavior;
 

package/types/SubscriptionsResource.d.ts

@@ -214,7 +214,7 @@ declare module 'stripe' {
           product: string;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -317,7 +317,7 @@ declare module 'stripe' {
           recurring: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -868,7 +868,7 @@ declare module 'stripe' {
           product: string;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 
@@ -1012,7 +1012,7 @@ declare module 'stripe' {
           recurring: PriceData.Recurring;
 
           /**
-           * 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://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.
            */
           tax_behavior?: PriceData.TaxBehavior;
 

package/types/Tax/Calculations.d.ts

@@ -4,7 +4,9 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Tax {
       /**
-       * A Tax `Calculation` allows you to calculate the tax to collect from your customer.
+       * 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).
        */
       interface Calculation {
         /**

package/types/Tax/CalculationsResource.d.ts

@@ -30,7 +30,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * Shipping cost details to be used for the calculation
+         * Shipping cost details to be used for the calculation.
          */
         shipping_cost?: CalculationCreateParams.ShippingCost;
 

package/types/Tax/Transactions.d.ts

@@ -4,7 +4,9 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Tax {
       /**
-       * A Tax transaction records the tax collected from or refunded to your customer.
+       * 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).
        */
       interface Transaction {
         /**

package/types/lib.d.ts

@@ -118,31 +118,21 @@ declare module 'stripe' {
        * For Connect, we recommend using `stripeAccount` instead.
        */
       apiKey?: string;
-      /** @deprecated Please use apiKey instead. */
-      api_key?: string;
 
       /**
        * See the [idempotency key docs](https://stripe.com/docs/api/idempotent_requests).
        */
       idempotencyKey?: string;
-      /** @deprecated Please use idempotencyKey instead. */
-      idempotency_key?: string;
 
       /**
        * An account id on whose behalf you wish to make a request.
        */
       stripeAccount?: string;
-      /** @deprecated Please use stripeAccount instead. */
-      stripe_account?: string;
 
       /**
        * The [API Version](https://stripe.com/docs/upgrades) to use for a given request (e.g., '2020-03-02').
        */
       apiVersion?: string;
-      /** @deprecated Please use apiVersion instead. */
-      stripeVersion?: string;
-      /** @deprecated Please use stripeVersion instead. */
-      stripe_version?: string;
 
       /**
        * Specify the number of requests to retry in event of error.