Merge upstream and update generated code for v1572

Author: stripe-openapi[bot]

CHANGELOG.md

@@ -9,17 +9,6 @@
   * Add support for `target_date` on `Order.payment.settings.payment_method_options.acss_debit`, `Order.payment.settings.payment_method_options.sepa_debit`, `OrderCreateParams.payment.settings.payment_method_options.acss_debit`, `OrderCreateParams.payment.settings.payment_method_options.sepa_debit`, `OrderUpdateParams.payment.settings.payment_method_options.acss_debit`, and `OrderUpdateParams.payment.settings.payment_method_options.sepa_debit`
 * [#2272](https://github.com/stripe/stripe-node/pull/2272) Merge master
 
-## 17.7.0-beta.1 - 2025-02-07
-* [#2254](https://github.com/stripe/stripe-node/pull/2254) Update generated code for beta
-  * Add support for `rejected_reason` on `Account.risk_controls`
-  * Add support for `product_tax_code_selector` on `AccountSessionCreateParams.components`
-  * Add support for `prices` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
-  * Change `Billing.CreditGrant.applicability_config.scope.price_type`, `Checkout.Session.collected_information.business_name`, `Checkout.Session.collected_information.email`, `Checkout.Session.collected_information.phone`, `Checkout.Session.collected_information.shipping_details`, and `Checkout.Session.collected_information.tax_ids` to be optional
-  * Add support for `brand_product` on `Charge.payment_method_details.amazon_pay.funding.card` and `Charge.payment_method_details.revolut_pay.funding.card`
-  * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `Checkout.SessionCreateParams.payment_method_options.card`
-  * Change `Checkout.Session.discounts` to be required
-  * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
-
 ## 17.7.0 - 2025-02-24
 * [#2256](https://github.com/stripe/stripe-node/pull/2256) Update generated code
   * Add support for `prices` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
@@ -35,6 +24,17 @@
 * [#2259](https://github.com/stripe/stripe-node/pull/2259) Add Next.js App Router webhook example that leverages Route Handlers
 * [#2257](https://github.com/stripe/stripe-node/pull/2257) Include `OPENAPI_VERSION` into npm bundle
 
+## 17.7.0-beta.1 - 2025-02-07
+* [#2254](https://github.com/stripe/stripe-node/pull/2254) Update generated code for beta
+  * Add support for `rejected_reason` on `Account.risk_controls`
+  * Add support for `product_tax_code_selector` on `AccountSessionCreateParams.components`
+  * Add support for `prices` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
+  * Change `Billing.CreditGrant.applicability_config.scope.price_type`, `Checkout.Session.collected_information.business_name`, `Checkout.Session.collected_information.email`, `Checkout.Session.collected_information.phone`, `Checkout.Session.collected_information.shipping_details`, and `Checkout.Session.collected_information.tax_ids` to be optional
+  * Add support for `brand_product` on `Charge.payment_method_details.amazon_pay.funding.card` and `Charge.payment_method_details.revolut_pay.funding.card`
+  * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `Checkout.SessionCreateParams.payment_method_options.card`
+  * Change `Checkout.Session.discounts` to be required
+  * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
+
 ## 17.6.0 - 2025-01-27
 * [#2250](https://github.com/stripe/stripe-node/pull/2250) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`

OPENAPI_VERSION

@@ -1 +1 @@
-v1505
+v1572

src/apiVersion.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec
 
-export const ApiVersion = '2025-02-24.acacia';
+export const ApiVersion = '2025-03-31.basil';

src/resources/Invoices.ts

@@ -42,11 +42,6 @@ export const Invoices = StripeResource.extend({
     fullPath: '/v1/invoices/{invoice}/payments',
     methodType: 'list',
   }),
-  listUpcomingLines: stripeMethod({
-    method: 'GET',
-    fullPath: '/v1/invoices/upcoming/lines',
-    methodType: 'list',
-  }),
   markUncollectible: stripeMethod({
     method: 'POST',
     fullPath: '/v1/invoices/{invoice}/mark_uncollectible',
@@ -60,10 +55,6 @@ export const Invoices = StripeResource.extend({
     method: 'GET',
     fullPath: '/v1/invoices/{invoice}/payments/{invoice_payment}',
   }),
-  retrieveUpcoming: stripeMethod({
-    method: 'GET',
-    fullPath: '/v1/invoices/upcoming',
-  }),
   search: stripeMethod({
     method: 'GET',
     fullPath: '/v1/invoices/search',

test/resources/generated_examples_test.spec.js

@@ -269,6 +269,11 @@ declare module 'stripe' {
          */
         bank_transfer_payments?: Capabilities.BankTransferPayments;
 
+        /**
+         * The status of the Billie capability of the account, or whether the account can directly process Billie payments.
+         */
+        billie_payments?: Capabilities.BilliePayments;
+
         /**
          * The status of the blik payments capability of the account, or whether the account can directly process blik charges.
          */
@@ -474,6 +479,11 @@ declare module 'stripe' {
          */
         samsung_pay_payments?: Capabilities.SamsungPayPayments;
 
+        /**
+         * The status of the Satispay capability of the account, or whether the account can directly process Satispay payments.
+         */
+        satispay_payments?: Capabilities.SatispayPayments;
+
         /**
          * The status of the SEPA customer_balance payments (EUR currency) capability of the account, or whether the account can directly process SEPA customer_balance charges.
          */
@@ -576,6 +586,8 @@ declare module 'stripe' {
 
         type BankTransferPayments = 'active' | 'inactive' | 'pending';
 
+        type BilliePayments = 'active' | 'inactive' | 'pending';
+
         type BlikPayments = 'active' | 'inactive' | 'pending';
 
         type BoletoPayments = 'active' | 'inactive' | 'pending';
@@ -658,6 +670,8 @@ declare module 'stripe' {
 
         type SamsungPayPayments = 'active' | 'inactive' | 'pending';
 
+        type SatispayPayments = 'active' | 'inactive' | 'pending';
+
         type SepaBankTransferPayments = 'active' | 'inactive' | 'pending';
 
         type SepaDebitPayments = 'active' | 'inactive' | 'pending';
@@ -754,6 +768,9 @@ declare module 'stripe' {
          */
         ownership_declaration?: Company.OwnershipDeclaration | null;
 
+        /**
+         * This value is used to determine if a business is exempt from providing ultimate beneficial owners. See [this support article](https://support.stripe.com/questions/exemption-from-providing-ownership-details) and [changelog](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api) for more details.
+         */
         ownership_exemption_reason?: Company.OwnershipExemptionReason;
 
         /**
@@ -1629,6 +1646,15 @@ declare module 'stripe' {
            * The list of default Account Tax IDs to automatically include on invoices. Account Tax IDs get added when an invoice is finalized.
            */
           default_account_tax_ids: Array<string | Stripe.TaxId> | null;
+
+          /**
+           * Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+           */
+          hosted_payment_method_save?: Invoices.HostedPaymentMethodSave | null;
+        }
+
+        namespace Invoices {
+          type HostedPaymentMethodSave = 'always' | 'never' | 'offer';
         }
 
         interface Payments {

types/Accounts.d.ts

@@ -254,6 +254,11 @@ declare module 'stripe' {
          */
         bank_transfer_payments?: Capabilities.BankTransferPayments;
 
+        /**
+         * The billie_payments capability.
+         */
+        billie_payments?: Capabilities.BilliePayments;
+
         /**
          * The blik_payments capability.
          */
@@ -459,6 +464,11 @@ declare module 'stripe' {
          */
         samsung_pay_payments?: Capabilities.SamsungPayPayments;
 
+        /**
+         * The satispay_payments capability.
+         */
+        satispay_payments?: Capabilities.SatispayPayments;
+
         /**
          * The sepa_bank_transfer_payments capability.
          */
@@ -611,6 +621,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface BilliePayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface BlikPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -898,6 +915,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface SatispayPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface SepaBankTransferPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1077,6 +1101,9 @@ declare module 'stripe' {
          */
         ownership_declaration?: Company.OwnershipDeclaration;
 
+        /**
+         * This value is used to determine if a business is exempt from providing ultimate beneficial owners. See [this support article](https://support.stripe.com/questions/exemption-from-providing-ownership-details) and [changelog](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api) for more details.
+         */
         ownership_exemption_reason?: Stripe.Emptyable<
           Company.OwnershipExemptionReason
         >;
@@ -1708,6 +1735,11 @@ declare module 'stripe' {
          */
         card_payments?: Settings.CardPayments;
 
+        /**
+         * Settings specific to the account's use of Invoices.
+         */
+        invoices?: Settings.Invoices;
+
         /**
          * Settings that apply across payment methods for charging on the account.
          */
@@ -1849,6 +1881,17 @@ declare module 'stripe' {
           }
         }
 
+        interface Invoices {
+          /**
+           * Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+           */
+          hosted_payment_method_save?: Invoices.HostedPaymentMethodSave;
+        }
+
+        namespace Invoices {
+          type HostedPaymentMethodSave = 'always' | 'never' | 'offer';
+        }
+
         interface Payments {
           /**
            * The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
@@ -2266,6 +2309,11 @@ declare module 'stripe' {
          */
         bank_transfer_payments?: Capabilities.BankTransferPayments;
 
+        /**
+         * The billie_payments capability.
+         */
+        billie_payments?: Capabilities.BilliePayments;
+
         /**
          * The blik_payments capability.
          */
@@ -2471,6 +2519,11 @@ declare module 'stripe' {
          */
         samsung_pay_payments?: Capabilities.SamsungPayPayments;
 
+        /**
+         * The satispay_payments capability.
+         */
+        satispay_payments?: Capabilities.SatispayPayments;
+
         /**
          * The sepa_bank_transfer_payments capability.
          */
@@ -2623,6 +2676,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface BilliePayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface BlikPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -2910,6 +2970,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface SatispayPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface SepaBankTransferPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -3132,6 +3199,9 @@ declare module 'stripe' {
          */
         ownership_declaration?: Company.OwnershipDeclaration;
 
+        /**
+         * This value is used to determine if a business is exempt from providing ultimate beneficial owners. See [this support article](https://support.stripe.com/questions/exemption-from-providing-ownership-details) and [changelog](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api) for more details.
+         */
         ownership_exemption_reason?: Stripe.Emptyable<
           Company.OwnershipExemptionReason
         >;
@@ -3780,6 +3850,15 @@ declare module 'stripe' {
            * The list of default Account Tax IDs to automatically include on invoices. Account Tax IDs get added when an invoice is finalized.
            */
           default_account_tax_ids?: Stripe.Emptyable<Array<string>>;
+
+          /**
+           * Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+           */
+          hosted_payment_method_save?: Invoices.HostedPaymentMethodSave;
+        }
+
+        namespace Invoices {
+          type HostedPaymentMethodSave = 'always' | 'never' | 'offer';
         }
 
         interface Payments {
@@ -3926,7 +4005,7 @@ declare module 'stripe' {
 
     interface AccountCreateExternalAccountParams {
       /**
-       * Please refer to full [documentation](https://stripe.com/docs/api) instead.
+       * A token, like the ones returned by [Stripe.js](https://stripe.com/docs/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead.
        */
       external_account:
         | string

types/AccountsResource.d.ts

@@ -95,7 +95,7 @@ declare module 'stripe' {
         payout?: string;
 
         /**
-         * Type of object that created the application fee, either `charge` or `payout`.
+         * Type of object that created the application fee.
          */
         type: FeeSource.Type;
       }

types/ApplicationFees.d.ts

@@ -23,7 +23,7 @@ declare module 'stripe' {
       object: 'bank_account';
 
       /**
-       * The ID of the account that the bank account is associated with.
+       * The account this bank account belongs to. Only applicable on Accounts (not customers or recipients) This property is only available when returned as an [External Account](https://stripe.com/api/external_account_bank_accounts/object) where [controller.is_controller](https://stripe.com/api/accounts/object#account_object-controller-is_controller) is `true`.
        */
       account?: string | Stripe.Account | null;
 

types/BankAccounts.d.ts

@@ -41,12 +41,12 @@ declare module 'stripe' {
         namespace Filter {
           interface ApplicabilityScope {
             /**
-             * The price type that credit grants can apply to. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
              */
             price_type?: 'metered';
 
             /**
-             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
              */
             prices?: Array<ApplicabilityScope.Price>;
           }

types/Billing/CreditBalanceSummaryResource.d.ts

@@ -118,12 +118,12 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them. Cannot be used in combination with `prices`.
              */
             price_type?: 'metered';
 
             /**
-             * The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+             * The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them. Cannot be used in combination with `price_type`.
              */
             prices?: Array<Scope.Price>;
           }

types/Billing/CreditGrants.d.ts

@@ -92,12 +92,12 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * The price type that credit grants can apply to. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
              */
             price_type?: 'metered';
 
             /**
-             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
              */
             prices?: Array<Scope.Price>;
           }