stripe 14.4.0 → 14.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 14.5.0 - 2023-11-16
+* [#1957](https://github.com/stripe/stripe-node/pull/1957) Update generated code
+  * Add support for `bacs_debit_payments` on `AccountCreateParams.settings` and `AccountUpdateParams.settings`
+  * Add support for `service_user_number` on `Account.settings.bacs_debit_payments`
+  * Change type of `Account.settings.bacs_debit_payments.display_name` from `string` to `string | null`
+  * Add support for `capture_before` on `Charge.payment_method_details.card`
+  * Add support for `paypal` on `Checkout.Session.payment_method_options`
+  * Add support for `tax_amounts` on `CreditNoteCreateParams.lines[]`, `CreditNotePreviewLinesParams.lines[]`, and `CreditNotePreviewParams.lines[]`
+  * Add support for `network_data` on `Issuing.Transaction`
+* [#1960](https://github.com/stripe/stripe-node/pull/1960) Update generated code
+  * Add support for `status` on `Checkout.SessionListParams`
+* [#1958](https://github.com/stripe/stripe-node/pull/1958) Move Webhooks instance to static field
+* [#1952](https://github.com/stripe/stripe-node/pull/1952) Use AbortController for native fetch cancellation when available
+
 ## 14.4.0 - 2023-11-09
 * [#1947](https://github.com/stripe/stripe-node/pull/1947) Update generated code
   * Add support for new value `terminal_reader_hardware_fault` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`

package/VERSION

@@ -1 +1 @@
-14.4.0
+14.5.0

package/cjs/net/FetchHttpClient.js

@@ -13,13 +13,79 @@ const HttpClient_js_1 = require("./HttpClient.js");
 class FetchHttpClient extends HttpClient_js_1.HttpClient {
     constructor(fetchFn) {
         super();
-        this._fetchFn = fetchFn;
+        // Default to global fetch if available
+        if (!fetchFn) {
+            if (!globalThis.fetch) {
+                throw new Error('fetch() function not provided and is not defined in the global scope. ' +
+                    'You must provide a fetch implementation.');
+            }
+            fetchFn = globalThis.fetch;
+        }
+        // Both timeout behaviors differs from Node:
+        // - Fetch uses a single timeout for the entire length of the request.
+        // - Node is more fine-grained and resets the timeout after each stage of the request.
+        if (globalThis.AbortController) {
+            // Utilise native AbortController if available
+            // AbortController was added in Node v15.0.0, v14.17.0
+            this._fetchFn = FetchHttpClient.makeFetchWithAbortTimeout(fetchFn);
+        }
+        else {
+            // Fall back to racing against a timeout promise if not available in the runtime
+            // This does not actually cancel the underlying fetch operation or resources
+            this._fetchFn = FetchHttpClient.makeFetchWithRaceTimeout(fetchFn);
+        }
+    }
+    static makeFetchWithRaceTimeout(fetchFn) {
+        return (url, init, timeout) => {
+            let pendingTimeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                pendingTimeoutId = setTimeout(() => {
+                    pendingTimeoutId = null;
+                    reject(HttpClient_js_1.HttpClient.makeTimeoutError());
+                }, timeout);
+            });
+            const fetchPromise = fetchFn(url, init);
+            return Promise.race([fetchPromise, timeoutPromise]).finally(() => {
+                if (pendingTimeoutId) {
+                    clearTimeout(pendingTimeoutId);
+                }
+            });
+        };
+    }
+    static makeFetchWithAbortTimeout(fetchFn) {
+        return async (url, init, timeout) => {
+            // Use AbortController because AbortSignal.timeout() was added later in Node v17.3.0, v16.14.0
+            const abort = new AbortController();
+            let timeoutId = setTimeout(() => {
+                timeoutId = null;
+                abort.abort(HttpClient_js_1.HttpClient.makeTimeoutError());
+            }, timeout);
+            try {
+                return await fetchFn(url, Object.assign(Object.assign({}, init), { signal: abort.signal }));
+            }
+            catch (err) {
+                // Some implementations, like node-fetch, do not respect the reason passed to AbortController.abort()
+                // and instead it always throws an AbortError
+                // We catch this case to normalise all timeout errors
+                if (err.name === 'AbortError') {
+                    throw HttpClient_js_1.HttpClient.makeTimeoutError();
+                }
+                else {
+                    throw err;
+                }
+            }
+            finally {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+            }
+        };
     }
     /** @override. */
     getClientName() {
         return 'fetch';
     }
-    makeRequest(host, port, path, method, headers, requestData, protocol, timeout) {
+    async makeRequest(host, port, path, method, headers, requestData, protocol, timeout) {
         const isInsecureConnection = protocol === 'http';
         const url = new URL(path, `${isInsecureConnection ? 'http' : 'https'}://${host}`);
         url.port = port;
@@ -29,43 +95,14 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
         // for more details.
         const methodHasPayload = method == 'POST' || method == 'PUT' || method == 'PATCH';
         const body = requestData || (methodHasPayload ? '' : undefined);
-        const fetchFn = this._fetchFn || fetch;
-        const fetchPromise = fetchFn(url.toString(), {
+        const res = await this._fetchFn(url.toString(), {
             method,
             // @ts-ignore
             headers,
             // @ts-ignore
             body,
-        });
-        // The Fetch API does not support passing in a timeout natively, so a
-        // timeout promise is constructed to race against the fetch and preempt the
-        // request, simulating a timeout.
-        //
-        // This timeout behavior differs from Node:
-        // - Fetch uses a single timeout for the entire length of the request.
-        // - Node is more fine-grained and resets the timeout after each stage of
-        //   the request.
-        //
-        // As an example, if the timeout is set to 30s and the connection takes 20s
-        // to be established followed by 20s for the body, Fetch would timeout but
-        // Node would not. The more fine-grained timeout cannot be implemented with
-        // fetch.
-        let pendingTimeoutId;
-        const timeoutPromise = new Promise((_, reject) => {
-            pendingTimeoutId = setTimeout(() => {
-                pendingTimeoutId = null;
-                reject(HttpClient_js_1.HttpClient.makeTimeoutError());
-            }, timeout);
-        });
-        return Promise.race([fetchPromise, timeoutPromise])
-            .then((res) => {
-            return new FetchHttpClientResponse(res);
-        })
-            .finally(() => {
-            if (pendingTimeoutId) {
-                clearTimeout(pendingTimeoutId);
-            }
-        });
+        }, timeout);
+        return new FetchHttpClientResponse(res);
     }
 }
 exports.FetchHttpClient = FetchHttpClient;

package/cjs/stripe.core.js

@@ -34,13 +34,23 @@ 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 = '14.4.0';
+    Stripe.PACKAGE_VERSION = '14.5.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;
     Stripe.HttpClient = HttpClient_js_1.HttpClient;
     Stripe.HttpClientResponse = HttpClient_js_1.HttpClientResponse;
     Stripe.CryptoProvider = CryptoProvider_js_1.CryptoProvider;
+    // Previously Stripe.webhooks was just the createWebhooks() factory function
+    // however going forward it will be a WebhookObject instance. To maintain
+    // backwards compatibility it is currently a factory function that also
+    // complies to the WebhookObject signature. The factory function signature
+    // will be removed as a breaking change in the next major release.
+    // See https://github.com/stripe/stripe-node/issues/1956
+    function createWebhooksDefault(fns = platformFunctions) {
+        return (0, Webhooks_js_1.createWebhooks)(fns);
+    }
+    Stripe.webhooks = Object.assign(createWebhooksDefault, (0, Webhooks_js_1.createWebhooks)(platformFunctions));
     function Stripe(key, config = {}) {
         if (!(this instanceof Stripe)) {
             return new Stripe(key, config);
@@ -94,7 +104,9 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
         this._prepResources();
         this._setApiKey(key);
         this.errors = _Error;
-        this.webhooks = (0, Webhooks_js_1.createWebhooks)(platformFunctions);
+        // Once Stripe.webhooks looses the factory function signature in a future release
+        // then this should become this.webhooks = Stripe.webhooks
+        this.webhooks = createWebhooksDefault();
         this._prevRequestMetrics = [];
         this._enableTelemetry = props.telemetry !== false;
         this._requestSender = requestSender(this);
@@ -103,7 +115,6 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
         this.StripeResource = Stripe.StripeResource;
     }
     Stripe.errors = _Error;
-    Stripe.webhooks = Webhooks_js_1.createWebhooks;
     Stripe.createNodeHttpClient = platformFunctions.createNodeHttpClient;
     /**
      * Creates an HTTP client for issuing Stripe API requests which uses the Web

package/esm/net/FetchHttpClient.js

@@ -10,13 +10,79 @@ import { HttpClient, HttpClientResponse, } from './HttpClient.js';
 export class FetchHttpClient extends HttpClient {
     constructor(fetchFn) {
         super();
-        this._fetchFn = fetchFn;
+        // Default to global fetch if available
+        if (!fetchFn) {
+            if (!globalThis.fetch) {
+                throw new Error('fetch() function not provided and is not defined in the global scope. ' +
+                    'You must provide a fetch implementation.');
+            }
+            fetchFn = globalThis.fetch;
+        }
+        // Both timeout behaviors differs from Node:
+        // - Fetch uses a single timeout for the entire length of the request.
+        // - Node is more fine-grained and resets the timeout after each stage of the request.
+        if (globalThis.AbortController) {
+            // Utilise native AbortController if available
+            // AbortController was added in Node v15.0.0, v14.17.0
+            this._fetchFn = FetchHttpClient.makeFetchWithAbortTimeout(fetchFn);
+        }
+        else {
+            // Fall back to racing against a timeout promise if not available in the runtime
+            // This does not actually cancel the underlying fetch operation or resources
+            this._fetchFn = FetchHttpClient.makeFetchWithRaceTimeout(fetchFn);
+        }
+    }
+    static makeFetchWithRaceTimeout(fetchFn) {
+        return (url, init, timeout) => {
+            let pendingTimeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                pendingTimeoutId = setTimeout(() => {
+                    pendingTimeoutId = null;
+                    reject(HttpClient.makeTimeoutError());
+                }, timeout);
+            });
+            const fetchPromise = fetchFn(url, init);
+            return Promise.race([fetchPromise, timeoutPromise]).finally(() => {
+                if (pendingTimeoutId) {
+                    clearTimeout(pendingTimeoutId);
+                }
+            });
+        };
+    }
+    static makeFetchWithAbortTimeout(fetchFn) {
+        return async (url, init, timeout) => {
+            // Use AbortController because AbortSignal.timeout() was added later in Node v17.3.0, v16.14.0
+            const abort = new AbortController();
+            let timeoutId = setTimeout(() => {
+                timeoutId = null;
+                abort.abort(HttpClient.makeTimeoutError());
+            }, timeout);
+            try {
+                return await fetchFn(url, Object.assign(Object.assign({}, init), { signal: abort.signal }));
+            }
+            catch (err) {
+                // Some implementations, like node-fetch, do not respect the reason passed to AbortController.abort()
+                // and instead it always throws an AbortError
+                // We catch this case to normalise all timeout errors
+                if (err.name === 'AbortError') {
+                    throw HttpClient.makeTimeoutError();
+                }
+                else {
+                    throw err;
+                }
+            }
+            finally {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+            }
+        };
     }
     /** @override. */
     getClientName() {
         return 'fetch';
     }
-    makeRequest(host, port, path, method, headers, requestData, protocol, timeout) {
+    async makeRequest(host, port, path, method, headers, requestData, protocol, timeout) {
         const isInsecureConnection = protocol === 'http';
         const url = new URL(path, `${isInsecureConnection ? 'http' : 'https'}://${host}`);
         url.port = port;
@@ -26,43 +92,14 @@ export class FetchHttpClient extends HttpClient {
         // for more details.
         const methodHasPayload = method == 'POST' || method == 'PUT' || method == 'PATCH';
         const body = requestData || (methodHasPayload ? '' : undefined);
-        const fetchFn = this._fetchFn || fetch;
-        const fetchPromise = fetchFn(url.toString(), {
+        const res = await this._fetchFn(url.toString(), {
             method,
             // @ts-ignore
             headers,
             // @ts-ignore
             body,
-        });
-        // The Fetch API does not support passing in a timeout natively, so a
-        // timeout promise is constructed to race against the fetch and preempt the
-        // request, simulating a timeout.
-        //
-        // This timeout behavior differs from Node:
-        // - Fetch uses a single timeout for the entire length of the request.
-        // - Node is more fine-grained and resets the timeout after each stage of
-        //   the request.
-        //
-        // As an example, if the timeout is set to 30s and the connection takes 20s
-        // to be established followed by 20s for the body, Fetch would timeout but
-        // Node would not. The more fine-grained timeout cannot be implemented with
-        // fetch.
-        let pendingTimeoutId;
-        const timeoutPromise = new Promise((_, reject) => {
-            pendingTimeoutId = setTimeout(() => {
-                pendingTimeoutId = null;
-                reject(HttpClient.makeTimeoutError());
-            }, timeout);
-        });
-        return Promise.race([fetchPromise, timeoutPromise])
-            .then((res) => {
-            return new FetchHttpClientResponse(res);
-        })
-            .finally(() => {
-            if (pendingTimeoutId) {
-                clearTimeout(pendingTimeoutId);
-            }
-        });
+        }, timeout);
+        return new FetchHttpClientResponse(res);
     }
 }
 export class FetchHttpClientResponse extends HttpClientResponse {

package/esm/stripe.core.js

@@ -31,13 +31,23 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '14.4.0';
+    Stripe.PACKAGE_VERSION = '14.5.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;
     Stripe.HttpClient = HttpClient;
     Stripe.HttpClientResponse = HttpClientResponse;
     Stripe.CryptoProvider = CryptoProvider;
+    // Previously Stripe.webhooks was just the createWebhooks() factory function
+    // however going forward it will be a WebhookObject instance. To maintain
+    // backwards compatibility it is currently a factory function that also
+    // complies to the WebhookObject signature. The factory function signature
+    // will be removed as a breaking change in the next major release.
+    // See https://github.com/stripe/stripe-node/issues/1956
+    function createWebhooksDefault(fns = platformFunctions) {
+        return createWebhooks(fns);
+    }
+    Stripe.webhooks = Object.assign(createWebhooksDefault, createWebhooks(platformFunctions));
     function Stripe(key, config = {}) {
         if (!(this instanceof Stripe)) {
             return new Stripe(key, config);
@@ -91,7 +101,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         this._prepResources();
         this._setApiKey(key);
         this.errors = _Error;
-        this.webhooks = createWebhooks(platformFunctions);
+        // Once Stripe.webhooks looses the factory function signature in a future release
+        // then this should become this.webhooks = Stripe.webhooks
+        this.webhooks = createWebhooksDefault();
         this._prevRequestMetrics = [];
         this._enableTelemetry = props.telemetry !== false;
         this._requestSender = requestSender(this);
@@ -100,7 +112,6 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         this.StripeResource = Stripe.StripeResource;
     }
     Stripe.errors = _Error;
-    Stripe.webhooks = createWebhooks;
     Stripe.createNodeHttpClient = platformFunctions.createNodeHttpClient;
     /**
      * Creates an HTTP client for issuing Stripe API requests which uses the Web

package/package.json

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

package/types/Accounts.d.ts

@@ -1045,9 +1045,14 @@ declare module 'stripe' {
       namespace Settings {
         interface BacsDebitPayments {
           /**
-           * The Bacs Direct Debit Display Name for this account. For payments made with Bacs Direct Debit, this will appear on the mandate, and as the statement descriptor.
+           * The Bacs Direct Debit display name for this account. For payments made with Bacs Direct Debit, this name appears on the mandate as the statement descriptor. Mobile banking apps display it as the name of the business. To use custom branding, set the Bacs Direct Debit Display Name during or right after creation. Custom branding incurs an additional monthly fee for the platform. The fee appears 5 business days after requesting Bacs. If you don't set the display name before requesting Bacs capability, it's automatically set as "Stripe" and the account is onboarded to Stripe branding, which is free.
            */
-          display_name?: string;
+          display_name: string | null;
+
+          /**
+           * The Bacs Direct Debit Service user number for this account. For payments made with Bacs Direct Debit, this number is a unique identifier of the account with our banking partners.
+           */
+          service_user_number: string | null;
         }
 
         interface Branding {

package/types/AccountsResource.d.ts

@@ -1060,6 +1060,11 @@ declare module 'stripe' {
       }
 
       interface Settings {
+        /**
+         * Settings specific to Bacs Direct Debit.
+         */
+        bacs_debit_payments?: Settings.BacsDebitPayments;
+
         /**
          * Settings used to apply the account's branding to email receipts, invoices, Checkout, and other products.
          */
@@ -1092,6 +1097,13 @@ declare module 'stripe' {
       }
 
       namespace Settings {
+        interface BacsDebitPayments {
+          /**
+           * The Bacs Direct Debit Display Name for this account. For payments made with Bacs Direct Debit, this name appears on the mandate as the statement descriptor. Mobile banking apps display it as the name of the business. To use custom branding, set the Bacs Direct Debit Display Name during or right after creation. Custom branding incurs an additional monthly fee for the platform. If you don't set the display name before requesting Bacs capability, it's automatically set as "Stripe" and the account is onboarded to Stripe branding, which is free.
+           */
+          display_name?: string;
+        }
+
         interface Branding {
           /**
            * (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) An icon for the account. Must be square and at least 128px x 128px.
@@ -2317,6 +2329,11 @@ declare module 'stripe' {
       }
 
       interface Settings {
+        /**
+         * Settings specific to Bacs Direct Debit payments.
+         */
+        bacs_debit_payments?: Settings.BacsDebitPayments;
+
         /**
          * Settings used to apply the account's branding to email receipts, invoices, Checkout, and other products.
          */
@@ -2349,6 +2366,13 @@ declare module 'stripe' {
       }
 
       namespace Settings {
+        interface BacsDebitPayments {
+          /**
+           * The Bacs Direct Debit Display Name for this account. For payments made with Bacs Direct Debit, this name appears on the mandate as the statement descriptor. Mobile banking apps display it as the name of the business. To use custom branding, set the Bacs Direct Debit Display Name during or right after creation. Custom branding incurs an additional monthly fee for the platform. If you don't set the display name before requesting Bacs capability, it's automatically set as "Stripe" and the account is onboarded to Stripe branding, which is free.
+           */
+          display_name?: string;
+        }
+
         interface Branding {
           /**
            * (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) An icon for the account. Must be square and at least 128px x 128px.

package/types/Charges.d.ts

@@ -688,6 +688,11 @@ declare module 'stripe' {
            */
           brand: string | null;
 
+          /**
+           * When using manual capture, a future timestamp at which the charge will be automatically refunded if uncaptured.
+           */
+          capture_before?: number;
+
           /**
            * Check results by Card networks on Card address and CVC at time of payment.
            */

package/types/Checkout/Sessions.d.ts

@@ -840,6 +840,8 @@ declare module 'stripe' {
 
           paynow?: PaymentMethodOptions.Paynow;
 
+          paypal?: PaymentMethodOptions.Paypal;
+
           pix?: PaymentMethodOptions.Pix;
 
           revolut_pay?: PaymentMethodOptions.RevolutPay;
@@ -1259,6 +1261,36 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface Paypal {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+
+            /**
+             * Preferred locale of the PayPal checkout page that the customer is redirected to.
+             */
+            preferred_locale: string | null;
+
+            /**
+             * A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
+             */
+            reference: string | null;
+
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+             *
+             * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+             */
+            setup_future_usage?: Paypal.SetupFutureUsage;
+          }
+
+          namespace Paypal {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Pix {
             /**
              * The number of seconds after which Pix payment will expire.

package/types/Checkout/SessionsResource.d.ts

@@ -2219,6 +2219,11 @@ declare module 'stripe' {
          */
         payment_link?: string;
 
+        /**
+         * Only return the Checkout Sessions matching the given status.
+         */
+        status?: SessionListParams.Status;
+
         /**
          * Only return the Checkout Session for the subscription specified.
          */
@@ -2232,6 +2237,8 @@ declare module 'stripe' {
            */
           email: string;
         }
+
+        type Status = 'complete' | 'expired' | 'open';
       }
 
       interface SessionExpireParams {

package/types/CreditNotesResource.d.ts

@@ -92,7 +92,12 @@ declare module 'stripe' {
         quantity?: number;
 
         /**
-         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item`.
+         * A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
+         */
+        tax_amounts?: Stripe.Emptyable<Array<Line.TaxAmount>>;
+
+        /**
+         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
          */
         tax_rates?: Stripe.Emptyable<Array<string>>;
 
@@ -113,6 +118,23 @@ declare module 'stripe' {
       }
 
       namespace Line {
+        interface TaxAmount {
+          /**
+           * The amount, in cents (or local equivalent), of the tax.
+           */
+          amount: number;
+
+          /**
+           * The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
+           */
+          tax_rate: string;
+
+          /**
+           * The amount on which tax is calculated, in cents (or local equivalent).
+           */
+          taxable_amount: number;
+        }
+
         type Type = 'custom_line_item' | 'invoice_line_item';
       }
 
@@ -268,7 +290,12 @@ declare module 'stripe' {
         quantity?: number;
 
         /**
-         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item`.
+         * A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
+         */
+        tax_amounts?: Stripe.Emptyable<Array<Line.TaxAmount>>;
+
+        /**
+         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
          */
         tax_rates?: Stripe.Emptyable<Array<string>>;
 
@@ -289,6 +316,23 @@ declare module 'stripe' {
       }
 
       namespace Line {
+        interface TaxAmount {
+          /**
+           * The amount, in cents (or local equivalent), of the tax.
+           */
+          amount: number;
+
+          /**
+           * The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
+           */
+          tax_rate: string;
+
+          /**
+           * The amount on which tax is calculated, in cents (or local equivalent).
+           */
+          taxable_amount: number;
+        }
+
         type Type = 'custom_line_item' | 'invoice_line_item';
       }
 
@@ -396,7 +440,12 @@ declare module 'stripe' {
         quantity?: number;
 
         /**
-         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item`.
+         * A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
+         */
+        tax_amounts?: Stripe.Emptyable<Array<Line.TaxAmount>>;
+
+        /**
+         * The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
          */
         tax_rates?: Stripe.Emptyable<Array<string>>;
 
@@ -417,6 +466,23 @@ declare module 'stripe' {
       }
 
       namespace Line {
+        interface TaxAmount {
+          /**
+           * The amount, in cents (or local equivalent), of the tax.
+           */
+          amount: number;
+
+          /**
+           * The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
+           */
+          tax_rate: string;
+
+          /**
+           * The amount on which tax is calculated, in cents (or local equivalent).
+           */
+          taxable_amount: number;
+        }
+
         type Type = 'custom_line_item' | 'invoice_line_item';
       }
 

package/types/Issuing/Transactions.d.ts

@@ -88,6 +88,11 @@ declare module 'stripe' {
          */
         metadata: Stripe.Metadata;
 
+        /**
+         * Details about the transaction, such as processing dates, set by the card network.
+         */
+        network_data: Transaction.NetworkData | null;
+
         /**
          * Additional purchase information that is optionally provided by the merchant.
          */
@@ -179,6 +184,13 @@ declare module 'stripe' {
           url: string | null;
         }
 
+        interface NetworkData {
+          /**
+           * The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
+           */
+          processing_date: string | null;
+        }
+
         interface PurchaseDetails {
           /**
            * Information about the flight that was purchased with this transaction.

package/types/PricesResource.d.ts

@@ -585,7 +585,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Price>>;
 
       /**
-       * Returns a list of your prices.
+       * Returns a list of your active prices. For the list of inactive prices, set active to false.
        */
       list(
         params?: PriceListParams,

package/types/Topups.d.ts

@@ -71,7 +71,7 @@ declare module 'stripe' {
       metadata: Stripe.Metadata;
 
       /**
-       * For most Stripe users, the source of every top-up is a bank account. This hash is then the [source object](https://stripe.com/docs/api#source_object) describing that bank account.
+       * The source field is deprecated. It might not always be present in the API response.
        */
       source: Stripe.Source | null;
 

package/types/index.d.ts

@@ -233,6 +233,12 @@ declare module 'stripe' {
   export class Stripe {
     static Stripe: typeof Stripe;
 
+    // Actually has the signature `Stripe.Webhooks & ((platformFunctions?: PlatformFunctions) => Stripe.Webhooks)`
+    // However the factory function signature was never public in the typings and
+    // will be removed in the next major version so it is omitted
+    // See https://github.com/stripe/stripe-node/issues/1956
+    static webhooks: Stripe.Webhooks;
+
     constructor(apiKey: string, config?: Stripe.StripeConfig);
 
     StripeResource: Stripe.StripeResource;