chore(deps): update dependency stripe to v18 - autoclosed

[renovate]

Coming soon: The Renovate bot (GitHub App) will be renamed to Mend. PRs from Renovate will soon appear from 'Mend'. Learn more here.

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
stripe	^17.7.0 -> ^18.5.0

---

Release Notes

stripe/stripe-node (stripe)

v18.5.0

Compare Source

• #​2392 Add section on private preview SDKs in readme
• #​2384 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • Add support for name on BillingPortal.ConfigurationCreateParams, BillingPortal.ConfigurationUpdateParams, and BillingPortal.Configuration
  • Add support for installments on Charge.payment_method_details.alma
  • Add support for transaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
  • Add support for location and reader on Charge.payment_method_details.paynow
  • Add support for amount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pix
  • Add support for new values block and resolution on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal_android_apk on enums File.purpose and FileListParams.purpose
  • Add support for new value terminal_android_apk on enum FileCreateParams.purpose
  • Add support for metadata and period on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for exp_month and exp_year on Issuing.CardCreateParams
  • Add support for excluded_payment_method_types on PaymentIntentCreateParams and PaymentIntent
  • Add support for payout_method on PayoutCreateParams and Payout
  • Add support for mxn on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for card on Terminal.ReaderPresentPaymentMethodParams.testHelpers
  • Add support for new value card on enum Terminal.ReaderPresentPaymentMethodParams.testHelpers.type
  • Add support for new value 2025-08-27.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #​2389 fix(example): expires_at is in milliseconds

v18.4.0

Compare Source

This release changes the pinned API version to 2025-07-30.basil.

• #​2379 Update generated code
  • Add support for instant_payouts_promotion on AccountSession.components and AccountSessionCreateParams.components
  • Add support for adjustable_quantity on BillingPortal.Configuration.features.subscription_update.products[], BillingPortal.ConfigurationCreateParams.features.subscription_update.products[], and BillingPortal.ConfigurationUpdateParams.features.subscription_update.products[]
  • Remove support for value disabled from enum Capability.status
  • Add support for transaction_id on Charge.payment_method_details.cashapp
  • Add support for origin_context on Checkout.SessionCreateParams and Checkout.Session
  • Add support for template on Checkout.Session.invoice_creation.invoice_data.rendering_options, Checkout.SessionCreateParams.invoice_creation.invoice_data.rendering_options, PaymentLink.invoice_creation.invoice_data.rendering_options, PaymentLinkCreateParams.invoice_creation.invoice_data.rendering_options, and PaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_options
  • Add support for setup_future_usage on Checkout.Session.payment_method_options.pix and Checkout.SessionCreateParams.payment_method_options.pix
  • Add support for new value nz_bank_account on enum Checkout.SessionCreateParams.payment_method_types
  • Change Identity.VerificationSession.related_person.account to be required
  • Change Identity.VerificationSession.related_person.person to be required
  • Add support for duration on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
  • Change type of InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Add support for price_data on PaymentLinkCreateParams.line_items[]
  • Change PaymentLinkCreateParams.line_items[].price to be optional
  • Add support for new value America/Coyhaique on enum Reporting.ReportRunCreateParams.parameters.timezone
  • Add support for standard on Tax.Registration.country_options.ae, Tax.Registration.country_options.au, Tax.Registration.country_options.ch, Tax.Registration.country_options.gb, Tax.Registration.country_options.jp, Tax.Registration.country_options.no, Tax.Registration.country_options.nz, Tax.Registration.country_options.sg, Tax.RegistrationCreateParams.country_options.ae, Tax.RegistrationCreateParams.country_options.al, Tax.RegistrationCreateParams.country_options.ao, Tax.RegistrationCreateParams.country_options.au, Tax.RegistrationCreateParams.country_options.aw, Tax.RegistrationCreateParams.country_options.ba, Tax.RegistrationCreateParams.country_options.bb, Tax.RegistrationCreateParams.country_options.bd, Tax.RegistrationCreateParams.country_options.bf, Tax.RegistrationCreateParams.country_options.bh, Tax.RegistrationCreateParams.country_options.bs, Tax.RegistrationCreateParams.country_options.cd, Tax.RegistrationCreateParams.country_options.ch, Tax.RegistrationCreateParams.country_options.et, Tax.RegistrationCreateParams.country_options.gb, Tax.RegistrationCreateParams.country_options.gn, Tax.RegistrationCreateParams.country_options.is, Tax.RegistrationCreateParams.country_options.jp, Tax.RegistrationCreateParams.country_options.me, Tax.RegistrationCreateParams.country_options.mk, Tax.RegistrationCreateParams.country_options.mr, Tax.RegistrationCreateParams.country_options.no, Tax.RegistrationCreateParams.country_options.nz, Tax.RegistrationCreateParams.country_options.om, Tax.RegistrationCreateParams.country_options.rs, Tax.RegistrationCreateParams.country_options.sg, Tax.RegistrationCreateParams.country_options.sr, Tax.RegistrationCreateParams.country_options.uy, Tax.RegistrationCreateParams.country_options.za, and Tax.RegistrationCreateParams.country_options.zw
  • Add support for new value inbound_goods on enums Tax.Registration.country_options.at.standard.place_of_supply_scheme, Tax.Registration.country_options.be.standard.place_of_supply_scheme, Tax.Registration.country_options.bg.standard.place_of_supply_scheme, Tax.Registration.country_options.cy.standard.place_of_supply_scheme, Tax.Registration.country_options.cz.standard.place_of_supply_scheme, Tax.Registration.country_options.de.standard.place_of_supply_scheme, Tax.Registration.country_options.dk.standard.place_of_supply_scheme, Tax.Registration.country_options.ee.standard.place_of_supply_scheme, Tax.Registration.country_options.es.standard.place_of_supply_scheme, Tax.Registration.country_options.fi.standard.place_of_supply_scheme, Tax.Registration.country_options.fr.standard.place_of_supply_scheme, Tax.Registration.country_options.gr.standard.place_of_supply_scheme, Tax.Registration.country_options.hr.standard.place_of_supply_scheme, Tax.Registration.country_options.hu.standard.place_of_supply_scheme, Tax.Registration.country_options.ie.standard.place_of_supply_scheme, Tax.Registration.country_options.it.standard.place_of_supply_scheme, Tax.Registration.country_options.lt.standard.place_of_supply_scheme, Tax.Registration.country_options.lu.standard.place_of_supply_scheme, Tax.Registration.country_options.lv.standard.place_of_supply_scheme, Tax.Registration.country_options.mt.standard.place_of_supply_scheme, Tax.Registration.country_options.nl.standard.place_of_supply_scheme, Tax.Registration.country_options.pl.standard.place_of_supply_scheme, Tax.Registration.country_options.pt.standard.place_of_supply_scheme, Tax.Registration.country_options.ro.standard.place_of_supply_scheme, Tax.Registration.country_options.se.standard.place_of_supply_scheme, Tax.Registration.country_options.si.standard.place_of_supply_scheme, Tax.Registration.country_options.sk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.at.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.be.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.bg.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cy.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cz.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.de.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.dk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ee.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.es.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fi.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.gr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ie.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.it.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lv.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.mt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.nl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ro.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.se.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.si.standard.place_of_supply_scheme, and Tax.RegistrationCreateParams.country_options.sk.standard.place_of_supply_scheme
  • Add support for aed, bgn, huf, and ron on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for new value 2025-07-30.basil on enum WebhookEndpointCreateParams.api_version
