stripe 17.7.0 → 18.0.0

package/CHANGELOG.md

@@ -1,4 +1,143 @@
 # Changelog
+## 18.0.0 - 2025-04-01
+* [#2279](https://github.com/stripe/stripe-node/pull/2279) Support for APIs in the new API version 2025-03-31.basil
+
+  This release changes the pinned API version to `2025-03-31.basil`.
+
+  ### ⚠️ Breaking changes due to changes in the Stripe API
+
+  Please review details for the breaking changes and alternatives in the [Stripe API changelog](https://docs.stripe.com/changelog/acacia) before upgrading.
+
+  * Remove support for resources `SubscriptionItemUsageRecordSummary` and `SubscriptionItemUsageRecord`
+  * Remove support for `listUpcomingLines` and `retrieveUpcoming` methods on resource `Invoice`
+  * Remove support for `createUsageRecord` and `listUsageRecordSummaries` methods on resource `SubscriptionItems`
+  * Remove support for `invoice` on `Charge` and `PaymentIntent`
+  * Remove support for `shipping_details` on `Checkout.Session`
+  * Remove support for `carrier`, `phone`, and `tracking_number` on `Checkout.Session.collected_information.shipping_details`. Make `name` and `address` required instead of optional.
+  * Remove support for `refund` on `CreditNoteCreateParams`, `CreditNoteListPreviewLineItemsParams`, `CreditNotePreviewParams`, and `CreditNote`
+  * Remove support for `tax_amounts` on `CreditNoteLineItem`, `CreditNote`, and `InvoiceLineItem`
+  * Remove support for `amount_excluding_tax` and `unit_amount_excluding_tax` on `CreditNoteLineItem` and `InvoiceLineItem`
+  * Remove support for `coupon` on `CustomerCreateParams`, `CustomerUpdateParams`, `InvoiceCreatePreviewParams.schedule_details.phases[]`, `InvoiceCreatePreviewParams`, `SubscriptionCreateParams`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[]`, and `SubscriptionUpdateParams`
+  * Remove support for `promotion_code` on `CustomerCreateParams`, `CustomerUpdateParams`, `SubscriptionCreateParams`, and `SubscriptionUpdateParams`
+  * Remove support for `price` on `InvoiceAddLinesParams.lines[]`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams.lines[]. Use `pricing` instead.
+  * Remove support for `billing_thresholds` on `InvoiceCreatePreviewParams.schedule_details.phases[].items[]`, `InvoiceCreatePreviewParams.schedule_details.phases[]`, `InvoiceCreatePreviewParams.subscription_details.items[]`, `SubscriptionCreateParams.items[]`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionItem`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[].items[]`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, `SubscriptionScheduleUpdateParams.phases[].items[]`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams.items[]`, `SubscriptionUpdateParams`, and `Subscription`
+  * Remove support for `application_fee_amount`, `charge`, `paid_out_of_band`, `paid`, `payment_intent`, `quote`, `subscription`, `subscription_details`, `subscription_proration_date`, `tax`, `total_tax_amounts`, and `transfer_data` on `Invoice`
+  * Remove support for `discount` on `Invoice` and `Subscription`
+  * Remove support for `invoice_item`, `proration_details`, `proration`, `tax_rates`, and `type` on `InvoiceLineItem`
+  * Remove support for `plan` and `subscription_item` on `InvoiceItem` and `InvoiceLineItem`
+  * Remove support for `unit_amount` on `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, and `InvoiceItem`
+  * Remove support for `subscription` and `unit_amount_decimal` on `InvoiceItem`
+  * Remove support for `naver_pay` on `PaymentMethodUpdateParams`
+  * Remove support for `aggregate_usage` on `PlanCreateParams`, `Plan`, `Price.recurring`, and `PriceCreateParams.recurring`
+  * Remove support for `current_period_end` and `current_period_start` on `Subscription`
+  * `page` has been removed from all V2 list method params (e.g. `EventService.list()`); use the [auto paginator](https://github.com/stripe/stripe-node?tab=readme-ov-file#auto-pagination) or the `next_page_url` and `previous_page_url` fields instead ([more info](https://docs.stripe.com/api-v2-overview#list-pagination))
+
+  ### Changes
+
+  * Change `Checkout.Session.collected_information` to be required
+  * Change `Checkout.Session.collected_information.shipping_details` to be required
+  * Change `Checkout.Session.collected_information.shipping_details.address` to be required
+  * Change `Checkout.Session.collected_information.shipping_details.name` to be required
+  * Change `PaymentIntentConfirmParams.payment_method_options.wechat_pay.client`, `PaymentIntentCreateParams.payment_method_options.wechat_pay.client`, and `PaymentIntentUpdateParams.payment_method_options.wechat_pay.client` to be optional
+  * Change `political_exposure` on resources `Person` and `Token` and params `Token.CreateParams` from string to enum("existing" | "none")
+
+  ### Additions
+
+  * Add support for new resource `InvoicePayment`
+  * Add support for `list` and `retrieve` methods on resource `InvoicePayment`
+  * Add support for `billie_payments`, `nz_bank_account_becs_debit_payments`, and `satispay_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+  * Add support for `hosted_payment_method_save` on `Account.settings.invoices` and `AccountUpdateParams.settings.invoices`
+  * Add support for `invoices` on `AccountCreateParams.settings`
+  * Add support for new values `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, and `verification_rejected_ownership_exemption_reason` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `AccountCapability.future_requirements.errors[].code`, `AccountCapability.requirements.errors[].code`, `AccountPerson.future_requirements.errors[].code`, `AccountPerson.requirements.errors[].code`, `BankAccount.future_requirements.errors[].code`, and `BankAccount.requirements.errors[].code`
+  * Add support for new values `forwarding_api_retryable_upstream_error` and `setup_intent_mobile_wallet_unsupported` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Add support for new values `stripe_balance_payment_debit_reversal` and `stripe_balance_payment_debit` on enum `BalanceTransaction.type`
+  * Add support for new value `last` on enums `Billing.Meter.default_aggregation.formula` and `Billing.MeterCreateParams.default_aggregation.formula`
+  * Add support for `presentment_details` on `Charge`, `Checkout.Session`, `PaymentIntent`, and `Refund`
+  * Add support for `billie` and `satispay` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.testHelpers.payment_method_data`, `CustomerPaymentMethod`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+  * Add support for `nz_bank_account` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.testHelpers.payment_method_data`, `CustomerPaymentMethod`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+  * Add support for `optional_items` on `Checkout.SessionCreateParams`, `Checkout.Session`, `PaymentLinkCreateParams`, and `PaymentLink`
+  * Add support for `permissions` on `Checkout.SessionCreateParams` and `Checkout.Session`
+  * Add support for new values `billie` and `satispay` on enum `Checkout.SessionCreateParams.payment_method_types`
+  * Add support for new value `custom` on enums `Checkout.Session.ui_mode` and `Checkout.SessionCreateParams.ui_mode`
+  * Add support for `shipping_options` on `Checkout.SessionUpdateParams`
+  * Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `ConfirmationTokenCreateParams.testHelpers.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+  * Add support for `buyer_id` on `ConfirmationToken.payment_method_preview.naver_pay`, `CustomerPaymentMethod.naver_pay`, and `PaymentMethod.naver_pay`
+  * Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `ConfirmationToken.payment_method_preview.type`, `CustomerPaymentMethod.type`, and `PaymentMethod.type`
+  * Add support for `refunds` on `CreditNoteCreateParams`, `CreditNoteListPreviewLineItemsParams`, `CreditNotePreviewParams`, and `CreditNote`
+  * Add support for `total_taxes` on `CreditNote` and `Invoice`
+  * Add support for `taxes` on `CreditNoteLineItem` and `InvoiceLineItem`
+  * Add support for `checkout_session` on `CustomerBalanceTransaction`
+  * Add support for new values `checkout_session_subscription_payment_canceled` and `checkout_session_subscription_payment` on enum `CustomerBalanceTransaction.type`
+  * Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `CustomerPaymentMethodListParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+  * Add support for new value `invoice.overpaid` on enum `Event.type`
+  * Add support for new values `klarna` and `nz_bank_account` 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 `pricing` on `InvoiceAddLinesParams.lines[]`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams.lines[]`
+  * Add support for `taxability_reason` on `InvoiceAddLinesParams.lines[].tax_amounts[]`, `InvoiceLineItemUpdateParams.tax_amounts[]`, and `InvoiceUpdateLinesParams.lines[].tax_amounts[]`
+  * Add support for `jurisdiction_level` on `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data`, `InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data`, and `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data`
+  * Add support for `amount_overpaid`, `confirmation_secret`, and `payments` on `Invoice`
+  * Add support for `parent` on `InvoiceItem`, `InvoiceLineItem`, and `Invoice`
+  * Add support for new value `expired` on enums `Issuing.Authorization.status` and `Issuing.AuthorizationListParams.status`
+  * Add support for new value `network_fallback` on enum `Issuing.Authorization.request_history[].reason`
+  * Add support for `naver_pay` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
+  * Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.naver_pay`, `PaymentIntentConfirmParams.payment_method_options.naver_pay`, `PaymentIntentCreateParams.payment_method_options.naver_pay`, and `PaymentIntentUpdateParams.payment_method_options.naver_pay`
+  * Add support for new value `expired` on enum `PaymentIntent.cancellation_reason`
+  * Add support for `default_value` on `PaymentLink.custom_fields[].dropdown`, `PaymentLink.custom_fields[].numeric`, `PaymentLink.custom_fields[].text`, `PaymentLinkCreateParams.custom_fields[].dropdown`, `PaymentLinkCreateParams.custom_fields[].numeric`, `PaymentLinkCreateParams.custom_fields[].text`, `PaymentLinkUpdateParams.custom_fields[].dropdown`, `PaymentLinkUpdateParams.custom_fields[].numeric`, and `PaymentLinkUpdateParams.custom_fields[].text`
+  * Add support for new values `billie` and `satispay` on enums `PaymentLink.payment_method_types`, `PaymentLinkCreateParams.payment_method_types`, and `PaymentLinkUpdateParams.payment_method_types`
+  * Add support for `nz_bank_transfer` on `Refund.destination_details`
+  * Add support for new value `canceled` on enum `Review.closed_reason`
+  * Add support for `current_period_end` and `current_period_start` on `SubscriptionItem`
+  * Add support for `wifi` on `Terminal.ConfigurationCreateParams`, `Terminal.ConfigurationUpdateParams`, and `Terminal.Configuration`
+  * Add support for new value `invoice.overpaid` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointUpdateParams.enabled_events`
+  * Add support for new values `2025-03-01.dashboard` and `2025-03-31.basil` on enum `WebhookEndpointCreateParams.api_version`
+
+### ⚠️ Other Breaking changes in the SDK
+* [#2277](https://github.com/stripe/stripe-node/pull/2277) Swap Stripe.webhooks from a factory function to a static property
+  - `Stripe.webhooks` and `Stripe().webhooks` are no longer functions (just plain objects)
+      - if you were already treating those properties as plain objects (per the types), then you can ignore this change
+      - if you were calling `Stripe.webhooks().someMethod()`, you should use `Stripe.webhooks.someMethod()` instead
+      - there shouldn't be user-facing functionality changing, just a slight breaking change in our internal organization
+* [#2286](https://github.com/stripe/stripe-node/pull/2286) Remove types that were marked as deprecated in Feb 2024
+  * Remove `AccountDebitSource` in favor of `Account`
+  * Remove `CapabilityListParams` in favor of `AccountListCapabilitiesParams`
+  * Remove `CapabilityRetrieveParams` in favor of `AccountRetrieveCapabilityParams`
+  * Remove `CapabilityUpdateParams` in favor of `AccountUpdateCapabilityParams`
+  * Remove `CashBalanceRetrieveParams` in favor of `CustomerRetrieveCashBalanceParams`
+  * Remove `CashBalanceUpdateParams` in favor of `CustomerUpdateCashBalanceParams`
+  * Remove `CreditNoteLineItemListParams` in favor of `CreditNoteListLineItemsParams`
+  * Remove `CustomerBalanceTransactionCreateParams` in favor of `CustomerCreateBalanceTransactionParams`
+  * Remove `CustomerBalanceTransactionListParams` in favor of `CustomerListBalanceTransactionsParams`
+  * Remove `CustomerBalanceTransactionRetrieveParams` in favor of `CustomerRetrieveBalanceTransactionParams`
+  * Remove `CustomerBalanceTransactionUpdateParams` in favor of `CustomerUpdateBalanceTransactionParams`
+  * Remove `CustomerCashBalanceTransactionListParams` in favor of `CustomerListCashBalanceTransactionsParams`
+  * Remove `CustomerCashBalanceTransactionRetrieveParams` in favor of `CustomerRetrieveCashBalanceTransactionParams`
+  * Remove `CustomerSourceCreateParams` in favor of `CustomerCreateSourceParams`
+  * Remove `CustomerSourceDeleteParams` in favor of `CustomerDeleteSourceParams`
+  * Remove `CustomerSourceListParams` in favor of `CustomerListSourcesParams`
+  * Remove `CustomerSourceRetrieveParams` in favor of `CustomerRetrieveSourceParams`
+  * Remove `CustomerSourceUpdateParams` in favor of `CustomerUpdateSourceParams`
+  * Remove `CustomerSourceVerifyParams` in favor of `CustomerVerifySourceParams`
+  * Remove `ExternalAccountCreateParams` in favor of `AccountCreateExternalAccountParams`
+  * Remove `ExternalAccountDeleteParams` in favor of `AccountDeleteExternalAccountParams`
+  * Remove `ExternalAccountListParams` in favor of `AccountListExternalAccountsParams`
+  * Remove `ExternalAccountRetrieveParams` in favor of `AccountRetrieveExternalAccountParams`
+  * Remove `ExternalAccountUpdateParams` in favor of `AccountUpdateExternalAccountParams`
+  * Remove `FeeRefundCreateParams` in favor of `ApplicationFeeCreateRefundParams`
+  * Remove `FeeRefundListParams` in favor of `ApplicationFeeListRefundsParams`
+  * Remove `FeeRefundRetrieveParams` in favor of `ApplicationFeeRetrieveRefundParams`
+  * Remove `FeeRefundUpdateParams` in favor of `ApplicationFeeUpdateRefundParams`
+  * Remove `InvoiceLineItemListParams` in favor of `InvoiceListLineItemsParams`
+  * Remove `InvoiceLineItemUpdateParams` in favor of `InvoiceUpdateLineItemParams`
+  * Remove `LoginLinkCreateParams` in favor of `AccountCreateLoginLinkParams`
+  * Remove `PersonCreateParams` in favor of `AccountCreatePersonParams`
+  * Remove `PersonDeleteParams` in favor of `AccountDeletePersonParams`
+  * Remove `PersonListParams` in favor of `AccountListPersonsParams`
+  * Remove `PersonRetrieveParams` in favor of `AccountRetrievePersonParams`
+  * Remove `PersonUpdateParams` in favor of `AccountUpdatePersonParams`
+  * Remove `TransferReversalCreateParams` in favor of `TransferCreateReversalParams`
+  * Remove `TransferReversalListParams` in favor of `TransferListReversalsParams`
+  * Remove `TransferReversalRetrieveParams` in favor of `TransferRetrieveReversalParams`
+  * Remove `TransferReversalUpdateParams` in favor of `TransferUpdateReversalParams`
+
 ## 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`

package/OPENAPI_VERSION

@@ -1 +1 @@
-v1505
+v1642

package/VERSION

@@ -1 +1 @@
-17.7.0
+18.0.0

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-02-24.acacia';
+exports.ApiVersion = '2025-03-31.basil';

package/cjs/resources/InvoicePayments.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoicePayments = void 0;
+const StripeResource_js_1 = require("../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.InvoicePayments = StripeResource_js_1.StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/invoice_payments/{invoice_payment}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/invoice_payments',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/Invoices.js

@@ -31,11 +31,6 @@ exports.Invoices = StripeResource_js_1.StripeResource.extend({
         fullPath: '/v1/invoices/{invoice}/lines',
         methodType: 'list',
     }),
-    listUpcomingLines: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/invoices/upcoming/lines',
-        methodType: 'list',
-    }),
     markUncollectible: stripeMethod({
         method: 'POST',
         fullPath: '/v1/invoices/{invoice}/mark_uncollectible',
@@ -45,10 +40,6 @@ exports.Invoices = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/invoices/{invoice}/remove_lines',
     }),
-    retrieveUpcoming: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/invoices/upcoming',
-    }),
     search: stripeMethod({
         method: 'GET',
         fullPath: '/v1/invoices/search',

package/cjs/resources/SubscriptionItems.js

@@ -23,13 +23,4 @@ exports.SubscriptionItems = StripeResource_js_1.StripeResource.extend({
         method: 'DELETE',
         fullPath: '/v1/subscription_items/{item}',
     }),
-    createUsageRecord: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/subscription_items/{subscription_item}/usage_records',
-    }),
-    listUsageRecordSummaries: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/subscription_items/{subscription_item}/usage_record_summaries',
-        methodType: 'list',
-    }),
 });

