stripe 15.5.0 → 15.6.0

package/CHANGELOG.md

@@ -1,31 +1,44 @@
 # Changelog
 
+## 15.6.0 - 2024-05-09
+* [#2086](https://github.com/stripe/stripe-node/pull/2086) Update generated code
+  * Remove support for `pending_invoice_items_behavior` on `SubscriptionCreateParams`
+* [#2080](https://github.com/stripe/stripe-node/pull/2080) Update generated code
+  * Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+  * Add support for `allow_redisplay` on `ConfirmationToken.payment_method_preview` and `PaymentMethod`
+  * Add support for new values `treasury.outbound_payment.tracking_details_updated` and `treasury.outbound_transfer.tracking_details_updated` on enum `Event.type`
+  * Add support for `preview_mode` on `InvoiceCreatePreviewParams`, `InvoiceUpcomingLinesParams`, and `InvoiceUpcomingParams`
+  * Add support for `pending_invoice_items_behavior` on `SubscriptionCreateParams`
+  * Add support for `tracking_details` on `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+  * Add support for new values `treasury.outbound_payment.tracking_details_updated` and `treasury.outbound_transfer.tracking_details_updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+* [#2085](https://github.com/stripe/stripe-node/pull/2085) Remove unnecessary pointer to description in deprecation message
+
 ## 15.5.0 - 2024-05-02
 * [#2072](https://github.com/stripe/stripe-node/pull/2072) Update generated code
-  * Add support for new value `shipping_address_invalid` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
-  * Fix properties incorrectly marked as required in the OpenAPI spec. 
-    * Change `Apps.Secret.payload`, `BillingPortal.Configuration.features.subscription_update.products`, `Charge.refunds`, `ConfirmationToken.payment_method_preview.klarna.dob`, `Identity.VerificationReport.document.dob`, `Identity.VerificationReport.document.expiration_date`, `Identity.VerificationReport.document.number`, `Identity.VerificationReport.id_number.dob`, `Identity.VerificationReport.id_number.id_number`, `Identity.VerificationSession.provided_details`, `Identity.VerificationSession.verified_outputs.dob`, `Identity.VerificationSession.verified_outputs.id_number`, `Identity.VerificationSession.verified_outputs`, `Issuing.Dispute.balance_transactions`, `Issuing.Transaction.purchase_details`, `PaymentMethod.klarna.dob`, `Tax.Calculation.line_items`, `Tax.CalculationLineItem.tax_breakdown`, `Tax.Transaction.line_items`, `Treasury.FinancialAccount.financial_addresses[].aba.account_number`, `Treasury.ReceivedCredit.linked_flows.source_flow_details`, `Treasury.Transaction.entries`, `Treasury.Transaction.flow_details`, and `Treasury.TransactionEntry.flow_details` to be optional 
-  * Add support for `paypal` on `Dispute.payment_method_details`
-  * Change type of `Dispute.payment_method_details.type` from `literal('card')` to `enum('card'|'paypal')`
-  * Change type of `Entitlements.FeatureUpdateParams.metadata` from `map(string: string)` to `emptyable(map(string: string))`
-  * Add support for `payment_method_types` on `PaymentIntentConfirmParams`
-  * Add support for `ship_from_details` on `Tax.CalculationCreateParams`, `Tax.Calculation`, and `Tax.Transaction`
-  * Add support for `bh`, `eg`, `ge`, `ke`, `kz`, `ng`, and `om` on `Tax.Registration.country_options` and `Tax.RegistrationCreateParams.country_options`
+  * Add support for new value `shipping_address_invalid` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Fix properties incorrectly marked as required in the OpenAPI spec.
+    * Change `Apps.Secret.payload`, `BillingPortal.Configuration.features.subscription_update.products`, `Charge.refunds`, `ConfirmationToken.payment_method_preview.klarna.dob`, `Identity.VerificationReport.document.dob`, `Identity.VerificationReport.document.expiration_date`, `Identity.VerificationReport.document.number`, `Identity.VerificationReport.id_number.dob`, `Identity.VerificationReport.id_number.id_number`, `Identity.VerificationSession.provided_details`, `Identity.VerificationSession.verified_outputs.dob`, `Identity.VerificationSession.verified_outputs.id_number`, `Identity.VerificationSession.verified_outputs`, `Issuing.Dispute.balance_transactions`, `Issuing.Transaction.purchase_details`, `PaymentMethod.klarna.dob`, `Tax.Calculation.line_items`, `Tax.CalculationLineItem.tax_breakdown`, `Tax.Transaction.line_items`, `Treasury.FinancialAccount.financial_addresses[].aba.account_number`, `Treasury.ReceivedCredit.linked_flows.source_flow_details`, `Treasury.Transaction.entries`, `Treasury.Transaction.flow_details`, and `Treasury.TransactionEntry.flow_details` to be optional
+  * Add support for `paypal` on `Dispute.payment_method_details`
+  * Change type of `Dispute.payment_method_details.type` from `literal('card')` to `enum('card'|'paypal')`
+  * Change type of `Entitlements.FeatureUpdateParams.metadata` from `map(string: string)` to `emptyable(map(string: string))`
+  * Add support for `payment_method_types` on `PaymentIntentConfirmParams`
+  * Add support for `ship_from_details` on `Tax.CalculationCreateParams`, `Tax.Calculation`, and `Tax.Transaction`
+  * Add support for `bh`, `eg`, `ge`, `ke`, `kz`, `ng`, and `om` on `Tax.Registration.country_options` and `Tax.RegistrationCreateParams.country_options`
 * [#2077](https://github.com/stripe/stripe-node/pull/2077) Deprecate Node methods and params based on OpenAPI spec
-  - Mark as deprecated the `approve` and `decline` methods on `Issuing.Authorization`. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
+  - Mark as deprecated the `approve` and `decline` methods on `Issuing.Authorization`. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
   - Mark as deprecated the `persistent_token` property on `ConfirmationToken.PaymentMethodPreview.Link`, `PaymentIntent.PaymentMethodOptions.Link`, `PaymentIntentResource.PaymentMethodOptions.Link`, `PaymentMethod.Link.persistent_token`. `SetupIntents.PaymentMethodOptions.Card.Link.persistent_token`, `SetupIntentsResource.persistent_token`. This is a legacy parameter that no longer has any function.
 * [#2074](https://github.com/stripe/stripe-node/pull/2074) Add a more explicit comment on `limit` param in `autoPagingToArray`
 
 ## 15.4.0 - 2024-04-25
 * [#2071](https://github.com/stripe/stripe-node/pull/2071) Update generated code
-  * Add support for `setup_future_usage` on `Checkout.Session.payment_method_options.amazon_pay`, `Checkout.Session.payment_method_options.revolut_pay`, `PaymentIntent.payment_method_options.amazon_pay`, and `PaymentIntent.payment_method_options.revolut_pay`
-  * Change type of `Entitlements.ActiveEntitlement.feature` from `string` to `expandable(Entitlements.Feature)`
-  * Remove support for inadvertently released identity verification features `email` and `phone` on `Identity.VerificationSessionCreateParams.options` and `Identity.VerificationSessionUpdateParams.options`
-  * Change `Identity.VerificationSession.provided_details`, `Identity.VerificationSession.verified_outputs.email`, and `Identity.VerificationSession.verified_outputs.phone` to be required
-  * Add support for new values `amazon_pay` and `revolut_pay` on enums `Invoice.payment_settings.payment_method_types[]`, `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `Subscription.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
-  * Add support for `amazon_pay` and `revolut_pay` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
-  * Add support for `ending_before`, `limit`, and `starting_after` on `PaymentMethodConfigurationListParams`
-  * Add support for `mobilepay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+  * Add support for `setup_future_usage` on `Checkout.Session.payment_method_options.amazon_pay`, `Checkout.Session.payment_method_options.revolut_pay`, `PaymentIntent.payment_method_options.amazon_pay`, and `PaymentIntent.payment_method_options.revolut_pay`
+  * Change type of `Entitlements.ActiveEntitlement.feature` from `string` to `expandable(Entitlements.Feature)`
+  * Remove support for inadvertently released identity verification features `email` and `phone` on `Identity.VerificationSessionCreateParams.options` and `Identity.VerificationSessionUpdateParams.options`
+  * Change `Identity.VerificationSession.provided_details`, `Identity.VerificationSession.verified_outputs.email`, and `Identity.VerificationSession.verified_outputs.phone` to be required
+  * Add support for new values `amazon_pay` and `revolut_pay` on enums `Invoice.payment_settings.payment_method_types[]`, `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `Subscription.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+  * Add support for `amazon_pay` and `revolut_pay` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
+  * Add support for `ending_before`, `limit`, and `starting_after` on `PaymentMethodConfigurationListParams`
+  * Add support for `mobilepay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
 * [#2061](https://github.com/stripe/stripe-node/pull/2061) Make cloudflare package export
 
 ## 15.3.0 - 2024-04-18

package/VERSION

@@ -1 +1 @@
-15.5.0
+15.6.0

package/cjs/resources/TestHelpers/Treasury/OutboundPayments.js

@@ -5,6 +5,10 @@ exports.OutboundPayments = void 0;
 const StripeResource_js_1 = require("../../../StripeResource.js");
 const stripeMethod = StripeResource_js_1.StripeResource.method;
 exports.OutboundPayments = StripeResource_js_1.StripeResource.extend({
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/treasury/outbound_payments/{id}',
+    }),
     fail: stripeMethod({
         method: 'POST',
         fullPath: '/v1/test_helpers/treasury/outbound_payments/{id}/fail',

package/cjs/resources/TestHelpers/Treasury/OutboundTransfers.js

@@ -5,6 +5,10 @@ exports.OutboundTransfers = void 0;
 const StripeResource_js_1 = require("../../../StripeResource.js");
 const stripeMethod = StripeResource_js_1.StripeResource.method;
 exports.OutboundTransfers = StripeResource_js_1.StripeResource.extend({
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/treasury/outbound_transfers/{outbound_transfer}',
+    }),
     fail: stripeMethod({
         method: 'POST',
         fullPath: '/v1/test_helpers/treasury/outbound_transfers/{outbound_transfer}/fail',

package/cjs/stripe.core.js

@@ -34,7 +34,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 = '15.5.0';
+    Stripe.PACKAGE_VERSION = '15.6.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/resources/TestHelpers/Treasury/OutboundPayments.js

@@ -2,6 +2,10 @@
 import { StripeResource } from '../../../StripeResource.js';
 const stripeMethod = StripeResource.method;
 export const OutboundPayments = StripeResource.extend({
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/treasury/outbound_payments/{id}',
+    }),
     fail: stripeMethod({
         method: 'POST',
         fullPath: '/v1/test_helpers/treasury/outbound_payments/{id}/fail',

package/esm/resources/TestHelpers/Treasury/OutboundTransfers.js

@@ -2,6 +2,10 @@
 import { StripeResource } from '../../../StripeResource.js';
 const stripeMethod = StripeResource.method;
 export const OutboundTransfers = StripeResource.extend({
+    update: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/test_helpers/treasury/outbound_transfers/{outbound_transfer}',
+    }),
     fail: stripeMethod({
         method: 'POST',
         fullPath: '/v1/test_helpers/treasury/outbound_transfers/{outbound_transfer}/fail',

package/esm/stripe.core.js

@@ -31,7 +31,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 = '15.5.0';
+    Stripe.PACKAGE_VERSION = '15.6.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": "15.5.0",
+  "version": "15.6.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Accounts.d.ts

@@ -69,7 +69,7 @@ declare module 'stripe' {
       deleted?: void;
 
       /**
-       * Whether account details have been submitted. Accounts with Stripe Dashboard access, which includes Standard accounts, cannot receive payouts before this is true.
+       * Whether account details have been submitted. Accounts with Stripe Dashboard access, which includes Standard accounts, cannot receive payouts before this is true. Accounts where this is false should be directed to [an onboarding flow](https://stripe.com/connect/onboarding) to finish submitting account details.
        */
       details_submitted: boolean;
 

package/types/AccountsResource.d.ts

@@ -1030,12 +1030,12 @@ declare module 'stripe' {
         address?: Stripe.AddressParam;
 
         /**
-         * The Kana variation of the the individual's primary address (Japan only).
+         * The Kana variation of the individual's primary address (Japan only).
          */
         address_kana?: Stripe.JapanAddressParam;
 
         /**
-         * The Kanji variation of the the individual's primary address (Japan only).
+         * The Kanji variation of the individual's primary address (Japan only).
          */
         address_kanji?: Stripe.JapanAddressParam;
 
@@ -1055,7 +1055,7 @@ declare module 'stripe' {
         first_name?: string;
 
         /**
-         * The Kana variation of the the individual's first name (Japan only).
+         * The Kana variation of the individual's first name (Japan only).
          */
         first_name_kana?: string;
 
@@ -2488,12 +2488,12 @@ declare module 'stripe' {
         address?: Stripe.AddressParam;
 
         /**
-         * The Kana variation of the the individual's primary address (Japan only).
+         * The Kana variation of the individual's primary address (Japan only).
          */
         address_kana?: Stripe.JapanAddressParam;
 
         /**
-         * The Kanji variation of the the individual's primary address (Japan only).
+         * The Kanji variation of the individual's primary address (Japan only).
          */
         address_kanji?: Stripe.JapanAddressParam;
 
@@ -2513,7 +2513,7 @@ declare module 'stripe' {
         first_name?: string;
 
         /**
-         * The Kana variation of the the individual's first name (Japan only).
+         * The Kana variation of the individual's first name (Japan only).
          */
         first_name_kana?: string;
 

package/types/Capabilities.d.ts

@@ -226,13 +226,11 @@ declare module 'stripe' {
         currently_due: Array<string>;
 
         /**
-         * If the capability is disabled, this string describes why. Can be `requirements.fields_needed`, `pending.onboarding`, `pending.review`, `rejected.fraud`, `rejected.other`, `platform_paused`, `action_required.requested_capabilities`, `rejected.inactivty`, or `rejected.unsupported_business`.
+         * If the capability is disabled, this string describes why. [Learn more about handling verification issues](https://stripe.com/docs/connect/handling-api-verification). Can be `requirements.fields_needed`, `pending.onboarding`, `pending.review`, `rejected.other`, `platform_paused`, `rejected.inactivty`, or `rejected.unsupported_business`.
          *
          * `rejected.unsupported_business` means that the account's business is not supported by the capability. For example, payment methods may restrict the businesses they support in their terms of service, such as in [Afterpay Clearpay's terms of service](https://stripe.com/afterpay-clearpay/legal#restricted-businesses).
          *
          * `rejected.inactivity` means that the capability has been paused for inactivity. This disabled reason currently only applies to the Issuing capability. See [Issuing: Managing Inactive Connects](https://support.stripe.com/questions/issuing-managing-inactive-connect-accounts) for more details.
-         *
-         * If you believe that a rejection is in error, please contact support at https://support.stripe.com/contact/ for assistance.
          */
         disabled_reason: string | null;
 

package/types/Checkout/Sessions.d.ts

@@ -1538,7 +1538,7 @@ declare module 'stripe' {
           > | null;
 
           /**
-           * Enable customers to choose if they wish to save their payment method for future use.
+           * Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
            */
           payment_method_save: SavedPaymentMethodOptions.PaymentMethodSave | null;
         }

package/types/Checkout/SessionsResource.d.ts

@@ -1832,7 +1832,7 @@ declare module 'stripe' {
           >;
 
           /**
-           * Enable customers to choose if they wish to save their payment method for future use.
+           * Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
            */
           payment_method_save?: SavedPaymentMethodOptions.PaymentMethodSave;
         }

package/types/ConfirmationTokens.d.ts

@@ -125,6 +125,11 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodPreview.Alipay;
 
+        /**
+         * This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
+         */
+        allow_redisplay?: PaymentMethodPreview.AllowRedisplay;
+
         amazon_pay?: PaymentMethodPreview.AmazonPay;
 
         au_becs_debit?: PaymentMethodPreview.AuBecsDebit;
@@ -233,6 +238,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        type AllowRedisplay = 'always' | 'limited' | 'unspecified';
+
         interface AmazonPay {}
 
         interface AuBecsDebit {

package/types/CreditNotesResource.d.ts

@@ -566,7 +566,7 @@ declare module 'stripe' {
       list(options?: RequestOptions): ApiListPromise<Stripe.CreditNote>;
 
       /**
-       * When retrieving a credit note, you'll get a lines property containing the the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
+       * When retrieving a credit note, you'll get a lines property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
        */
       listLineItems(
         id: string,

package/types/EventTypes.d.ts

@@ -220,12 +220,14 @@ declare module 'stripe' {
       | TreasuryOutboundPaymentFailedEvent
       | TreasuryOutboundPaymentPostedEvent
       | TreasuryOutboundPaymentReturnedEvent
+      | TreasuryOutboundPaymentTrackingDetailsUpdatedEvent
       | TreasuryOutboundTransferCanceledEvent
       | TreasuryOutboundTransferCreatedEvent
       | TreasuryOutboundTransferExpectedArrivalDateUpdatedEvent
       | TreasuryOutboundTransferFailedEvent
       | TreasuryOutboundTransferPostedEvent
       | TreasuryOutboundTransferReturnedEvent
+      | TreasuryOutboundTransferTrackingDetailsUpdatedEvent
       | TreasuryReceivedCreditCreatedEvent
       | TreasuryReceivedCreditFailedEvent
       | TreasuryReceivedCreditSucceededEvent
@@ -3711,6 +3713,23 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs whenever tracking_details on an OutboundPayment is updated.
+     */
+    interface TreasuryOutboundPaymentTrackingDetailsUpdatedEvent
+      extends EventBase {
+      type: 'treasury.outbound_payment.tracking_details_updated';
+      data: TreasuryOutboundPaymentTrackingDetailsUpdatedEvent.Data;
+    }
+
+    namespace TreasuryOutboundPaymentTrackingDetailsUpdatedEvent {
+      interface Data extends Stripe.Event.Data {
+        object: Stripe.Treasury.OutboundPayment;
+
+        previous_attributes?: Partial<Stripe.Treasury.OutboundPayment>;
+      }
+    }
+
     /**
      * Occurs whenever an OutboundTransfer is canceled.
      */
@@ -3808,6 +3827,23 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs whenever tracking_details on an OutboundTransfer is updated.
+     */
+    interface TreasuryOutboundTransferTrackingDetailsUpdatedEvent
+      extends EventBase {
+      type: 'treasury.outbound_transfer.tracking_details_updated';
+      data: TreasuryOutboundTransferTrackingDetailsUpdatedEvent.Data;
+    }
+
+    namespace TreasuryOutboundTransferTrackingDetailsUpdatedEvent {
+      interface Data extends Stripe.Event.Data {
+        object: Stripe.Treasury.OutboundTransfer;
+
+        previous_attributes?: Partial<Stripe.Treasury.OutboundTransfer>;
+      }
+    }
+
     /**
      * Occurs whenever a received_credit is created as a result of funds being pushed by another account.
      */

package/types/Events.d.ts

@@ -251,12 +251,14 @@ declare module 'stripe' {
         | 'treasury.outbound_payment.failed'
         | 'treasury.outbound_payment.posted'
         | 'treasury.outbound_payment.returned'
+        | 'treasury.outbound_payment.tracking_details_updated'
         | 'treasury.outbound_transfer.canceled'
         | 'treasury.outbound_transfer.created'
         | 'treasury.outbound_transfer.expected_arrival_date_updated'
         | 'treasury.outbound_transfer.failed'
         | 'treasury.outbound_transfer.posted'
         | 'treasury.outbound_transfer.returned'
+        | 'treasury.outbound_transfer.tracking_details_updated'
         | 'treasury.received_credit.created'
         | 'treasury.received_credit.failed'
         | 'treasury.received_credit.succeeded'

package/types/InvoiceItemsResource.d.ts

@@ -69,7 +69,7 @@ declare module 'stripe' {
       quantity?: number;
 
       /**
-       * The ID of a subscription to add this invoice item to. When left blank, the invoice item will be be added to the next upcoming scheduled invoice. When set, scheduled invoices for subscriptions other than the specified subscription will ignore the invoice item. Use this when you want to express that an invoice item has been accrued within the context of a particular subscription.
+       * The ID of a subscription to add this invoice item to. When left blank, the invoice item is added to the next upcoming scheduled invoice. When set, scheduled invoices for subscriptions other than the specified subscription will ignore the invoice item. Use this when you want to express that an invoice item has been accrued within the context of a particular subscription.
        */
       subscription?: string;
 

package/types/InvoicesResource.d.ts

@@ -1475,6 +1475,11 @@ declare module 'stripe' {
        */
       on_behalf_of?: Stripe.Emptyable<string>;
 
+      /**
+       * Customizes the types of values to include when calculating the invoice. Defaults to `next` if unspecified.
+       */
+      preview_mode?: InvoiceCreatePreviewParams.PreviewMode;
+
       /**
        * The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields.
        */
@@ -1848,6 +1853,8 @@ declare module 'stripe' {
         type Type = 'account' | 'self';
       }
 
+      type PreviewMode = 'next' | 'recurring';
+
       interface ScheduleDetails {
         /**
          * Behavior of the subscription schedule and underlying subscription when it ends. Possible values are `release` or `cancel` with the default being `release`. `release` will end the subscription schedule and keep the underlying subscription running. `cancel` will end the subscription schedule and cancel the underlying subscription.
@@ -2579,6 +2586,11 @@ declare module 'stripe' {
        */
       on_behalf_of?: Stripe.Emptyable<string>;
 
+      /**
+       * Customizes the types of values to include when calculating the invoice. Defaults to `next` if unspecified.
+       */
+      preview_mode?: InvoiceListUpcomingLinesParams.PreviewMode;
+
       /**
        * The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields.
        */
@@ -3016,6 +3028,8 @@ declare module 'stripe' {
         type Type = 'account' | 'self';
       }
 
+      type PreviewMode = 'next' | 'recurring';
+
       interface ScheduleDetails {
         /**
          * Behavior of the subscription schedule and underlying subscription when it ends. Possible values are `release` or `cancel` with the default being `release`. `release` will end the subscription schedule and keep the underlying subscription running. `cancel` will end the subscription schedule and cancel the underlying subscription.
@@ -3918,6 +3932,11 @@ declare module 'stripe' {
        */
       on_behalf_of?: Stripe.Emptyable<string>;
 
+      /**
+       * Customizes the types of values to include when calculating the invoice. Defaults to `next` if unspecified.
+       */
+      preview_mode?: InvoiceRetrieveUpcomingParams.PreviewMode;
+
       /**
        * The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields.
        */
@@ -4355,6 +4374,8 @@ declare module 'stripe' {
         type Type = 'account' | 'self';
       }
 
+      type PreviewMode = 'next' | 'recurring';
+
       interface ScheduleDetails {
         /**
          * Behavior of the subscription schedule and underlying subscription when it ends. Possible values are `release` or `cancel` with the default being `release`. `release` will end the subscription schedule and keep the underlying subscription running. `cancel` will end the subscription schedule and cancel the underlying subscription.

package/types/Issuing/AuthorizationsResource.d.ts

@@ -119,7 +119,7 @@ declare module 'stripe' {
         /**
          * [Deprecated] Approves a pending Issuing Authorization object. This request should be made within the timeout window of the [real-time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow.
          * This method is deprecated. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
-         * @deprecated This method is deprecated, please refer to the description for details.
+         * @deprecated
          */
         approve(
           id: string,
@@ -134,7 +134,7 @@ declare module 'stripe' {
         /**
          * [Deprecated] Declines a pending Issuing Authorization object. This request should be made within the timeout window of the [real time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow.
          * This method is deprecated. Instead, [respond directly to the webhook request to decline an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
-         * @deprecated This method is deprecated, please refer to the description for details.
+         * @deprecated
          */
         decline(
           id: string,

package/types/PaymentMethods.d.ts

@@ -28,6 +28,11 @@ declare module 'stripe' {
 
       alipay?: PaymentMethod.Alipay;
 
+      /**
+       * This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
+       */
+      allow_redisplay?: PaymentMethod.AllowRedisplay;
+
       amazon_pay?: PaymentMethod.AmazonPay;
 
       au_becs_debit?: PaymentMethod.AuBecsDebit;
@@ -161,6 +166,8 @@ declare module 'stripe' {
 
       interface Alipay {}
 
+      type AllowRedisplay = 'always' | 'limited' | 'unspecified';
+
       interface AmazonPay {}
 
       interface AuBecsDebit {

package/types/TestHelpers/Treasury/OutboundPaymentsResource.d.ts

@@ -3,6 +3,62 @@
 declare module 'stripe' {
   namespace Stripe {
     namespace TestHelpers {
+      namespace Treasury {
+        interface OutboundPaymentUpdateParams {
+          /**
+           * Details about network-specific tracking information.
+           */
+          tracking_details: OutboundPaymentUpdateParams.TrackingDetails;
+
+          /**
+           * Specifies which fields in the response should be expanded.
+           */
+          expand?: Array<string>;
+        }
+
+        namespace OutboundPaymentUpdateParams {
+          interface TrackingDetails {
+            /**
+             * ACH network tracking details.
+             */
+            ach?: TrackingDetails.Ach;
+
+            /**
+             * The US bank account network used to send funds.
+             */
+            type: TrackingDetails.Type;
+
+            /**
+             * US domestic wire network tracking details.
+             */
+            us_domestic_wire?: TrackingDetails.UsDomesticWire;
+          }
+
+          namespace TrackingDetails {
+            interface Ach {
+              /**
+               * ACH trace ID for funds sent over the `ach` network.
+               */
+              trace_id: string;
+            }
+
+            type Type = 'ach' | 'us_domestic_wire';
+
+            interface UsDomesticWire {
+              /**
+               * IMAD for funds sent over the `us_domestic_wire` network.
+               */
+              imad?: string;
+
+              /**
+               * OMAD for funds sent over the `us_domestic_wire` network.
+               */
+              omad?: string;
+            }
+          }
+        }
+      }
+
       namespace Treasury {
         interface OutboundPaymentFailParams {
           /**
@@ -29,7 +85,7 @@ declare module 'stripe' {
           expand?: Array<string>;
 
           /**
-           * Optional hash to set the the return code.
+           * Optional hash to set the return code.
            */
           returned_details?: OutboundPaymentReturnOutboundPaymentParams.ReturnedDetails;
         }
@@ -60,6 +116,15 @@ declare module 'stripe' {
 
       namespace Treasury {
         class OutboundPaymentsResource {
+          /**
+           * Updates a test mode created OutboundPayment with tracking details. The OutboundPayment must not be cancelable, and cannot be in the canceled or failed states.
+           */
+          update(
+            id: string,
+            params: OutboundPaymentUpdateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+
           /**
            * Transitions a test mode created OutboundPayment to the failed status. The OutboundPayment must already be in the processing state.
            */

package/types/TestHelpers/Treasury/OutboundTransfersResource.d.ts

@@ -3,6 +3,62 @@
 declare module 'stripe' {
   namespace Stripe {
     namespace TestHelpers {
+      namespace Treasury {
+        interface OutboundTransferUpdateParams {
+          /**
+           * Details about network-specific tracking information.
+           */
+          tracking_details: OutboundTransferUpdateParams.TrackingDetails;
+
+          /**
+           * Specifies which fields in the response should be expanded.
+           */
+          expand?: Array<string>;
+        }
+
+        namespace OutboundTransferUpdateParams {
+          interface TrackingDetails {
+            /**
+             * ACH network tracking details.
+             */
+            ach?: TrackingDetails.Ach;
+
+            /**
+             * The US bank account network used to send funds.
+             */
+            type: TrackingDetails.Type;
+
+            /**
+             * US domestic wire network tracking details.
+             */
+            us_domestic_wire?: TrackingDetails.UsDomesticWire;
+          }
+
+          namespace TrackingDetails {
+            interface Ach {
+              /**
+               * ACH trace ID for funds sent over the `ach` network.
+               */
+              trace_id: string;
+            }
+
+            type Type = 'ach' | 'us_domestic_wire';
+
+            interface UsDomesticWire {
+              /**
+               * IMAD for funds sent over the `us_domestic_wire` network.
+               */
+              imad?: string;
+
+              /**
+               * OMAD for funds sent over the `us_domestic_wire` network.
+               */
+              omad?: string;
+            }
+          }
+        }
+      }
+
       namespace Treasury {
         interface OutboundTransferFailParams {
           /**
@@ -60,6 +116,15 @@ declare module 'stripe' {
 
       namespace Treasury {
         class OutboundTransfersResource {
+          /**
+           * Updates a test mode created OutboundTransfer with tracking details. The OutboundTransfer must not be cancelable, and cannot be in the canceled or failed states.
+           */
+          update(
+            id: string,
+            params: OutboundTransferUpdateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Treasury.OutboundTransfer>>;
+
           /**
            * Transitions a test mode created OutboundTransfer to the failed status. The OutboundTransfer must already be in the processing state.
            */

package/types/TokensResource.d.ts

@@ -248,12 +248,12 @@ declare module 'stripe' {
           address?: Stripe.AddressParam;
 
           /**
-           * The Kana variation of the the individual's primary address (Japan only).
+           * The Kana variation of the individual's primary address (Japan only).
            */
           address_kana?: Stripe.JapanAddressParam;
 
           /**
-           * The Kanji variation of the the individual's primary address (Japan only).
+           * The Kanji variation of the individual's primary address (Japan only).
            */
           address_kanji?: Stripe.JapanAddressParam;
 
@@ -273,7 +273,7 @@ declare module 'stripe' {
           first_name?: string;
 
           /**
-           * The Kana variation of the the individual's first name (Japan only).
+           * The Kana variation of the individual's first name (Japan only).
            */
           first_name_kana?: string;
 

package/types/Treasury/OutboundPayments.d.ts

@@ -106,6 +106,11 @@ declare module 'stripe' {
 
         status_transitions: OutboundPayment.StatusTransitions;
 
+        /**
+         * Details about network-specific tracking information if available.
+         */
+        tracking_details?: OutboundPayment.TrackingDetails | null;
+
         /**
          * The Transaction associated with this object.
          */
@@ -272,6 +277,40 @@ declare module 'stripe' {
            */
           returned_at: number | null;
         }
+
+        interface TrackingDetails {
+          ach?: TrackingDetails.Ach;
+
+          /**
+           * The US bank account network used to send funds.
+           */
+          type: TrackingDetails.Type;
+
+          us_domestic_wire?: TrackingDetails.UsDomesticWire;
+        }
+
+        namespace TrackingDetails {
+          interface Ach {
+            /**
+             * ACH trace ID of the OutboundPayment for payments sent over the `ach` network.
+             */
+            trace_id: string;
+          }
+
+          type Type = 'ach' | 'us_domestic_wire';
+
+          interface UsDomesticWire {
+            /**
+             * IMAD of the OutboundPayment for payments sent over the `us_domestic_wire` network.
+             */
+            imad: string;
+
+            /**
+             * OMAD of the OutboundPayment for payments sent over the `us_domestic_wire` network.
+             */
+            omad: string | null;
+          }
+        }
       }
     }
   }

package/types/Treasury/OutboundTransfers.d.ts

@@ -93,6 +93,11 @@ declare module 'stripe' {
 
         status_transitions: OutboundTransfer.StatusTransitions;
 
+        /**
+         * Details about network-specific tracking information if available.
+         */
+        tracking_details?: OutboundTransfer.TrackingDetails | null;
+
         /**
          * The Transaction associated with this object.
          */
@@ -231,6 +236,40 @@ declare module 'stripe' {
            */
           returned_at: number | null;
         }
+
+        interface TrackingDetails {
+          ach?: TrackingDetails.Ach;
+
+          /**
+           * The US bank account network used to send funds.
+           */
+          type: TrackingDetails.Type;
+
+          us_domestic_wire?: TrackingDetails.UsDomesticWire;
+        }
+
+        namespace TrackingDetails {
+          interface Ach {
+            /**
+             * ACH trace ID of the OutboundTransfer for transfers sent over the `ach` network.
+             */
+            trace_id: string;
+          }
+
+          type Type = 'ach' | 'us_domestic_wire';
+
+          interface UsDomesticWire {
+            /**
+             * IMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
+             */
+            imad: string;
+
+            /**
+             * OMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
+             */
+            omad: string | null;
+          }
+        }
       }
     }
   }

package/types/WebhookEndpointsResource.d.ts

@@ -362,12 +362,14 @@ declare module 'stripe' {
         | 'treasury.outbound_payment.failed'
         | 'treasury.outbound_payment.posted'
         | 'treasury.outbound_payment.returned'
+        | 'treasury.outbound_payment.tracking_details_updated'
         | 'treasury.outbound_transfer.canceled'
         | 'treasury.outbound_transfer.created'
         | 'treasury.outbound_transfer.expected_arrival_date_updated'
         | 'treasury.outbound_transfer.failed'
         | 'treasury.outbound_transfer.posted'
         | 'treasury.outbound_transfer.returned'
+        | 'treasury.outbound_transfer.tracking_details_updated'
         | 'treasury.received_credit.created'
         | 'treasury.received_credit.failed'
         | 'treasury.received_credit.succeeded'
@@ -633,12 +635,14 @@ declare module 'stripe' {
         | 'treasury.outbound_payment.failed'
         | 'treasury.outbound_payment.posted'
         | 'treasury.outbound_payment.returned'
+        | 'treasury.outbound_payment.tracking_details_updated'
         | 'treasury.outbound_transfer.canceled'
         | 'treasury.outbound_transfer.created'
         | 'treasury.outbound_transfer.expected_arrival_date_updated'
         | 'treasury.outbound_transfer.failed'
         | 'treasury.outbound_transfer.posted'
         | 'treasury.outbound_transfer.returned'
+        | 'treasury.outbound_transfer.tracking_details_updated'
         | 'treasury.received_credit.created'
         | 'treasury.received_credit.failed'
         | 'treasury.received_credit.succeeded'