• #​2365 Expose the API version pinned in the SDK via Stripe.API_VERSION

v18.3.0

Compare Source

This release changes the pinned API version to 2025-06-30.basil.

• #​2348 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
  • Add support for crypto_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for proof_of_address on AccountCreateParams.documents and AccountUpdateParams.documents
  • Add support for monthly_payout_days and weekly_payout_days on Account.settings.payouts.schedule, AccountCreateParams.settings.payouts.schedule, and AccountUpdateParams.settings.payouts.schedule
  • Change Account.settings.invoices.hosted_payment_method_save to be required
  • Add support for crypto on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Change type of Charge.payment_method_details.card.installments.plan.type, ConfirmationToken.payment_method_options.card.installments.plan.type, ConfirmationTokenCreateParams.testHelpers.payment_method_options.card.installments.plan.type, InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.type, InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.type, PaymentIntent.payment_method_options.card.installments.available_plans[].type, PaymentIntent.payment_method_options.card.installments.plan.type, PaymentIntentConfirmParams.payment_method_options.card.installments.plan.type, PaymentIntentCreateParams.payment_method_options.card.installments.plan.type, and PaymentIntentUpdateParams.payment_method_options.card.installments.plan.type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')
  • Add support for new value buut on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value BUUTNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for subscriptions on Checkout.SessionCreateParams.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for new value crypto on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for billing_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscription
  • Add support for new value crypto 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 new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value crypto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value compliance on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSessionCreateParams and Identity.VerificationSession
  • Add support for matching on Identity.VerificationSession.options
  • Add support for new value crypto 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 klarna on Mandate.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for on_demand on PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Change type of PaymentIntent.payment_method_options.klarna.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.klarna.setup_future_usage, PaymentIntentCreateParams.payment_method_options.klarna.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for ua on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Change type of Terminal.LocationUpdateParams.display_name from string to emptyable(string)
  • Add support for collect_payment_method and confirm_payment_intent on Terminal.Reader.action
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.type
  • Add support for status on Treasury.FinancialAccountListParams
  • Add support for new value terminal.reader.action_updated on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-06-30.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot event TerminalReaderActionUpdatedEvent with resource Terminal.Reader
• #​2356 add mise config for node version
• #​2354 Add stripeContext to RequestOptions interface
  • Add stripeContext to theRequestOptions and StripeConfig interfaces.

v18.2.1

Compare Source

• #​2346 Allow data to be set in only POST rawRequests
  • Fix bug where rawRequest incorrectly emits a warning when sending v2 GET requests

v18.2.0

Compare Source

This release changes the pinned API version to 2025-05-28.basil.

• #​2338 Update generated code
  • Add support for attach_payment method on resource Invoice
  • Add support for collect_inputs method on resource Terminal.Reader
  • Add support for succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.Reader
  • Add support for pix_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for disputes_list and payment_disputes on AccountSession.components and AccountSessionCreateParams.components
  • Add support for refund_and_dispute_prefunding on Balance
  • Add support for balance_type on BalanceTransaction
  • Change Billing.AlertCreateParams.usage_threshold.meter to be required
  • Add support for location and reader on Charge.payment_method_details.affirm and Charge.payment_method_details.wechat_pay
  • Add support for payment_method_remove on Checkout.SessionCreateParams.saved_payment_method_options
  • Add support for setup_future_usage on Checkout.Session.payment_method_options.naver_pay
  • Change ConfirmationToken.payment_method_preview.naver_pay.buyer_id and PaymentMethod.naver_pay.buyer_id to be required
  • Add support for post_payment_amount and pre_payment_amount on CreditNote
  • Add support for new value mixed on enum CreditNote.type
  • Add support for new value invoice_payment.paid on enum Event.type
  • Add support for sex, unparsed_place_of_birth, and unparsed_sex on Identity.VerificationReport.document and Identity.VerificationSession.verified_outputs
  • Add 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
  • Add support for satispay on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for capture_method on PaymentIntent.payment_method_options.billie
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for network_decline_code on Refund.destination_details.paypal
  • Add support for metadata on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItem
  • Add support for new value simulated_stripe_s700 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_type
  • Add support for return_url on Terminal.Reader.action.process_payment_intent.process_config and Terminal.ReaderProcessPaymentIntentParams.process_config
  • Add support for collect_inputs on Terminal.Reader.action
  • Add support for new value collect_inputs on enum Terminal.Reader.action.type
  • Add support for new value invoice_payment.paid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-05-28.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot event InvoicePaymentPaidEvent with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

v18.1.1

Compare Source

• #​2308 RawRequest now allows you set host and streaming in request options.

  const file = await stripe.rawRequest(
    'GET',
    '/v1/files/file_123/contents',
    {},
    {host: 'files.stripe.com', streaming: true}
  );

• #​2320 fix: examples/webhook-signing/nestjs/package.json to reduce vulnerabilities.
• #​2326 Adds CONTRIBUTING.md

v18.1.0

Compare Source

This release changes the pinned API version to 2025-04-30.basil.

• #​2311 Update generated code
  • Add support for minority_owned_business_designation on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
  • Add support for registration_date on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Add support for us_cfpb_data on AccountCreatePersonParams, AccountUpdatePersonParams, Person, and TokenCreateParams.person
  • Add support for new value verification_legal_entity_structure_mismatch on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.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 new value tax_id_prohibited 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 tax_id on Charge.billing_details, ConfirmationToken.payment_method_preview.billing_details, ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details, PaymentIntentConfirmParams.payment_method_data.billing_details, PaymentIntentCreateParams.payment_method_data.billing_details, PaymentIntentUpdateParams.payment_method_data.billing_details, PaymentMethod.billing_details, PaymentMethodCreateParams.billing_details, PaymentMethodUpdateParams.billing_details, SetupIntentConfirmParams.payment_method_data.billing_details, SetupIntentCreateParams.payment_method_data.billing_details, and SetupIntentUpdateParams.payment_method_data.billing_details
  • Add support for wallet_options on Checkout.SessionCreateParams and Checkout.Session
  • Add support for provider on Checkout.Session.automatic_tax, Invoice.automatic_tax, and Quote.automatic_tax
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Add support for payment_method_options on ConfirmationTokenCreateParams.testHelpers
  • Add support for installments on ConfirmationToken.payment_method_options.card
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Add support for context on Event
  • Add support for new value affirm 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
  • Change type of InvoiceLineItem.parent.subscription_item_details.subscription from string to string | null
  • Add support for billie on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for pix on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for klarna on PaymentMethodDomain
  • Add support for pending_reason on Refund
  • Change type of Tax.CalculationLineItem.reference from string | null to string
  • Add support for aw, az, bd, bf, bj, cm, cv, et, in, kg, la, and ph on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Add support for new value 2025-04-30.basil on enum WebhookEndpointCreateParams.api_version
• #​2202 Add build scripts to generate source maps
• #​2169 Put @​types/node as an optional peerDependency
• #​2164 Bump micromatch from 4.0.5 to 4.0.8
• #​2230 Bump cross-spawn from 7.0.3 to 7.0.6

v18.0.0

Compare Source

• #​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 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 or the next_page_url and previous_page_url fields instead (more info)

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 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 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

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.