package/cjs/resources.js

@@ -1,8 +1,8 @@
 "use strict";
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tokens = exports.TaxRates = exports.TaxIds = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = exports.SetupAttempts = exports.Reviews = exports.Refunds = exports.Quotes = exports.PromotionCodes = exports.Products = exports.Prices = exports.Plans = exports.Payouts = exports.PaymentMethods = exports.PaymentMethodDomains = exports.PaymentMethodConfigurations = exports.PaymentLinks = exports.PaymentIntents = exports.OAuth = exports.Mandates = exports.Invoices = exports.InvoiceRenderingTemplates = exports.InvoiceItems = exports.Files = exports.FileLinks = exports.ExchangeRates = exports.Events = exports.EphemeralKeys = exports.Disputes = exports.Customers = exports.CustomerSessions = exports.CreditNotes = exports.Coupons = exports.CountrySpecs = exports.ConfirmationTokens = exports.Charges = exports.BalanceTransactions = exports.Balance = exports.ApplicationFees = exports.ApplePayDomains = exports.Accounts = exports.AccountSessions = exports.AccountLinks = exports.Account = void 0;
-exports.V2 = exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = exports.Forwarding = exports.FinancialConnections = exports.Entitlements = exports.Climate = exports.Checkout = exports.BillingPortal = exports.Billing = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = void 0;
+exports.TaxRates = exports.TaxIds = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = exports.SetupAttempts = exports.Reviews = exports.Refunds = exports.Quotes = exports.PromotionCodes = exports.Products = exports.Prices = exports.Plans = exports.Payouts = exports.PaymentMethods = exports.PaymentMethodDomains = exports.PaymentMethodConfigurations = exports.PaymentLinks = exports.PaymentIntents = exports.OAuth = exports.Mandates = exports.Invoices = exports.InvoiceRenderingTemplates = exports.InvoicePayments = exports.InvoiceItems = exports.Files = exports.FileLinks = exports.ExchangeRates = exports.Events = exports.EphemeralKeys = exports.Disputes = exports.Customers = exports.CustomerSessions = exports.CreditNotes = exports.Coupons = exports.CountrySpecs = exports.ConfirmationTokens = exports.Charges = exports.BalanceTransactions = exports.Balance = exports.ApplicationFees = exports.ApplePayDomains = exports.Accounts = exports.AccountSessions = exports.AccountLinks = exports.Account = void 0;
+exports.V2 = exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = exports.Forwarding = exports.FinancialConnections = exports.Entitlements = exports.Climate = exports.Checkout = exports.BillingPortal = exports.Billing = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = exports.Tokens = void 0;
 const ResourceNamespace_js_1 = require("./ResourceNamespace.js");
 const Accounts_js_1 = require("./resources/FinancialConnections/Accounts.js");
 const ActiveEntitlements_js_1 = require("./resources/Entitlements/ActiveEntitlements.js");
