stripe 10.2.0 → 10.3.0-beta.1

package/CHANGELOG.md

@@ -1,63 +1,39 @@
 # Changelog
 
+## 10.3.0-beta.1 - 2022-08-11
+* [#1511](https://github.com/stripe/stripe-node/pull/1511) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Add refund_payment method to Terminal resource
+
 ## 10.2.0 - 2022-08-11
 * [#1510](https://github.com/stripe/stripe-node/pull/1510) API Updates
-  * Add support for `payment_method_collection` on `Checkout.Session`, `CheckoutSessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
-  
+  * Add support for `payment_method_collection` on `Checkout.Session`, `CheckoutSessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
 
 ## 10.1.0 - 2022-08-09
 * [#1506](https://github.com/stripe/stripe-node/pull/1506) API Updates
   * Add support for `process_config` on `Terminal.Reader.action.process_payment_intent`
 * [#1505](https://github.com/stripe/stripe-node/pull/1505) Simplify AddressParam definitions
-  - Rename `AddressParam` to `ShippingAddressParam`, and change type of `Source.source_order.shipping.address`, `SourceUpdateParams.SourceOrder.Shipping.address`, and `SessionCreateParams.PaymentIntentData.Shipping.address` to `ShippingAddressParam`
+  - Rename `AddressParam` to `ShippingAddressParam`, and change type of `Source.source_order.shipping.address`, `SourceUpdateParams.SourceOrder.Shipping.address`, and `SessionCreateParams.PaymentIntentData.Shipping.address` to `ShippingAddressParam`
   - Rename `AccountAddressParam` go `AddressParam`, and change type of `AccountCreateParams.BusinessProfile.support_address`, `AccountCreateParams.Company.address`, `AccountCreateParams.Individual.address `, `AccountCreateParams.Individual.registered_address`, `AccountUpdateParams.BusinessProfile.support_address`, `AccountUpdateParams.Company.address`, `AccountUpdateParams.Individual.address`, `AccountUpdateParams.Individual.registered_address`, `ChargeCreateParams.Shipping.address`, `ChargeUpdateParams.Shipping.address`, `CustomerCreateParams.Shipping.address`, `CustomerUpdateParams.Shipping.address`, `CustomerSourceUpdateParams.Owner.address`, `InvoiceListUpcomingLinesParams.CustomerDetails.Shipping.address`, `InvoiceRetrieveUpcomingParams.CustomerDetails.Shipping.address`, `OrderCreateParams.BillingDetails.address`, `OrderCreateParams.ShippingDetails.address`, `OrderUpdateParams.BillingDetails.address`, `OrderUpdateParams.ShippingDetails.address`, `PaymentIntentCreateParams.Shipping.address`, `PaymentIntentUpdateParams.Shipping.address`, `PaymentIntentConfirmParams.Shipping.address`, `PersonCreateParams.address`, `PersonCreateParams.registered_address`, `PersonUpdateParams.address`, `PersonUpdateParams.registered_address`, `SourceCreateParams.Owner.address`, `SourceUpdateParams.Owner.address`, `TokenCreateParams.Account.Company.address`, `TokenCreateParams.Account.Individual.address`, `TokenCreateParams.Account.Individual.registered_address`, `TokenCreateParams.Person.address`, `TokenCreateParams.Person.registered_address`, and `Terminal.LocationUpdateParams.address` to `AddressParam`
 * [#1503](https://github.com/stripe/stripe-node/pull/1503) API Updates
   * Add support for `expires_at` on `Apps.Secret` and `AppsSecretCreateParams`
 
+## 10.1.0-beta.1 - 2022-08-03
+* [#1498](https://github.com/stripe/stripe-node/pull/1498) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Added the `Order` resource support
+
 ## 10.0.0 - 2022-08-02
 
-This release includes breaking changes resulting from:
+Major version release for API version 2022-08-01. Default API version changed to "2022-08-01".
 
-* Moving to use the new API version "2022-08-01". To learn more about these changes to Stripe products, see https://stripe.com/docs/upgrades#2022-08-01
-* Cleaning up the SDK to remove deprecated/unused APIs and rename classes/methods/properties to sync with product APIs. Read more detailed description at https://github.com/stripe/stripe-node/wiki/Migration-guide-for-v10.
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-node/wiki/Migration-guide-for-v10. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-08-01.
 
 "⚠️" symbol highlights breaking changes.
 
 * [#1497](https://github.com/stripe/stripe-node/pull/1497) API Updates
 * [#1493](https://github.com/stripe/stripe-node/pull/1493) Next major release changes
 
-### Added
-* Add support for new value `invalid_tos_acceptance` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `Capability.future_requirements.errors[].code`, `Capability.requirements.errors[].code`, `Person.future_requirements.errors[].code`, and `Person.requirements.errors[].code`
-* Add support for `shipping_cost` and `shipping_details` on `Checkout.Session`
-
-### ⚠️ Changed
-* Change type of `business_profile`, `business_type`, `country`, `default_currency`, and `settings` properties on `Account` resource to be nullable.
-* Change type of `currency` property on `Checkout.Session` resource from `string` to `'cad' | 'usd'`.
-* Change location of TypeScript definitions for `CreditNoteLineItemListPreviewParams`, `CreditNoteLineItemListPreviewParams.Line`, `CreditNoteLineItemListPreviewParams.Line.Type`, and `CreditNoteLineItemListPreviewParams.Line.Reason` interfaces from `CreditNoteLineItems.d.ts` to `CreditNotes.d.ts`.
-* Change type of `address`, `currency`, `delinquent`, `discount`, `invoice_prefix`, `name`, `phone`, and `preferred_locales` properties on `Customer` resource to be nullable.
-* Rename `InvoiceRetrieveUpcomingParams` to `InvoiceListUpcomingLinesParams`.
-
-### ⚠️ Removed
-* Remove for `AlipayAccount`, `DeletedAlipayAccount`, `BitcoinReceiver`, `DeletedBitcoinReceiver`, `BitcoinTransaction`, and `BitcoinTransactionListParams` definitions.
-* Remove `AlipayAccount` and `BitcoinReceiver` from `CustomerSource`.
-* Remove `Stripe.DeletedAlipayAccount` and `Stripe.DeletedBitcoinReceiver` from possible values of `source` property in `PaymentIntent`.
-* Remove `IssuerFraudRecord`, `IssuerFraudRecordRetrieveParams`, `IssuerFraudRecordListParams`, and `IssuerFraudRecordsResource`, definitions.
-* Remove `treasury.received_credit.reversed` webhook event constant. Please use `treasury.received_credit.returned` instead.
-* Remove `order.payment_failed`, `transfer.failed`, and `transfer.paid`. The events were deprecated.
-* Remove `retrieveDetails` method from `Issuing.Card` resource. The method was unsupported. Read more at https://stripe.com/docs/issuing/cards/virtual.
-* Remove `Issuing.CardDetails` and `CardRetrieveDetailsParams` definition.
-* Remove `IssuerFraudRecords` resource.
-* Remove `Recipient` resource and`recipient` property from `Card` resource.
-* Remove `InvoiceMarkUncollectibleParams` definition.
-* Remove deprecated `Stripe.Errors` and `StripeError` (and derived `StripeCardError`, `StripeInvalidRequestError`, `StripeAPIError`, `StripeAuthenticationError`,  `StripePermissionError`, `StripeRateLimitError`, `StripeConnectionError`, `StripeSignatureVerificationError`, `StripeIdempotencyError`, and `StripeInvalidGrantError`)  definitions.
-* Remove `redirect_url` from `LoginLinks` definition. The property is no longer supported.
-* Remove `LineItemListParams` definition. The interface was no longer in use.
-
-### ⚠️ Renamed
-* Rename `listUpcomingLineItems` method on `Invoice` resource to `listUpcomingLines`.
-* Rename `InvoiceLineItemListUpcomingParams` to `InvoiceListUpcomingLinesParams`.
-* Rename `InvoiceRetrieveUpcomingParams` to `InvoiceListUpcomingLinesParams`.
-
 ## 9.16.0 - 2022-07-26
 * [#1492](https://github.com/stripe/stripe-node/pull/1492) API Updates
   * Add support for new value `exempted` on enums `Charge.payment_method_details.card.three_d_secure.result` and `SetupAttempt.payment_method_details.card.three_d_secure.result`
@@ -74,6 +50,20 @@ This release includes breaking changes resulting from:
   * Add support for `mandate` on `InvoicePayParams`
   * Add support for `product_data` on `OrderCreateParams.line_items[]` and `OrderUpdateParams.line_items[]`
 
+## 9.15.0-beta.1 - 2022-07-22
+* [#1485](https://github.com/stripe/stripe-node/pull/1485) API Updates for beta branch
+  - Updated stable APIs to the latest version
+* [#1483](https://github.com/stripe/stripe-node/pull/1483) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Add `QuotePhase` resource
+* [#1479](https://github.com/stripe/stripe-node/pull/1479) API Updates for beta branch
+  - Updated stable APIs to the latest version
+  - Add `Price.migrate_to` property
+  - Add `SubscriptionSchedule.amend` method.
+  - Add `Discount.subscription_item` property.
+  - Add `Quote.subscription_data.billing_behavior`, `billing_cycle_anchor`, `end_behavior`, `from_schedule`, `from_subscription`, `prebilling`, `proration_behavior` properties.
+  - Add `phases` parameter to `Quote.create`
+  - Add `Subscription.discounts`, `prebilling` properties.
 
 ## 9.14.0 - 2022-07-18
 * [#1477](https://github.com/stripe/stripe-node/pull/1477) API Updates
@@ -96,6 +86,18 @@ This release includes breaking changes resulting from:
   * Change `Transfer.source_type` to be optional and not nullable
 * [#1471](https://github.com/stripe/stripe-node/pull/1471) Update readme to include a note on beta packages
 
+## 9.13.0-beta.1 - 2022-07-07
+* [#1469](https://github.com/stripe/stripe-node/pull/1469) API Updates for beta branch
+  - Include `server_side_confirmation_beta=v1` beta
+  - Add `secretKeyConfirmation` to `PaymentIntent`
+* [#1451](https://github.com/stripe/stripe-node/pull/1451) API Updates
+  - Updated stable APIs to the latest version
+* [#1457](https://github.com/stripe/stripe-node/pull/1457) Use the generated API version
+* [#1445](https://github.com/stripe/stripe-node/pull/1445) Support updating pre-release versions
+* [#1442](https://github.com/stripe/stripe-node/pull/1442) API Updates
+  * Add support for `network_details` method on resource `ReceivedCredits`/`ReceivedDebits`
+* [#1444](https://github.com/stripe/stripe-node/pull/1444) Merge master branch into beta branch
+
 ## 9.12.0 - 2022-07-07
 * [#1468](https://github.com/stripe/stripe-node/pull/1468) API Updates
   * Add support for `currency` on `CheckoutSessionCreateParams`, `InvoiceUpcomingLinesParams`, `InvoiceUpcomingParams`, `PaymentLinkCreateParams`, `SubscriptionCreateParams`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[]`, and `Subscription`
@@ -158,6 +160,10 @@ This release includes breaking changes resulting from:
   * Change type of `Order.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderCreateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderUpdateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]` from `literal('zengin')` to `enum`
   * Add support for `custom_unit_amount` on `PriceCreateParams` and `Price`
 
+## 9.8.0-beta.1 - 2022-06-08
+* [#1442](https://github.com/stripe/stripe-node/pull/1442) API Updates
+  * Add support for `network_details` method on resource `ReceivedCredits`/`ReceivedDebits`
+
 ## 9.7.0 - 2022-06-08
 * [#1441](https://github.com/stripe/stripe-node/pull/1441) API Updates
   * Add support for `affirm`, `bancontact`, `card`, `ideal`, `p24`, and `sofort` on `Checkout.Session.payment_method_options` and `CheckoutSessionCreateParams.payment_method_options`
@@ -178,7 +184,6 @@ This release includes breaking changes resulting from:
   * Add support for `network` on `SetupIntent.payment_method_options.card`
   * Add support for new value `simulated_wisepos_e` on enums `Terminal.Reader.device_type` and `TerminalReaderListParams.device_type`
 
-
 ## 9.5.0 - 2022-05-26
 * [#1434](https://github.com/stripe/stripe-node/pull/1434) API Updates
   * Add support for `affirm_payments` and `link_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
@@ -249,7 +254,6 @@ Major version release - The [migration guide](https://github.com/stripe/stripe-n
   * Add support for `default_price` on `ProductUpdateParams` and `Product`
   * Add support for `instructions_email` on `RefundCreateParams` and `Refund`
 
-
 ## 8.221.0 - 2022-05-05
 * [#1413](https://github.com/stripe/stripe-node/pull/1413) API Updates
   * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
@@ -526,7 +530,6 @@ Major version release - The [migration guide](https://github.com/stripe/stripe-n
 * [#1297](https://github.com/stripe/stripe-node/pull/1297) API Updates
   * Add support for `automatic_payment_methods` on `PaymentIntentCreateParams` and `PaymentIntent`
 
-
 ## 8.189.0 - 2021-11-16
 * [#1295](https://github.com/stripe/stripe-node/pull/1295) API Updates
   * Add support for new resource `ShippingRate`
@@ -549,7 +552,6 @@ Major version release - The [migration guide](https://github.com/stripe/stripe-n
   * Remove support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account`. This API was unused.
   * Add support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account.company`
 
-
 ## 8.186.0 - 2021-11-01
 * [#1283](https://github.com/stripe/stripe-node/pull/1283) API Updates
   * Add support for `ownership_declaration` on `AccountUpdateParams.company`, `AccountCreateParams.company`, `Account.company`, and `TokenCreateParams.account.company`
@@ -693,7 +695,6 @@ Major version release - The [migration guide](https://github.com/stripe/stripe-n
   * Add support for `wallet` on `Issuing.Transaction`
   * Add support for `ideal` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
 
-
 ## 8.163.0 - 2021-07-15
 * [#1102](https://github.com/stripe/stripe-node/pull/1102), [#1191](https://github.com/stripe/stripe-node/pull/1191) Add support for `stripeAccount` when initializing the client
 
@@ -2226,7 +2227,7 @@ Pull requests included in this release (cf. [#606](https://github.com/stripe/str
 
 - [BUGFIX] Fix incorrect deleteDiscount method & related spec(s)
 
-### 2.2.1 - 2013-12-01
+## 2.2.1 - 2013-12-01
 
 - [BUGFIX] Fix user-agent header issue (see issue #75)
 
@@ -2289,3 +2290,4 @@ Pull requests included in this release (cf. [#606](https://github.com/stripe/str
 ## 0.0.2 - 2011-09-28
 
 - Initial release with customers and tokens APIs
+

package/VERSION

@@ -1 +1 @@
-10.2.0
+10.3.0-beta.1

package/lib/apiVersion.js

@@ -1,3 +1,6 @@
 // File generated from our OpenAPI spec
 
-module.exports = {ApiVersion: '2022-08-01'};
+module.exports = {
+  ApiVersion:
+    '2022-08-01; server_side_confirmation_beta=v1; orders_beta=v4; terminal_interac_refunds_beta=v1',
+};

package/lib/resources/QuotePhases.js

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'quote_phases',
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{quotePhase}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  listLineItems: stripeMethod({
+    method: 'GET',
+    path: '/{quotePhase}/line_items',
+    methodType: 'list',
+  }),
+});

package/lib/resources/SubscriptionSchedules.js

@@ -29,6 +29,11 @@ module.exports = StripeResource.extend({
     methodType: 'list',
   }),
 
+  amend: stripeMethod({
+    method: 'POST',
+    path: '/{schedule}/amend',
+  }),
+
   cancel: stripeMethod({
     method: 'POST',
     path: '/{schedule}/cancel',

package/lib/resources/Terminal/Readers.js

@@ -49,6 +49,11 @@ module.exports = StripeResource.extend({
     path: '/{reader}/process_setup_intent',
   }),
 
+  refundPayment: stripeMethod({
+    method: 'POST',
+    path: '/{reader}/refund_payment',
+  }),
+
   setReaderDisplay: stripeMethod({
     method: 'POST',
     path: '/{reader}/set_reader_display',

package/lib/resources.js

@@ -38,6 +38,7 @@ module.exports = {
   Products: require('./resources/Products'),
   PromotionCodes: require('./resources/PromotionCodes'),
   Quotes: require('./resources/Quotes'),
+  QuotePhases: require('./resources/QuotePhases'),
   Refunds: require('./resources/Refunds'),
   Reviews: require('./resources/Reviews'),
   SetupAttempts: require('./resources/SetupAttempts'),

package/lib/stripe.js

@@ -1,11 +1,12 @@
 'use strict';
 
 const resources = require('./resources');
+const apiVersion = require('./apiVersion');
 
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
-const DEFAULT_API_VERSION = null;
+const DEFAULT_API_VERSION = apiVersion.ApiVersion;
 
 const DEFAULT_TIMEOUT = 80000;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "10.2.0",
+  "version": "10.3.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/2022-08-01/Discounts.d.ts

@@ -64,6 +64,11 @@ declare module 'stripe' {
        * The subscription that this coupon is applied to, if it is applied to a particular subscription.
        */
       subscription: string | null;
+
+      /**
+       * The subscription item that this coupon is applied to, if it is applied to a particular subscription item.
+       */
+      subscription_item?: string | null;
     }
 
     /**
@@ -126,6 +131,11 @@ declare module 'stripe' {
        * The subscription that this coupon is applied to, if it is applied to a particular subscription.
        */
       subscription: string | null;
+
+      /**
+       * The subscription item that this coupon is applied to, if it is applied to a particular subscription item.
+       */
+      subscription_item?: string | null;
     }
   }
 }

package/types/2022-08-01/Invoices.d.ts

@@ -1912,6 +1912,11 @@ declare module 'stripe' {
         InvoiceListUpcomingLinesParams.SubscriptionItem
       >;
 
+      /**
+       * The pre-billing to apply to the subscription as a preview.
+       */
+      subscription_prebilling?: InvoiceListUpcomingLinesParams.SubscriptionPrebilling;
+
       /**
        * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes.
        */
@@ -2224,6 +2229,11 @@ declare module 'stripe' {
          */
         deleted?: boolean;
 
+        /**
+         * The coupons to redeem into discounts for the subscription item.
+         */
+        discounts?: Stripe.Emptyable<Array<SubscriptionItem.Discount>>;
+
         /**
          * Subscription item to update.
          */
@@ -2268,6 +2278,18 @@ declare module 'stripe' {
           usage_gte: number;
         }
 
+        interface Discount {
+          /**
+           * ID of the coupon to create a new discount for.
+           */
+          coupon?: string;
+
+          /**
+           * ID of an existing discount on the object (or one of its ancestors) to reuse.
+           */
+          discount?: string;
+        }
+
         interface PriceData {
           /**
            * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
@@ -2321,6 +2343,13 @@ declare module 'stripe' {
         }
       }
 
+      interface SubscriptionPrebilling {
+        /**
+         * This is used to determine the number of billing cycles to prebill.
+         */
+        iterations: number;
+      }
+
       type SubscriptionProrationBehavior =
         | 'always_invoice'
         | 'create_prorations'
@@ -2460,6 +2489,11 @@ declare module 'stripe' {
         InvoiceRetrieveUpcomingParams.SubscriptionItem
       >;
 
+      /**
+       * The pre-billing to apply to the subscription as a preview.
+       */
+      subscription_prebilling?: InvoiceRetrieveUpcomingParams.SubscriptionPrebilling;
+
       /**
        * Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes.
        */
@@ -2772,6 +2806,11 @@ declare module 'stripe' {
          */
         deleted?: boolean;
 
+        /**
+         * The coupons to redeem into discounts for the subscription item.
+         */
+        discounts?: Stripe.Emptyable<Array<SubscriptionItem.Discount>>;
+
         /**
          * Subscription item to update.
          */
@@ -2816,6 +2855,18 @@ declare module 'stripe' {
           usage_gte: number;
         }
 
+        interface Discount {
+          /**
+           * ID of the coupon to create a new discount for.
+           */
+          coupon?: string;
+
+          /**
+           * ID of an existing discount on the object (or one of its ancestors) to reuse.
+           */
+          discount?: string;
+        }
+
         interface PriceData {
           /**
            * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
@@ -2869,6 +2920,13 @@ declare module 'stripe' {
         }
       }
 
+      interface SubscriptionPrebilling {
+        /**
+         * This is used to determine the number of billing cycles to prebill.
+         */
+        iterations: number;
+      }
+
       type SubscriptionProrationBehavior =
         | 'always_invoice'
         | 'create_prorations'

package/types/2022-08-01/PaymentIntents.d.ts

@@ -163,6 +163,11 @@ declare module 'stripe' {
        */
       review: string | Stripe.Review | null;
 
+      /**
+       * Indicates whether confirmation for this PaymentIntent using a secret key is `required` or `optional`.
+       */
+      secret_key_confirmation?: PaymentIntent.SecretKeyConfirmation;
+
       /**
        * Indicates that you intend to make future payments with this PaymentIntent's payment method.
        *
@@ -1685,6 +1690,8 @@ declare module 'stripe' {
         }
       }
 
+      type SecretKeyConfirmation = 'optional' | 'required';
+
       type SetupFutureUsage = 'off_session' | 'on_session';
 
       interface Shipping {
@@ -1856,6 +1863,11 @@ declare module 'stripe' {
        */
       return_url?: string;
 
+      /**
+       * Indicates whether confirmation for this PaymentIntent using a secret key is `required` or `optional`.
+       */
+      secret_key_confirmation?: PaymentIntentCreateParams.SecretKeyConfirmation;
+
       /**
        * Indicates that you intend to make future payments with this PaymentIntent's payment method.
        *
@@ -3495,6 +3507,8 @@ declare module 'stripe' {
         session?: string;
       }
 
+      type SecretKeyConfirmation = 'optional' | 'required';
+
       type SetupFutureUsage = 'off_session' | 'on_session';
 
       interface Shipping {
@@ -3598,6 +3612,11 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
+      /**
+       * This hash contains details about the Mandate to create.
+       */
+      mandate_data?: PaymentIntentUpdateParams.MandateData;
+
       /**
        * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
@@ -3672,6 +3691,41 @@ declare module 'stripe' {
     namespace PaymentIntentUpdateParams {
       type CaptureMethod = 'automatic' | 'manual';
 
+      interface MandateData {
+        /**
+         * This hash contains details about the customer acceptance of the Mandate.
+         */
+        customer_acceptance: MandateData.CustomerAcceptance;
+      }
+
+      namespace MandateData {
+        interface CustomerAcceptance {
+          /**
+           * If this is a Mandate accepted online, this hash contains details about the online acceptance.
+           */
+          online: CustomerAcceptance.Online;
+
+          /**
+           * The type of customer acceptance information included with the Mandate.
+           */
+          type: 'online';
+        }
+
+        namespace CustomerAcceptance {
+          interface Online {
+            /**
+             * The IP address from which the Mandate was accepted by the customer.
+             */
+            ip_address?: string;
+
+            /**
+             * The user agent of the browser from which the Mandate was accepted by the customer.
+             */
+            user_agent?: string;
+          }
+        }
+      }
+
       interface PaymentMethodData {
         /**
          * If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
@@ -5340,6 +5394,11 @@ declare module 'stripe' {
     }
 
     interface PaymentIntentConfirmParams {
+      /**
+       * The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total payment amount. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+       */
+      application_fee_amount?: Stripe.Emptyable<number>;
+
       /**
        * Controls when the funds will be captured from the customer's account.
        */

package/types/2022-08-01/Prices.d.ts

@@ -65,6 +65,11 @@ declare module 'stripe' {
        */
       metadata: Stripe.Metadata;
 
+      /**
+       * Subscriptions using this price will be migrated to use the new referenced price.
+       */
+      migrate_to?: Price.MigrateTo | null;
+
       /**
        * A brief description of the price, hidden from customers.
        */
@@ -211,6 +216,23 @@ declare module 'stripe' {
         preset: number | null;
       }
 
+      interface MigrateTo {
+        /**
+         * The behavior controlling at what point in the subscription lifecycle to migrate the price
+         */
+        behavior: 'at_cycle_end';
+
+        /**
+         * The unix timestamp after at which subscriptions will start to migrate to the new price.
+         */
+        effective_after: number;
+
+        /**
+         * The id of the price being migrated to
+         */
+        price: string;
+      }
+
       interface Recurring {
         /**
          * Specifies a usage aggregation strategy for prices of `usage_type=metered`. Allowed values are `sum` for summing up all usage during a period, `last_during_period` for using the last usage record reported within a period, `last_ever` for using the last usage record ever (across period bounds) or `max` which uses the usage record with the maximum reported usage during a period. Defaults to `sum`.
@@ -685,6 +707,11 @@ declare module 'stripe' {
        */
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
+      /**
+       * If specified, subscriptions using this price will be updated to use the new referenced price.
+       */
+      migrate_to?: Stripe.Emptyable<PriceUpdateParams.MigrateTo>;
+
       /**
        * A brief description of the price, hidden from customers.
        */
@@ -787,6 +814,23 @@ declare module 'stripe' {
         }
       }
 
+      interface MigrateTo {
+        /**
+         * The behavior controlling the point in the subscription lifecycle after which to migrate the price. Currently must be `at_cycle_end`.
+         */
+        behavior: 'at_cycle_end';
+
+        /**
+         * The time after which subscriptions should start using the new price.
+         */
+        effective_after?: number;
+
+        /**
+         * The ID of the price object.
+         */
+        price: string;
+      }
+
       interface Recurring {
         /**
          * Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan).