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
- #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, andpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.components - Add support for
nameonBillingPortal.ConfigurationCreateParams,BillingPortal.ConfigurationUpdateParams, andBillingPortal.Configuration - Add support for
installmentsonCharge.payment_method_details.alma - Add support for
transaction_idonCharge.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, andCharge.payment_method_details.satispay - Add support for
locationandreaderonCharge.payment_method_details.paynow - Add support for
amount_includes_iofonCheckout.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, andPaymentIntentUpdateParams.payment_method_options.pix - Add support for new values
blockandresolutionon enumDispute.payment_method_details.card.case_type - Add support for new value
terminal_android_apkon enumsFile.purposeandFileListParams.purpose - Add support for new value
terminal_android_apkon enumFileCreateParams.purpose - Add support for
metadataandperiodonInvoiceCreatePreviewParams.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[], andSubscriptionUpdateParams.add_invoice_items[] - Add support for
exp_monthandexp_yearonIssuing.CardCreateParams - Add support for
excluded_payment_method_typesonPaymentIntentCreateParamsandPaymentIntent - Add support for
payout_methodonPayoutCreateParamsandPayout - Add support for
mxnonTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tipping - Add support for
cardonTerminal.ReaderPresentPaymentMethodParams.testHelpers - Add support for new value
cardon enumTerminal.ReaderPresentPaymentMethodParams.testHelpers.type - Add support for new value
2025-08-27.basilon enumWebhookEndpointCreateParams.api_version - Add support for error codes
customer_session_expiredandindia_recurring_payment_mandate_canceledonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for
- #2389 fix(example): expires_at is in milliseconds
v18.4.0
This release changes the pinned API version to 2025-07-30.basil.
- #2379 Update generated code
- Add support for
instant_payouts_promotiononAccountSession.componentsandAccountSessionCreateParams.components - Add support for
adjustable_quantityonBillingPortal.Configuration.features.subscription_update.products[],BillingPortal.ConfigurationCreateParams.features.subscription_update.products[], andBillingPortal.ConfigurationUpdateParams.features.subscription_update.products[] - Remove support for value
disabledfrom enumCapability.status - Add support for
transaction_idonCharge.payment_method_details.cashapp - Add support for
origin_contextonCheckout.SessionCreateParamsandCheckout.Session - Add support for
templateonCheckout.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, andPaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_options - Add support for
setup_future_usageonCheckout.Session.payment_method_options.pixandCheckout.SessionCreateParams.payment_method_options.pix - Add support for new value
nz_bank_accounton enumCheckout.SessionCreateParams.payment_method_types - Change
Identity.VerificationSession.related_person.accountto be required - Change
Identity.VerificationSession.related_person.personto be required - Add support for
durationonInvoiceCreatePreviewParams.schedule_details.phases[],SubscriptionScheduleCreateParams.phases[], andSubscriptionScheduleUpdateParams.phases[] - Change type of
InvoiceCreatePreviewParams.subscription_details.cancel_at,SubscriptionCreateParams.cancel_at, andSubscriptionUpdateParams.cancel_atfromDateTimetoDateTime | enum('max_period_end'|'min_period_end') - Add support for
price_dataonPaymentLinkCreateParams.line_items[] - Change
PaymentLinkCreateParams.line_items[].priceto be optional - Add support for new value
America/Coyhaiqueon enumReporting.ReportRunCreateParams.parameters.timezone - Add support for
standardonTax.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, andTax.RegistrationCreateParams.country_options.zw - Add support for new value
inbound_goodson enumsTax.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, andTax.RegistrationCreateParams.country_options.sk.standard.place_of_supply_scheme - Add support for
aed,bgn,huf, andrononTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tipping - Add support for new value
2025-07-30.basilon enumWebhookEndpointCreateParams.api_version
- Add support for
- #2365 Expose the API version pinned in the SDK via
Stripe.API_VERSION
v18.3.0
This release changes the pinned API version to 2025-06-30.basil.
- #2348 Update generated code
- Add support for
migratemethod on resourceSubscription - Add support for
collect_payment_methodandconfirm_payment_intentmethods on resourceTerminal.Reader - Add support for
crypto_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
proof_of_addressonAccountCreateParams.documentsandAccountUpdateParams.documents - Add support for
monthly_payout_daysandweekly_payout_daysonAccount.settings.payouts.schedule,AccountCreateParams.settings.payouts.schedule, andAccountUpdateParams.settings.payouts.schedule - Change
Account.settings.invoices.hosted_payment_method_saveto be required - Add support for
cryptoonCharge.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, andSetupIntentUpdateParams.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, andPaymentIntentUpdateParams.payment_method_options.card.installments.plan.typefromliteral('fixed_count')toenum('bonus'|'fixed_count'|'revolving') - Add support for new value
buuton enumsCharge.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, andSetupIntentUpdateParams.payment_method_data.ideal.bank - Add support for new value
BUUTNL2Aon enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentMethod.ideal.bic, andSetupAttempt.payment_method_details.ideal.bic - Add support for
subscriptionsonCheckout.SessionCreateParams.payment_method_options.klarna,PaymentIntentConfirmParams.payment_method_options.klarna,PaymentIntentCreateParams.payment_method_options.klarna, andPaymentIntentUpdateParams.payment_method_options.klarna - Add support for new value
cryptoon enumCheckout.SessionCreateParams.payment_method_types - Add support for
billing_modeonCheckout.SessionCreateParams.subscription_data,InvoiceCreatePreviewParams.schedule_details,InvoiceCreatePreviewParams.subscription_details,Quote.subscription_data,QuoteCreateParams.subscription_data,SubscriptionCreateParams,SubscriptionScheduleCreateParams,SubscriptionSchedule, andSubscription - Add support for new value
cryptoon enumsConfirmationTokenCreateParams.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, andSetupIntentUpdateParams.payment_method_data.type - Add support for new value
cryptoon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.type - Add support for new value
cryptoon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Change type of
Dispute.enhanced_eligibility_typesfromliteral('visa_compelling_evidence_3')toenum('visa_compelling_evidence_3'|'visa_compliance') - Add support for new value
complianceon enumDispute.payment_method_details.card.case_type - Add support for new value
terminal.reader.action_updatedon enumEvent.type - Add support for
related_persononIdentity.VerificationSessionCreateParamsandIdentity.VerificationSession - Add support for
matchingonIdentity.VerificationSession.options - Add support for new value
cryptoon enumsInvoice.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, andSubscriptionUpdateParams.payment_settings.payment_method_types - Add support for
klarnaonMandate.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_options, andSetupIntentUpdateParams.payment_method_options - Add support for
on_demandonPaymentIntentConfirmParams.payment_method_options.klarna,PaymentIntentCreateParams.payment_method_options.klarna, andPaymentIntentUpdateParams.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, andPaymentIntentUpdateParams.payment_method_options.klarna.setup_future_usagefromliteral('none')toenum('none'|'off_session'|'on_session') - Add support for
uaonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options - Change type of
Terminal.LocationUpdateParams.display_namefromstringtoemptyable(string) - Add support for
collect_payment_methodandconfirm_payment_intentonTerminal.Reader.action - Add support for new values
collect_payment_methodandconfirm_payment_intenton enumTerminal.Reader.action.type - Add support for
statusonTreasury.FinancialAccountListParams - Add support for new value
terminal.reader.action_updatedon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for new value
2025-06-30.basilon enumWebhookEndpointCreateParams.api_version - Add support for snapshot event
TerminalReaderActionUpdatedEventwith resourceTerminal.Reader
- Add support for
- #2356 add mise config for node version
- #2354 Add stripeContext to RequestOptions interface
- Add
stripeContextto theRequestOptionsandStripeConfiginterfaces.
- Add
v18.2.1
- #2346 Allow data to be set in only
POSTrawRequests- Fix bug where
rawRequestincorrectly emits a warning when sending v2 GET requests
- Fix bug where
v18.2.0
This release changes the pinned API version to 2025-05-28.basil.
- #2338 Update generated code
- Add support for
attach_paymentmethod on resourceInvoice - Add support for
collect_inputsmethod on resourceTerminal.Reader - Add support for
succeed_input_collectionandtimeout_input_collectiontest helper methods on resourceTerminal.Reader - Add support for
pix_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
disputes_listandpayment_disputesonAccountSession.componentsandAccountSessionCreateParams.components - Add support for
refund_and_dispute_prefundingonBalance - Add support for
balance_typeonBalanceTransaction - Change
Billing.AlertCreateParams.usage_threshold.meterto be required - Add support for
locationandreaderonCharge.payment_method_details.affirmandCharge.payment_method_details.wechat_pay - Add support for
payment_method_removeonCheckout.SessionCreateParams.saved_payment_method_options - Add support for
setup_future_usageonCheckout.Session.payment_method_options.naver_pay - Change
ConfirmationToken.payment_method_preview.naver_pay.buyer_idandPaymentMethod.naver_pay.buyer_idto be required - Add support for
post_payment_amountandpre_payment_amountonCreditNote - Add support for new value
mixedon enumCreditNote.type - Add support for new value
invoice_payment.paidon enumEvent.type - Add support for
sex,unparsed_place_of_birth, andunparsed_sexonIdentity.VerificationReport.documentandIdentity.VerificationSession.verified_outputs - Add support for
billing_thresholdsonInvoiceCreatePreviewParams.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, andSubscription - Add support for
satispayonPaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_options, andPaymentIntentUpdateParams.payment_method_options - Add support for
capture_methodonPaymentIntent.payment_method_options.billie - Add support for
kakao_pay,kr_card,naver_pay,payco, andsamsung_payonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfiguration - Add support for
network_decline_codeonRefund.destination_details.paypal - Add support for
metadataonTax.CalculationCreateParams.line_items[]andTax.CalculationLineItem - Add support for new value
simulated_stripe_s700on enumsTerminal.Reader.device_typeandTerminal.ReaderListParams.device_type - Add support for
return_urlonTerminal.Reader.action.process_payment_intent.process_configandTerminal.ReaderProcessPaymentIntentParams.process_config - Add support for
collect_inputsonTerminal.Reader.action - Add support for new value
collect_inputson enumTerminal.Reader.action.type - Add support for new value
invoice_payment.paidon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for new value
2025-05-28.basilon enumWebhookEndpointCreateParams.api_version - Add support for snapshot event
InvoicePaymentPaidEventwith resourceInvoicePayment - Add support for error code
forwarding_api_upstream_erroronInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for
v18.1.1
- #2308 RawRequest now allows you set
hostandstreamingin 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
This release changes the pinned API version to 2025-04-30.basil.
- #2311 Update generated code
- Add support for
minority_owned_business_designationonAccount.business_profile,AccountCreateParams.business_profile, andAccountUpdateParams.business_profile - Add support for
registration_dateonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.company - Add support for
us_cfpb_dataonAccountCreatePersonParams,AccountUpdatePersonParams,Person, andTokenCreateParams.person - Add support for new value
verification_legal_entity_structure_mismatchon enumsAccount.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, andPerson.requirements.errors[].code - Add support for new value
tax_id_prohibitedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.code - Add support for
tax_idonCharge.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, andSetupIntentUpdateParams.payment_method_data.billing_details - Add support for
wallet_optionsonCheckout.SessionCreateParamsandCheckout.Session - Add support for
provideronCheckout.Session.automatic_tax,Invoice.automatic_tax, andQuote.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, andla_tinon enumsCheckout.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, andTaxId.type - Add support for
payment_method_optionsonConfirmationTokenCreateParams.testHelpers - Add support for
installmentsonConfirmationToken.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, andla_tinon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.type - Add support for
contextonEvent - Add support for new value
affirmon enumsInvoice.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, andSubscriptionUpdateParams.payment_settings.payment_method_types - Change type of
InvoiceLineItem.parent.subscription_item_details.subscriptionfromstringtostring | null - Add support for
billieonPaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_options, andPaymentIntentUpdateParams.payment_method_options - Add support for
pixonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfiguration - Add support for
klarnaonPaymentMethodDomain - Add support for
pending_reasononRefund - Change type of
Tax.CalculationLineItem.referencefromstring | nulltostring - Add support for
aw,az,bd,bf,bj,cm,cv,et,in,kg,la, andphonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options - Add support for new value
2025-04-30.basilon enumWebhookEndpointCreateParams.api_version
- Add support for
- #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
#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
SubscriptionItemUsageRecordSummaryandSubscriptionItemUsageRecord - Remove support for
listUpcomingLinesandretrieveUpcomingmethods on resourceInvoice - Remove support for
createUsageRecordandlistUsageRecordSummariesmethods on resourceSubscriptionItems - Remove support for
invoiceonChargeandPaymentIntent - Remove support for
shipping_detailsonCheckout.Session - Remove support for
carrier,phone, andtracking_numberonCheckout.Session.collected_information.shipping_details. Makenameandaddressrequired instead of optional. - Remove support for
refundonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNote - Remove support for
tax_amountsonCreditNoteLineItem,CreditNote, andInvoiceLineItem - Remove support for
amount_excluding_taxandunit_amount_excluding_taxonCreditNoteLineItemandInvoiceLineItem - Remove support for
coupononCustomerCreateParams,CustomerUpdateParams,InvoiceCreatePreviewParams.schedule_details.phases[],InvoiceCreatePreviewParams,SubscriptionCreateParams,SubscriptionSchedule.phases[],SubscriptionScheduleCreateParams.phases[],SubscriptionScheduleUpdateParams.phases[], andSubscriptionUpdateParams - Remove support for
promotion_codeonCustomerCreateParams,CustomerUpdateParams,SubscriptionCreateParams, andSubscriptionUpdateParams - Remove support for
priceonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]. Usepricing` instead. - Remove support for
billing_thresholdsonInvoiceCreatePreviewParams.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, andSubscription - 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, andtransfer_dataonInvoice - Remove support for
discountonInvoiceandSubscription - Remove support for
invoice_item,proration_details,proration,tax_rates, andtypeonInvoiceLineItem - Remove support for
planandsubscription_itemonInvoiceItemandInvoiceLineItem - Remove support for
unit_amountonInvoiceItemCreateParams,InvoiceItemUpdateParams, andInvoiceItem - Remove support for
subscriptionandunit_amount_decimalonInvoiceItem - Remove support for
naver_payonPaymentMethodUpdateParams - Remove support for
aggregate_usageonPlanCreateParams,Plan,Price.recurring, andPriceCreateParams.recurring - Remove support for
current_period_endandcurrent_period_startonSubscription pagehas been removed from all V2 list method params (e.g.EventService.list()); use the auto paginator or thenext_page_urlandprevious_page_urlfields instead (more info)
Changes
- Change
Checkout.Session.collected_informationto be required - Change
Checkout.Session.collected_information.shipping_detailsto be required - Change
Checkout.Session.collected_information.shipping_details.addressto be required - Change
Checkout.Session.collected_information.shipping_details.nameto be required - Change
PaymentIntentConfirmParams.payment_method_options.wechat_pay.client,PaymentIntentCreateParams.payment_method_options.wechat_pay.client, andPaymentIntentUpdateParams.payment_method_options.wechat_pay.clientto be optional - Change
political_exposureon resourcesPersonandTokenand paramsToken.CreateParamsfrom string to enum("existing" | "none")
Additions
- Add support for new resource
InvoicePayment - Add support for
listandretrievemethods on resourceInvoicePayment - Add support for
billie_payments,nz_bank_account_becs_debit_payments, andsatispay_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
hosted_payment_method_saveonAccount.settings.invoicesandAccountUpdateParams.settings.invoices - Add support for
invoicesonAccountCreateParams.settings - Add support for new values
information_missing,invalid_signator,verification_failed_authorizer_authority, andverification_rejected_ownership_exemption_reasonon enumsAccount.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, andBankAccount.requirements.errors[].code - Add support for new values
forwarding_api_retryable_upstream_errorandsetup_intent_mobile_wallet_unsupportedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.code - Add support for new values
stripe_balance_payment_debit_reversalandstripe_balance_payment_debiton enumBalanceTransaction.type - Add support for new value
laston enumsBilling.Meter.default_aggregation.formulaandBilling.MeterCreateParams.default_aggregation.formula - Add support for
presentment_detailsonCharge,Checkout.Session,PaymentIntent, andRefund - Add support for
billieandsatispayonCharge.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, andSetupIntentUpdateParams.payment_method_data - Add support for
nz_bank_accountonCharge.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, andSetupIntentUpdateParams.payment_method_data - Add support for
optional_itemsonCheckout.SessionCreateParams,Checkout.Session,PaymentLinkCreateParams, andPaymentLink - Add support for
permissionsonCheckout.SessionCreateParamsandCheckout.Session - Add support for new values
billieandsatispayon enumCheckout.SessionCreateParams.payment_method_types - Add support for new value
customon enumsCheckout.Session.ui_modeandCheckout.SessionCreateParams.ui_mode - Add support for
shipping_optionsonCheckout.SessionUpdateParams - Add support for new values
billie,nz_bank_account, andsatispayon enumsConfirmationTokenCreateParams.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, andSetupIntentUpdateParams.payment_method_data.type - Add support for
buyer_idonConfirmationToken.payment_method_preview.naver_pay,CustomerPaymentMethod.naver_pay, andPaymentMethod.naver_pay - Add support for new values
billie,nz_bank_account, andsatispayon enumsConfirmationToken.payment_method_preview.type,CustomerPaymentMethod.type, andPaymentMethod.type - Add support for
refundsonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNote - Add support for
total_taxesonCreditNoteandInvoice - Add support for
taxesonCreditNoteLineItemandInvoiceLineItem - Add support for
checkout_sessiononCustomerBalanceTransaction - Add support for new values
checkout_session_subscription_payment_canceledandcheckout_session_subscription_paymenton enumCustomerBalanceTransaction.type - Add support for new values
billie,nz_bank_account, andsatispayon enumsCustomerPaymentMethodListParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for new value
invoice.overpaidon enumEvent.type - Add support for new values
klarnaandnz_bank_accounton enumsInvoice.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, andSubscriptionUpdateParams.payment_settings.payment_method_types - Add support for
pricingonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[] - Add support for
taxability_reasononInvoiceAddLinesParams.lines[].tax_amounts[],InvoiceLineItemUpdateParams.tax_amounts[], andInvoiceUpdateLinesParams.lines[].tax_amounts[] - Add support for
jurisdiction_levelonInvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data,InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, andInvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data - Add support for
amount_overpaid,confirmation_secret, andpaymentsonInvoice - Add support for
parentonInvoiceItem,InvoiceLineItem, andInvoice - Add support for new value
expiredon enumsIssuing.Authorization.statusandIssuing.AuthorizationListParams.status - Add support for new value
network_fallbackon enumIssuing.Authorization.request_history[].reason - Add support for
naver_payonMandate.payment_method_detailsandSetupAttempt.payment_method_details - Add support for
setup_future_usageonPaymentIntent.payment_method_options.naver_pay,PaymentIntentConfirmParams.payment_method_options.naver_pay,PaymentIntentCreateParams.payment_method_options.naver_pay, andPaymentIntentUpdateParams.payment_method_options.naver_pay - Add support for new value
expiredon enumPaymentIntent.cancellation_reason - Add support for
default_valueonPaymentLink.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, andPaymentLinkUpdateParams.custom_fields[].text - Add support for new values
billieandsatispayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_types - Add support for
nz_bank_transferonRefund.destination_details - Add support for new value
canceledon enumReview.closed_reason - Add support for
current_period_endandcurrent_period_startonSubscriptionItem - Add support for
wifionTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configuration - Add support for new value
invoice.overpaidon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for new values
2025-03-01.dashboardand2025-03-31.basilon enumWebhookEndpointCreateParams.api_version
⚠️ Other Breaking changes in the SDK
- #2277 Swap Stripe.webhooks from a factory function to a static property
Stripe.webhooksandStripe().webhooksare 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 useStripe.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
AccountDebitSourcein favor ofAccount - Remove
CapabilityListParamsin favor ofAccountListCapabilitiesParams - Remove
CapabilityRetrieveParamsin favor ofAccountRetrieveCapabilityParams - Remove
CapabilityUpdateParamsin favor ofAccountUpdateCapabilityParams - Remove
CashBalanceRetrieveParamsin favor ofCustomerRetrieveCashBalanceParams - Remove
CashBalanceUpdateParamsin favor ofCustomerUpdateCashBalanceParams - Remove
CreditNoteLineItemListParamsin favor ofCreditNoteListLineItemsParams - Remove
CustomerBalanceTransactionCreateParamsin favor ofCustomerCreateBalanceTransactionParams - Remove
CustomerBalanceTransactionListParamsin favor ofCustomerListBalanceTransactionsParams - Remove
CustomerBalanceTransactionRetrieveParamsin favor ofCustomerRetrieveBalanceTransactionParams - Remove
CustomerBalanceTransactionUpdateParamsin favor ofCustomerUpdateBalanceTransactionParams - Remove
CustomerCashBalanceTransactionListParamsin favor ofCustomerListCashBalanceTransactionsParams - Remove
CustomerCashBalanceTransactionRetrieveParamsin favor ofCustomerRetrieveCashBalanceTransactionParams - Remove
CustomerSourceCreateParamsin favor ofCustomerCreateSourceParams - Remove
CustomerSourceDeleteParamsin favor ofCustomerDeleteSourceParams - Remove
CustomerSourceListParamsin favor ofCustomerListSourcesParams - Remove
CustomerSourceRetrieveParamsin favor ofCustomerRetrieveSourceParams - Remove
CustomerSourceUpdateParamsin favor ofCustomerUpdateSourceParams - Remove
CustomerSourceVerifyParamsin favor ofCustomerVerifySourceParams - Remove
ExternalAccountCreateParamsin favor ofAccountCreateExternalAccountParams - Remove
ExternalAccountDeleteParamsin favor ofAccountDeleteExternalAccountParams - Remove
ExternalAccountListParamsin favor ofAccountListExternalAccountsParams - Remove
ExternalAccountRetrieveParamsin favor ofAccountRetrieveExternalAccountParams - Remove
ExternalAccountUpdateParamsin favor ofAccountUpdateExternalAccountParams - Remove
FeeRefundCreateParamsin favor ofApplicationFeeCreateRefundParams - Remove
FeeRefundListParamsin favor ofApplicationFeeListRefundsParams - Remove
FeeRefundRetrieveParamsin favor ofApplicationFeeRetrieveRefundParams - Remove
FeeRefundUpdateParamsin favor ofApplicationFeeUpdateRefundParams - Remove
InvoiceLineItemListParamsin favor ofInvoiceListLineItemsParams - Remove
InvoiceLineItemUpdateParamsin favor ofInvoiceUpdateLineItemParams - Remove
LoginLinkCreateParamsin favor ofAccountCreateLoginLinkParams - Remove
PersonCreateParamsin favor ofAccountCreatePersonParams - Remove
PersonDeleteParamsin favor ofAccountDeletePersonParams - Remove
PersonListParamsin favor ofAccountListPersonsParams - Remove
PersonRetrieveParamsin favor ofAccountRetrievePersonParams - Remove
PersonUpdateParamsin favor ofAccountUpdatePersonParams - Remove
TransferReversalCreateParamsin favor ofTransferCreateReversalParams - Remove
TransferReversalListParamsin favor ofTransferListReversalsParams - Remove
TransferReversalRetrieveParamsin favor ofTransferRetrieveReversalParams - Remove
TransferReversalUpdateParamsin favor ofTransferUpdateReversalParams
- Remove
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.