@@ -122,6 +122,8 @@ var Files_js_1 = require("./resources/Files.js");
 Object.defineProperty(exports, "Files", { enumerable: true, get: function () { return Files_js_1.Files; } });
 var InvoiceItems_js_1 = require("./resources/InvoiceItems.js");
 Object.defineProperty(exports, "InvoiceItems", { enumerable: true, get: function () { return InvoiceItems_js_1.InvoiceItems; } });
+var InvoicePayments_js_1 = require("./resources/InvoicePayments.js");
+Object.defineProperty(exports, "InvoicePayments", { enumerable: true, get: function () { return InvoicePayments_js_1.InvoicePayments; } });
 var InvoiceRenderingTemplates_js_1 = require("./resources/InvoiceRenderingTemplates.js");
 Object.defineProperty(exports, "InvoiceRenderingTemplates", { enumerable: true, get: function () { return InvoiceRenderingTemplates_js_1.InvoiceRenderingTemplates; } });
 var Invoices_js_1 = require("./resources/Invoices.js");

package/cjs/stripe.core.js

@@ -36,23 +36,14 @@ 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 = '17.7.0';
+    Stripe.PACKAGE_VERSION = '18.0.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));
+    Stripe.webhooks = (0, Webhooks_js_1.createWebhooks)(platformFunctions);
     function Stripe(key, config = {}) {
         if (!(this instanceof Stripe)) {
             return new Stripe(key, config);
@@ -101,9 +92,7 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
         this._prepResources();
         this._setAuthenticator(key, props.authenticator);
         this.errors = _Error;
-        // Once Stripe.webhooks looses the factory function signature in a future release
-        // then this should become this.webhooks = Stripe.webhooks
-        this.webhooks = createWebhooksDefault();
+        this.webhooks = Stripe.webhooks;
         this._prevRequestMetrics = [];
         this._enableTelemetry = props.telemetry !== false;
         this._requestSender = requestSender(this);

package/esm/apiVersion.js

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

package/esm/resources/InvoicePayments.js

@@ -0,0 +1,14 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const InvoicePayments = StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/invoice_payments/{invoice_payment}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/invoice_payments',
+        methodType: 'list',
+    }),
+});

package/esm/resources/Invoices.js

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

package/esm/resources/SubscriptionItems.js

@@ -20,13 +20,4 @@ export const SubscriptionItems = StripeResource.extend({
         method: 'DELETE',
         fullPath: '/v1/subscription_items/{item}',
     }),
-    createUsageRecord: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/subscription_items/{subscription_item}/usage_records',
-    }),
-    listUsageRecordSummaries: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/subscription_items/{subscription_item}/usage_record_summaries',
-        methodType: 'list',
-    }),
 });

package/esm/resources.js

@@ -96,6 +96,7 @@ export { ExchangeRates } from './resources/ExchangeRates.js';
 export { FileLinks } from './resources/FileLinks.js';
 export { Files } from './resources/Files.js';
 export { InvoiceItems } from './resources/InvoiceItems.js';
+export { InvoicePayments } from './resources/InvoicePayments.js';
 export { InvoiceRenderingTemplates } from './resources/InvoiceRenderingTemplates.js';
 export { Invoices } from './resources/Invoices.js';
 export { Mandates } from './resources/Mandates.js';

package/esm/stripe.core.js

@@ -33,23 +33,14 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '17.7.0';
+    Stripe.PACKAGE_VERSION = '18.0.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));
+    Stripe.webhooks = createWebhooks(platformFunctions);
     function Stripe(key, config = {}) {
         if (!(this instanceof Stripe)) {
             return new Stripe(key, config);
@@ -98,9 +89,7 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         this._prepResources();
         this._setAuthenticator(key, props.authenticator);
         this.errors = _Error;
-        // Once Stripe.webhooks looses the factory function signature in a future release
-        // then this should become this.webhooks = Stripe.webhooks
-        this.webhooks = createWebhooksDefault();
+        this.webhooks = Stripe.webhooks;
         this._prevRequestMetrics = [];
         this._enableTelemetry = props.telemetry !== false;
         this._requestSender = requestSender(this);

package/package.json

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

package/types/Accounts.d.ts

@@ -33,7 +33,7 @@ declare module 'stripe' {
       business_profile?: Account.BusinessProfile | null;
 
       /**
-       * The business type. After you create an [Account Link](https://stripe.com/api/account_links) or [Account Session](https://stripe.com/api/account_sessions), this property is only returned for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
+       * The business type.
        */
       business_type?: Account.BusinessType | null;
 
@@ -93,7 +93,7 @@ declare module 'stripe' {
       /**
        * This is an object representing a person associated with a Stripe account.
        *
-       * A platform cannot access a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
+       * A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
        *
        * See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information).
        */
@@ -262,6 +262,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.
          */
@@ -387,6 +392,11 @@ declare module 'stripe' {
          */
         naver_pay_payments?: Capabilities.NaverPayPayments;
 
+        /**
+         * The status of the New Zealand BECS Direct Debit payments capability of the account, or whether the account can directly process New Zealand BECS Direct Debit charges.
+         */
+        nz_bank_account_becs_debit_payments?: Capabilities.NzBankAccountBecsDebitPayments;
+
         /**
          * The status of the OXXO payments capability of the account, or whether the account can directly process OXXO charges.
          */
@@ -427,6 +437,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.
          */
@@ -507,6 +522,8 @@ declare module 'stripe' {
 
         type BankTransferPayments = 'active' | 'inactive' | 'pending';
 
+        type BilliePayments = 'active' | 'inactive' | 'pending';
+
         type BlikPayments = 'active' | 'inactive' | 'pending';
 
         type BoletoPayments = 'active' | 'inactive' | 'pending';
@@ -557,6 +574,8 @@ declare module 'stripe' {
 
         type NaverPayPayments = 'active' | 'inactive' | 'pending';
 
+        type NzBankAccountBecsDebitPayments = 'active' | 'inactive' | 'pending';
+
         type OxxoPayments = 'active' | 'inactive' | 'pending';
 
         type P24Payments = 'active' | 'inactive' | 'pending';
@@ -573,6 +592,8 @@ declare module 'stripe' {
 
         type SamsungPayPayments = 'active' | 'inactive' | 'pending';
 
+        type SatispayPayments = 'active' | 'inactive' | 'pending';
+
         type SepaBankTransferPayments = 'active' | 'inactive' | 'pending';
 
         type SepaDebitPayments = 'active' | 'inactive' | 'pending';
@@ -637,17 +658,17 @@ declare module 'stripe' {
         export_purpose_code?: string;
 
         /**
-         * The company's legal name.
+         * The company's legal name. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
          */
         name?: string | null;
 
         /**
-         * The Kana variation of the company's legal name (Japan only).
+         * The Kana variation of the company's legal name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
          */
         name_kana?: string | null;
 
         /**
-         * The Kanji variation of the company's legal name (Japan only).
+         * The Kanji variation of the company's legal name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
          */
         name_kanji?: string | null;
 
@@ -661,6 +682,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;
 
         /**
@@ -669,7 +693,7 @@ declare module 'stripe' {
         phone?: string | null;
 
         /**
-         * The category identifying the legal structure of the company or legal entity. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.
+         * The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.
          */
         structure?: Company.Structure;
 
@@ -1018,6 +1042,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
             | 'invalid_address_private_mailbox'
@@ -1030,6 +1055,7 @@ declare module 'stripe' {
             | 'invalid_product_description_length'
             | 'invalid_product_description_url_match'
             | 'invalid_representative_country'
+            | 'invalid_signator'
             | 'invalid_statement_descriptor_business_mismatch'
             | 'invalid_statement_descriptor_denylisted'
             | 'invalid_statement_descriptor_length'
@@ -1091,6 +1117,7 @@ declare module 'stripe' {
             | 'verification_document_type_not_supported'
             | 'verification_extraneous_directors'
             | 'verification_failed_address_match'
+            | 'verification_failed_authorizer_authority'
             | 'verification_failed_business_iec_number'
             | 'verification_failed_document_match'
             | 'verification_failed_id_number_match'
@@ -1105,6 +1132,7 @@ declare module 'stripe' {
             | 'verification_missing_directors'
             | 'verification_missing_executives'
             | 'verification_missing_owners'
+            | 'verification_rejected_ownership_exemption_reason'
             | 'verification_requires_additional_memorandum_of_associations'
             | 'verification_requires_additional_proof_of_registration'
             | 'verification_supportability';
@@ -1209,6 +1237,7 @@ declare module 'stripe' {
 
         namespace Error {
           type Code =
+            | 'information_missing'
             | 'invalid_address_city_state_postal_code'
             | 'invalid_address_highway_contract_box'
             | 'invalid_address_private_mailbox'
@@ -1221,6 +1250,7 @@ declare module 'stripe' {
             | 'invalid_product_description_length'
             | 'invalid_product_description_url_match'
             | 'invalid_representative_country'
+            | 'invalid_signator'
             | 'invalid_statement_descriptor_business_mismatch'
             | 'invalid_statement_descriptor_denylisted'
             | 'invalid_statement_descriptor_length'
@@ -1282,6 +1312,7 @@ declare module 'stripe' {
             | 'verification_document_type_not_supported'
             | 'verification_extraneous_directors'
             | 'verification_failed_address_match'
+            | 'verification_failed_authorizer_authority'
             | 'verification_failed_business_iec_number'
             | 'verification_failed_document_match'
             | 'verification_failed_id_number_match'
@@ -1296,6 +1327,7 @@ declare module 'stripe' {
             | 'verification_missing_directors'
             | 'verification_missing_executives'
             | 'verification_missing_owners'
+            | 'verification_rejected_ownership_exemption_reason'
             | 'verification_requires_additional_memorandum_of_associations'
             | 'verification_requires_additional_proof_of_registration'
             | 'verification_supportability';
@@ -1432,6 +1464,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 {