ℹ️ Note
This PR body was truncated due to platform limits.
This PR contains the following updates:
| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| stripe | ^17.7.0 → ^20.4.0 |
Release Notes
stripe/stripe-node (stripe)
v20.4.0
This release changes the pinned API version to 2026-02-25.clover.
- #2581 Update generated code
- Add support for new resources
Reserve.Hold,Reserve.Plan, andReserve.Release - Add support for
locationandreaderonCharge.payment_method_details.card_present,Charge.payment_method_details.interac_present,ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present,PaymentAttemptRecord.payment_method_details.card_present,PaymentAttemptRecord.payment_method_details.interac_present,PaymentMethod.card.generated_from.payment_method_details.card_present,PaymentRecord.payment_method_details.card_present, andPaymentRecord.payment_method_details.interac_present - Add support for new value
lk_vaton 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 new value
lk_vaton 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 new values
reserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumEvent.type - Add support for new values
terminal_wifi_certificateandterminal_wifi_private_keyon enumsFile.purposeandFileListParams.purpose - Add support for new values
terminal_wifi_certificateandterminal_wifi_private_keyon enumFileCreateParams.purpose - Add support for new value
pay_by_bankon 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
display_nameandservice_user_numberonMandate.payment_method_details.bacs_debit - Change type of
PaymentAttemptRecord.payment_method_details.boleto.tax_idandPaymentRecord.payment_method_details.boleto.tax_idfromstringtostring | null - Change type of
PaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_dateandPaymentRecord.payment_method_details.us_bank_account.expected_debit_datefromstring | nulltostring - Add support for
transaction_purposeonPaymentIntent.payment_method_options.us_bank_account,PaymentIntentConfirmParams.payment_method_options.us_bank_account,PaymentIntentCreateParams.payment_method_options.us_bank_account, andPaymentIntentUpdateParams.payment_method_options.us_bank_account - Add support for
optional_itemsonPaymentLinkUpdateParams - Remove support for unused
card_issuer_declineonRadar.PaymentEvaluation.insights - Add support for
payment_behavioronSubscriptionItemDeleteParams - Add support for
lkonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options - Add support for
cellularandstripe_s710onTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configuration - Add support for new values
simulated_stripe_s710andstripe_s710on enumsTerminal.Reader.device_typeandTerminal.ReaderListParams.device_type - Add support for new values
reserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for new value
2026-02-25.cloveron enumWebhookEndpointCreateParams.api_version - Add support for snapshot events
ReserveHoldCreatedEventandReserveHoldUpdatedEventwith resourceReserve.Hold - Add support for snapshot events
ReservePlanCreatedEvent,ReservePlanDisabledEvent,ReservePlanExpiredEvent, andReservePlanUpdatedEventwith resourceReserve.Plan - Add support for snapshot event
ReserveReleaseCreatedEventwith resourceReserve.Release - Add support for error codes
storer_capability_missingandstorer_capability_not_activeonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for new resources
v20.3.1
- #2571 Fix
UnhandledPromiseRejectionerror on failed V2 List operations- Fixes a bug where any error returned from the Stripe API on a V2 List call (e.g. a 4xx or 5xx) would crash Node due to an
UnhandledPromiseRejection
- Fixes a bug where any error returned from the Stripe API on a V2 List call (e.g. a 4xx or 5xx) would crash Node due to an
v20.3.0
This release changes the pinned API version to 2026-01-28.clover.
- #2564 Update generated code
- Add support for new resource
Radar.PaymentEvaluation - Add support for
createmethod on resourceRadar.PaymentEvaluation - Add support for
adjustable_quantityonLineItem - Add support for new value
risk_reservedon enumBalanceTransaction.balance_type - Add support for new values
reserve_holdandreserve_releaseon enumBalanceTransaction.type - Add support for new values
2.3.0and2.3.1on enumsCharge.payment_method_details.card.three_d_secure.version,PaymentIntentConfirmParams.payment_method_options.card.three_d_secure.version,PaymentIntentCreateParams.payment_method_options.card.three_d_secure.version,PaymentIntentUpdateParams.payment_method_options.card.three_d_secure.version,SetupAttempt.payment_method_details.card.three_d_secure.version,SetupIntentConfirmParams.payment_method_options.card.three_d_secure.version,SetupIntentCreateParams.payment_method_options.card.three_d_secure.version, andSetupIntentUpdateParams.payment_method_options.card.three_d_secure.version - Add support for new value
adyenon enumsCharge.payment_method_details.ideal.bank,ConfirmationToken.payment_method_preview.ideal.bank,ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank,PaymentAttemptRecord.payment_method_details.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,PaymentRecord.payment_method_details.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
ADYBNL2Aon enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentAttemptRecord.payment_method_details.ideal.bic,PaymentMethod.ideal.bic,PaymentRecord.payment_method_details.ideal.bic, andSetupAttempt.payment_method_details.ideal.bic - Add support for new value
pl_nipon 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 new value
pl_nipon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.type - Change
Invoice.payment_settings.payment_method_options.paytoandSubscription.payment_settings.payment_method_options.paytoto be required - Add support for
enforce_arithmetic_validationonPaymentIntentCaptureParams.amount_details,PaymentIntentConfirmParams.amount_details,PaymentIntentCreateParams.amount_details,PaymentIntentIncrementAuthorizationParams.amount_details, andPaymentIntentUpdateParams.amount_details - Add support for
erroronPaymentIntent.amount_details - Remove support for
bgnonTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tipping - Add support for
topuponTreasury.ReceivedDebit.linked_flows - Add support for
contact_phoneonV2.Core.AccountCreateParams,V2.Core.AccountTokenCreateParams,V2.Core.AccountUpdateParams, andV2.Core.Account - Add support for
registration_dateonV2.Core.Account.identity.business_details,V2.Core.AccountCreateParams.identity.business_details,V2.Core.AccountTokenCreateParams.identity.business_details, andV2.Core.AccountUpdateParams.identity.business_details - Add support for new value
gb_vaton enumsV2.Core.Account.identity.business_details.id_numbers[].type,V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type,V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, andV2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type - Add support for error code
request_blockedonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for new resource
- #2558 Remove
qsdependency- Remove the
qsdependency, addressing Issue #2117.
- Remove the
- #2562 Document usage of undocumented API parameters
v20.2.0
- #2551 Update generated code
- Add support for event notifications
V2CoreAccountClosedEvent,V2CoreAccountCreatedEvent,V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingDefaultsUpdatedEvent,V2CoreAccountIncludingFutureRequirementsUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent,V2CoreAccountIncludingRequirementsUpdatedEvent, andV2CoreAccountUpdatedEventwith related objectV2.Core.Account - Add support for event notification
V2CoreAccountLinkReturnedEvent - Add support for event notifications
V2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectV2.Core.AccountPerson
- Add support for event notifications
v20.1.2
- #2542 Fix content length calculations for multipart file uploads. This fixes the bug reported in 2538 around file uploads.
- #2539 Delete API_VERSION file as it is no longer needed
v20.1.1
- #2535 Update qs dependency to latest version
v20.1.0
This release changes the pinned API version to 2025-12-15.clover.
- #2522 Update generated code
- Add support for new resources
V2.Core.AccountLink,V2.Core.AccountPersonToken,V2.Core.AccountPerson,V2.Core.AccountToken, andV2.Core.Account - Add support for
createandretrievemethods on resourcesV2.Core.AccountPersonTokenandV2.Core.AccountToken - Add support for
createmethod on resourceV2.Core.AccountLink - Add support for
close,create,list,retrieve, andupdatemethods on resourceV2.Core.Account - Add support for
create,del,list,retrieve, andupdatemethods on resourceV2.Core.AccountPerson - Add support for
payto_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
signeronAccountCreateParams.documents.proof_of_registration,AccountCreateParams.documents.proof_of_ultimate_beneficial_ownership,AccountUpdateParams.documents.proof_of_registration, andAccountUpdateParams.documents.proof_of_ultimate_beneficial_ownership - Add support for
customer_accountonBilling.CreditBalanceSummaryRetrieveParams,Billing.CreditBalanceSummary,Billing.CreditBalanceTransactionListParams,Billing.CreditGrantCreateParams,Billing.CreditGrantListParams,Billing.CreditGrant,BillingPortal.SessionCreateParams,BillingPortal.Session,CashBalance,Checkout.SessionCreateParams,Checkout.SessionListParams,Checkout.Session,ConfirmationToken.payment_method_preview,CreditNoteListParams,CreditNote,CustomerBalanceTransaction,CustomerCashBalanceTransaction,CustomerSessionCreateParams,CustomerSession,Customer,Discount,FinancialConnections.Account.account_holder,FinancialConnections.AccountListParams.account_holder,FinancialConnections.Session.account_holder,FinancialConnections.SessionCreateParams.account_holder,InvoiceCreateParams,InvoiceCreatePreviewParams,InvoiceItemCreateParams,InvoiceItemListParams,InvoiceItem,InvoiceListParams,Invoice,PaymentIntentCreateParams,PaymentIntentListParams,PaymentIntentUpdateParams,PaymentIntent,PaymentMethodAttachParams,PaymentMethodListParams,PaymentMethod,PromotionCodeCreateParams,PromotionCodeListParams,PromotionCode,QuoteCreateParams,QuoteListParams,QuoteUpdateParams,Quote,SetupAttempt,SetupIntentCreateParams,SetupIntentListParams,SetupIntentUpdateParams,SetupIntent,SubscriptionCreateParams,SubscriptionListParams,SubscriptionScheduleCreateParams,SubscriptionScheduleListParams,SubscriptionSchedule,Subscription,TaxId.owner,TaxIdCreateParams.owner,TaxIdListParams.owner, andTaxId - Add support for
metadataonCheckout.SessionCreateParams.line_items[]andLineItem - Change
Billing.CreditBalanceSummaryRetrieveParams.customer,Billing.CreditBalanceTransactionListParams.customer,Billing.CreditGrantCreateParams.customer,BillingPortal.SessionCreateParams.customer,CustomerSessionCreateParams.customer,InvoiceItemCreateParams.customer,PaymentMethodAttachParams.customer, andSubscriptionCreateParams.customerto be optional - Add support for
billing_cycle_anchoronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_update - Add support for
paytoonCharge.payment_method_details,Checkout.Session.payment_method_options,Checkout.SessionCreateParams.payment_method_options,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,Invoice.payment_settings.payment_method_options,InvoiceCreateParams.payment_settings.payment_method_options,InvoiceUpdateParams.payment_settings.payment_method_options,Mandate.payment_method_details,PaymentAttemptRecord.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,PaymentMethodUpdateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupAttempt.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_data,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_data,SetupIntentCreateParams.payment_method_options,SetupIntentUpdateParams.payment_method_data,SetupIntentUpdateParams.payment_method_options,Subscription.payment_settings.payment_method_options,SubscriptionCreateParams.payment_settings.payment_method_options, andSubscriptionUpdateParams.payment_settings.payment_method_options - Add support for
expected_debit_dateonCharge.payment_method_details.acss_debit,Charge.payment_method_details.au_becs_debit,Charge.payment_method_details.bacs_debit,Charge.payment_method_details.nz_bank_account,Charge.payment_method_details.sepa_debit,Charge.payment_method_details.us_bank_account,PaymentAttemptRecord.payment_method_details.acss_debit,PaymentAttemptRecord.payment_method_details.au_becs_debit,PaymentAttemptRecord.payment_method_details.bacs_debit,PaymentAttemptRecord.payment_method_details.nz_bank_account,PaymentAttemptRecord.payment_method_details.sepa_debit,PaymentAttemptRecord.payment_method_details.us_bank_account,PaymentRecord.payment_method_details.acss_debit,PaymentRecord.payment_method_details.au_becs_debit,PaymentRecord.payment_method_details.bacs_debit,PaymentRecord.payment_method_details.nz_bank_account,PaymentRecord.payment_method_details.sepa_debit, andPaymentRecord.payment_method_details.us_bank_account - Add support for new value
mollieon enumsCharge.payment_method_details.ideal.bank,ConfirmationToken.payment_method_preview.ideal.bank,ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank,PaymentAttemptRecord.payment_method_details.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,PaymentRecord.payment_method_details.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
MLLENL2Aon enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentAttemptRecord.payment_method_details.ideal.bic,PaymentMethod.ideal.bic,PaymentRecord.payment_method_details.ideal.bic, andSetupAttempt.payment_method_details.ideal.bic - Add support for new value
paytoon enumsCheckout.SessionCreateParams.excluded_payment_method_types,PaymentIntent.excluded_payment_method_types,PaymentIntentConfirmParams.excluded_payment_method_types,PaymentIntentCreateParams.excluded_payment_method_types,PaymentIntentUpdateParams.excluded_payment_method_types,SetupIntent.excluded_payment_method_types,SetupIntentCreateParams.excluded_payment_method_types, andSetupIntentUpdateParams.excluded_payment_method_types - Add support for new value
paytoon enumCheckout.SessionCreateParams.payment_method_types - Add support for
line_itemsonCheckout.SessionUpdateParams - Add support for new value
paytoon 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
paytoon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.type - Add support for new value
paytoon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for
invoiceonCustomerListCustomerBalanceTransactionsParams - Add support for
related_customer_accountonIdentity.VerificationSessionCreateParams,Identity.VerificationSessionListParams, andIdentity.VerificationSession - Change type of
InvoiceItem.pricing.price_details.priceandInvoiceLineItem.pricing.price_details.pricefromstringtoexpandable(Price) - Add support for new value
paytoon 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
subtotalonInvoiceLineItem - Add support for
authorization_code,description,iin,installments,issuer,network_advice_code,network_decline_code, andstored_credential_usageonPaymentAttemptRecord.payment_method_details.cardandPaymentRecord.payment_method_details.card - Change
PaymentIntent.transfer_datato be optional - Add support for new value
paytoon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_types - Add support for
allow_redisplayonPaymentMethodListParams - Add support for
reported_byonPaymentRecord - Change
Product.tax_codeto be optional - Add support for new values
2025-12-15.cloverand2026-01-28.cloveron enumWebhookEndpointCreateParams.api_version - Add support for
changesonV2.Core.Event - Add support for error code
account_token_required_for_v2_accountonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for new resources
v20.0.0
This release changes the pinned API version to 2025-11-17.clover.
- #2502 Update generated code
- ⚠️ Remove support for
gt,gte,lt, andlteonV2.Core.EventListParamsin favor ofcreated.
- ⚠️ Remove support for
- #2497 Update v2 array parameter serialization to use indexed format
RetrieveandListcalls for/v2endpoints now use indexed format (e.g.,?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g.,?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
- #2495 Update generated code
- Add support for new resources
Tax.AssociationandTerminal.OnboardingLink - Add support for
findmethod on resourceTax.Association - Add support for
createmethod on resourceTerminal.OnboardingLink - Add support for
payment_method_configurationonBillingPortal.Configuration.features.payment_method_update - Add support for
transaction_idonCharge.payment_method_details.ideal,PaymentAttemptRecord.payment_method_details.ideal, andPaymentRecord.payment_method_details.ideal - Add support for new value
finomon enumsCharge.payment_method_details.ideal.bank,ConfirmationToken.payment_method_preview.ideal.bank,ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank,PaymentAttemptRecord.payment_method_details.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,PaymentRecord.payment_method_details.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
FNOMNL22on enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentAttemptRecord.payment_method_details.ideal.bic,PaymentMethod.ideal.bic,PaymentRecord.payment_method_details.ideal.bic, andSetupAttempt.payment_method_details.ideal.bic - Add support for new value
tokenized_account_number_deactivatedon enumsConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reasonandPaymentMethod.us_bank_account.status_details.blocked.reason - Add support for
createdonCustomerListCustomerBalanceTransactionsParamsandInvoicePaymentListParams - Add support for new values
financial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumEvent.type - Add support for
account_numbersonFinancialConnections.Account - Change type of
FinancialConnections.Session.client_secretfromstringtostring | null - Add support for
fraud_riskonIssuing.AuthorizationCreateParams.testHelpers.risk_assessment - Add support for
latest_fraud_warningonIssuing.Card - Add support for
hooksonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentUpdateParams, andPaymentIntent - Add support for
mb_wayandtwintonRefund.destination_details - Add support for new values
financial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for snapshot events
FinancialConnectionsAccountAccountNumbersUpdatedEventandFinancialConnectionsAccountUpcomingAccountNumberExpiryEventwith resourceFinancialConnections.Account
- Add support for new resources
v19.3.1
- #2500 Use
TextEncoderinstead ofBufferto ensure support in other JS environments
v19.3.0
- #2488 Update generated code
- Add support for
capture_methodonPaymentIntent.payment_method_options.card_present,PaymentIntentConfirmParams.payment_method_options.card_present,PaymentIntentCreateParams.payment_method_options.card_present, andPaymentIntentUpdateParams.payment_method_options.card_present
- Add support for
v19.2.1
- #2492 Add support for value
payment_recordto enumInvoicePayment.payment.type - #2485 correctly calculate content-length for JSON bodies that contain unicode
v19.2.0
This release changes the pinned API version to 2025-10-29.clover.
- #2477 Update generated code
- Improve docs for PaymentIntent related endpoints
- #2469 Update generated code
- Add support for new resources
PaymentAttemptRecord,PaymentIntentAmountDetailsLineItem, andPaymentRecord - Add support for
listandretrievemethods on resourcePaymentAttemptRecord - Add support for
report_payment_attempt_canceled,report_payment_attempt_failed,report_payment_attempt_guaranteed,report_payment_attempt_informational,report_payment_attempt,report_payment,report_refund, andretrievemethods on resourcePaymentRecord - Add support for
listmethod on resourcePaymentIntentAmountDetailsLineItem - Add support for
representative_declarationonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.company - Change
Billing.CreditGrantCreateParams.categoryto be optional - Add support for
payment_method_configurationonBillingPortal.ConfigurationCreateParams.features.payment_method_updateandBillingPortal.ConfigurationUpdateParams.features.payment_method_update - Add support for new value
solanaon enumCharge.payment_method_details.crypto.network - Add support for new value
mb_wayon enumCheckout.SessionCreateParams.excluded_payment_method_types - Add support for
twintonCheckout.Session.payment_method_optionsandCheckout.SessionCreateParams.payment_method_options - Add support for new value
mb_wayon enumCheckout.SessionCreateParams.payment_method_types - Add support for new value
customon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.type - Add support for
payment_record_refundandtypeonCreditNote.refunds[],CreditNoteCreateParams.refunds[],CreditNotePreviewLinesParams.refunds[], andCreditNotePreviewParams.refunds[] - Add support for
customer_sheetandmobile_payment_elementonCustomerSession.componentsandCustomerSessionCreateParams.components - Add support for new value
customon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for
provideronCustomer.tax - Add support for new values
balance_settings.updatedandinvoice.payment_attempt_requiredon enumEvent.type - Add support for new value
platform_terms_of_serviceon enumsFile.purposeandFileListParams.purpose - Add support for new value
platform_terms_of_serviceon enumFileCreateParams.purpose - Add support for
payment_recordonInvoiceAttachPaymentParams,InvoicePayment.payment, andInvoicePaymentListParams.payment - Change type of
InvoicePaymentListParams.payment.typefromliteral('payment_intent')toenum('payment_intent'|'payment_record') - Add support for new value
customon 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
amount_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams, andPaymentIntentUpdateParams - Add support for
payment_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentUpdateParams, andPaymentIntent - Add support for
discount_amount,line_items,shipping, andtaxonPaymentIntent.amount_details - Add support for
name_collectiononPaymentLinkCreateParams,PaymentLinkUpdateParams, andPaymentLink - Add support for new value
mb_wayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_types - Add support for
cryptoonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration, andRefund.destination_details - Add support for
mb_wayonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfiguration - Add support for
customonPaymentMethodCreateParamsandPaymentMethod - Add support for
excluded_payment_method_typesonSetupIntentCreateParams,SetupIntentUpdateParams, andSetupIntent - Add support for
twonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options - Add support for
giponTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tipping - Add support for
last_seen_atonTerminal.Reader - Add support for new values
balance_settings.updatedandinvoice.payment_attempt_requiredon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events - Add support for new value
2025-10-29.cloveron enumWebhookEndpointCreateParams.api_version - Add support for
gt,gte,lt,lte, andtypesonV2.Core.EventListParams - Change
V2.Core.EventListParams.object_idto be optional - Add support for snapshot event
BalanceSettingsUpdatedEventwith resourceBalanceSettings - Add support for snapshot event
InvoicePaymentAttemptRequiredEventwith resourceInvoice - Add support for error code
payment_intent_rate_limit_exceededonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- Add support for new resources
v19.1.0
#2453 add missing fetchEvent type for UnknownEventNotification
- Add missing
fetchEvent()declaration to theStripe.Events.UnknownEventNotificationinterface - Tweak
Stripe.Events.fetchRelatedObjectso that it's always defined and returnsnullif there's norelated_object. This fixes the situation where theUnknownEventNotificationsays thatfetchRelatedObject()is defined, but calling it throws an error.
- Add missing
#2447 Update param in deprecation docs link
#2444 Update CHANGELOG.md to point to right API version
v19.0.0
This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)
#2427 Move
V2.EventAPI resources toV2.Core.Events- ⚠️ Move the below event related interfaces and types from
Stripe.V2toStripe.V2.Core. This enables us to correctly match the API path to the namespaceStripe.V2.EventDestination->Stripe.V2.Core.EventDestinationStripe.V2.Event->Stripe.V2.Core.EventStripe.V2.EventBase->Stripe.V2.Core.EventBaseStripe.V2.Events.RelatedObject->Stripe.V2.Core.Events.RelatedObject
- ⚠️ Move the below event related interfaces and types from
#2370 Add strongly typed EventNotifications We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
- ⚠️ Rename function
StripeClient.parseThinEventtoStripeClient.parseEventNotificationand remove theStripe.ThinEventinterface.- This function now returns a
Stripe.V2.EventNotificationwhich is a union of all possible event notifications instead ofStripe.ThinEvent. When applicable, these event notifications will have therelatedObjectfield and a functionfetchRelatedObject(). They also have afetchEvent()method to retrieve their corresponding event. - If this union type does not cover a new event notification that you parsed, you can cast it to
UnknownEventNotificationto then access therelatedObjectfield and the functionfetchRelatedObject()
- This function now returns a
- ⚠️ Rename function
#2432 Drop support for Node < 16 & clarify policy
- Publish our new language version support policy and add a link to the README.
- ⚠️ Drop support for Node versions < 16
- Node 16 support is deprecated and will be removed in the next scheduled major release (March 2026)
#2426 Add
StripeContextobject- Add the
StripeContextclass. It can be used anywhere the context option is supplied and gets serialized to a string when making requests. - ⚠️ Change
EventNotification(formerly known asThinEvent)'scontextproperty fromstringtoStripeContext - ⚠️ We no longer remove the stripe-context header from /v1 requests and the stripe-account header from /v2 requests. The server may reject a request with both of these headers, so if you're sending both, remove any reference to stripeAccount (since the headers are identical, but context is preferred)
- Add the
#2398 ⚠️ Build SDK w/ V2 OpenAPI spec
- ⚠️ The delete methods for v2 APIs (the ones in the
StripeClient.v2namespace) now return aV2DeletedObjectwhich has the id of the object that has been deleted and a string representing the type of the object that has been deleted. - ⚠️ Change the types of nullable properties in objects returned by v2 APIs (the ones in the
StripeClient.v2namespace) from a null union to optional (e.g.prop: string | null->prop?: string).
- ⚠️ The delete methods for v2 APIs (the ones in the
#2420 Fixed file uploading in Bun runtimes
- Fixed issue (#2416) with file uploads in runtimes using
FetchHttpClient(e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.
- Fixed issue (#2416) with file uploads in runtimes using
#2405 support more npm tags
- ⚠️ Starting with this release, we'll no longer be tagging releases with
betanpm tag. Instead, we'll uselatest,public-preview, orprivate-previewto more closely align with Stripe's release phases
- ⚠️ Starting with this release, we'll no longer be tagging releases with
#2402, #2413, #2430, #2428 Update generated code based on incoming API changes in the
2025-09-30.cloverAPI version.- ⚠️ Remove support for
balance_reportandpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.components - ⚠️ Remove support for values
saturdayandsundayfrom enumsAccount.settings.payouts.schedule.weekly_payout_days,AccountCreateParams.settings.payouts.schedule.weekly_payout_days, andAccountUpdateParams.settings.payouts.schedule.weekly_payout_days- Add support for new values
external_requestandunsupported_business_typeon 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 - Remove support for
linkandpay_by_bankonPaymentMethodUpdateParams
- Add support for new values
- ⚠️ Remove support for
coupononDiscount,PromotionCodeCreateParams, andPromotionCode. UseDiscount.source.coupon,PromotionCodeCreateParams.promotion.couponandPromotionCode.couponinstead. - Change
Invoice.idto be required. - Add support for new value
preventedon enumDispute.status - Add support for new resource
BalanceSettings - Add support for
retrieveandupdatemethods on resourceBalanceSettings - Add support for
mb_way_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
sourceonDiscount - Add support for
trial_update_behavioronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_update - Add support for
mb_wayonCharge.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 - Add support for
branding_settingsandname_collectiononCheckout.SessionCreateParamsandCheckout.Session - Add support for
excluded_payment_method_typesonCheckout.SessionCreateParams,Checkout.Session,PaymentIntentConfirmParams, andPaymentIntentUpdateParams - Add support for
unit_labelonCheckout.SessionCreateParams.line_items[].price_data.product_data,InvoiceAddLinesParams.lines[].price_data.product_data,InvoiceLineItemUpdateParams.price_data.product_data,InvoiceUpdateLinesParams.lines[].price_data.product_data, andPaymentLinkCreateParams.line_items[].price_data.product_data - Add support for
alma,billie, andsatispayonCheckout.Session.payment_method_optionsandCheckout.SessionCreateParams.payment_method_options - Add support for
demo_payonCheckout.SessionCreateParams.payment_method_options - Add support for
capture_methodonCheckout.Session.payment_method_options.affirm,Checkout.Session.payment_method_options.afterpay_clearpay,Checkout.Session.payment_method_options.amazon_pay,Checkout.Session.payment_method_options.card,Checkout.Session.payment_method_options.cashapp,Checkout.Session.payment_method_options.klarna,Checkout.Session.payment_method_options.link,Checkout.Session.payment_method_options.mobilepay,Checkout.Session.payment_method_options.revolut_pay,Checkout.SessionCreateParams.payment_method_options.affirm,Checkout.SessionCreateParams.payment_method_options.afterpay_clearpay,Checkout.SessionCreateParams.payment_method_options.amazon_pay,Checkout.SessionCreateParams.payment_method_options.card,Checkout.SessionCreateParams.payment_method_options.cashapp,Checkout.SessionCreateParams.payment_method_options.klarna,Checkout.SessionCreateParams.payment_method_options.link,Checkout.SessionCreateParams.payment_method_options.mobilepay, andCheckout.SessionCreateParams.payment_method_options.revolut_pay - Add support for
flexibleonCheckout.SessionCreateParams.subscription_data.billing_mode,InvoiceCreatePreviewParams.schedule_details.billing_mode,InvoiceCreatePreviewParams.subscription_details.billing_mode,Quote.subscription_data.billing_mode,QuoteCreateParams.subscription_data.billing_mode,Subscription.billing_mode,SubscriptionCreateParams.billing_mode,SubscriptionMigrateParams.billing_mode,SubscriptionSchedule.billing_mode, andSubscriptionScheduleCreateParams.billing_mode - Add support for
business_nameandindividual_nameonCheckout.Session.collected_information,Checkout.Session.customer_details,CustomerCreateParams,CustomerUpdateParams, andCustomer - Add support for new values
mb_wayon 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 values
mb_wayon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.type - Add support for new values
mb_wayon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for
chargeback_loss_reason_codeonDispute.payment_method_details.klarna - Add support for
net_amountandproration_detailsonInvoiceItem - Remove support for
iterationsonInvoiceCreatePreviewParams.schedule_details.phases[],SubscriptionScheduleCreateParams.phases[], andSubscriptionScheduleUpdateParams.phases[] - Add support for
fraud_disputability_likelihoodandrisk_assessmentonIssuing.AuthorizationCreateParams.testHelpers - Add support for
second_lineonIssuing.Card - Add support for new values
mb_wayon enumsPaymentIntent.excluded_payment_method_typesandPaymentIntentCreateParams.excluded_payment_method_types - Add support for
fr_meal_voucher_conecsonPaymentMethodConfigurationCreateParamsandPaymentMethodConfigurationUpdateParams - Add support for
promotiononPromotionCodeCreateParamsandPromotionCode - Add support for new values
acknowledgedandpayment_never_settledon enumReview.closed_reason - Add support for
provideronTax.Settings.defaults - Add support for
bbpos_wisepad3onTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configuration - Add support for
address_kana,address_kanji,display_name_kana,display_name_kanji, andphoneonTerminal.LocationCreateParams,Terminal.LocationUpdateParams, andTerminal.Location - Change
Terminal.LocationCreateParams.addressto be optional - Change
Terminal.LocationCreateParams.display_nameto be optional - Add support for new value
2025-09-30.cloveron enumWebhookEndpointCreateParams.api_version - Add support for error codes
financial_connections_account_pending_account_numbersandfinancial_connections_account_unavailable_account_numbersonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeError
- ⚠️ Remove support for
v18.5.0
This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)
#2427 Move
V2.EventAPI resources toV2.Core.Events- ⚠️ Move the below event related interfaces and types from
Stripe.V2toStripe.V2.Core. This enables us to correctly match the API path to the namespaceStripe.V2.EventDestination->Stripe.V2.Core.EventDestinationStripe.V2.Event->Stripe.V2.Core.EventStripe.V2.EventBase->Stripe.V2.Core.EventBaseStripe.V2.Events.RelatedObject->Stripe.V2.Core.Events.RelatedObject
- ⚠️ Move the below event related interfaces and types from
#2370 Add strongly typed EventNotifications We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
- ⚠️ Rename function
StripeClient.parseThinEventtoStripeClient.parseEventNotificationand remove theStripe.ThinEventinterface.- This function now returns a
Stripe.V2.EventNotificationwhich is a union of all possible event notifications instead ofStripe.ThinEvent. When applicable, these event notifications will have therelatedObjectfield and a functionfetchRelatedObject(). They also have afetchEvent()method to retrieve their corresponding event. - If this union type does not cover a new event notification that you parsed, you can cast it to
UnknownEventNotificationto then access therelatedObjectfield and the functionfetchRelatedObject()
- This function now returns a
- ⚠️ Rename function
#2432 Drop support for Node < 16 & clarify policy
- Publish our new language version support policy and add a link to the README.
- ⚠️ Drop support for Node versions < 16
- Node 16 support is deprecated and will be removed in the next scheduled major release (March 2026)
#2426 Add
StripeContextobject- Add the
StripeContextclass. It can be used anywhere the context option is supplied and gets serialized to a string when making requests. - ⚠️ Change
EventNotification(formerly known asThinEvent)'scontextproperty fromstringtoStripeContext - ⚠️ We no longer remove the stripe-context header from /v1 requests and the stripe-account header from /v2 requests. The server may reject a request with both of these headers, so if you're sending both, remove any reference to stripeAccount (since the headers are identical, but context is preferred)
- Add the
#2398 ⚠️ Build SDK w/ V2 OpenAPI spec
- ⚠️ The delete methods for v2 APIs (the ones in the
StripeClient.v2namespace) now return aV2DeletedObjectwhich has the id of the object that has been deleted and a string representing the type of the object that has been deleted. - ⚠️ Change the types of nullable properties in objects returned by v2 APIs (the ones in the
StripeClient.v2namespace) from a null union to optional (e.g.prop: string | null->prop?: string).
- ⚠️ The delete methods for v2 APIs (the ones in the
#2420 Fixed file uploading in Bun runtimes
- Fixed issue (#2416) with file uploads in runtimes using
FetchHttpClient(e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.
- Fixed issue (#2416) with file uploads in runtimes using
#2405 support more npm tags
- ⚠️ Starting with this release, we'll no longer be tagging releases with
betanpm tag. Instead, we'll uselatest,public-preview, orprivate-previewto more closely align with Stripe's release phases
- ⚠️ Starting with this release, we'll no longer be tagging releases with
#2402, #2413, #2430, #2428 Update generated code based on incoming API changes in the
2025-09-30.cloverAPI version.- ⚠️ Remove support for
balance_reportandpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.components - ⚠️ Remove support for values
saturdayandsundayfrom enumsAccount.settings.payouts.schedule.weekly_payout_days,AccountCreateParams.settings.payouts.schedule.weekly_payout_days, andAccountUpdateParams.settings.payouts.schedule.weekly_payout_days- Add support for new values
external_requestandunsupported_business_typeon 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 - Remove support for
linkandpay_by_bankonPaymentMethodUpdateParams
- Add support for new values
- ⚠️ Remove support for
coupononDiscount,PromotionCodeCreateParams, andPromotionCode. UseDiscount.source.coupon,PromotionCodeCreateParams.promotion.couponandPromotionCode.couponinstead. - Change
Invoice.idto be required. - Add support for new value
preventedon enumDispute.status - Add support for new resource
BalanceSettings - Add support for
retrieveandupdatemethods on resourceBalanceSettings - Add support for
mb_way_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
sourceonDiscount - Add support for
trial_update_behavioronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_update - Add support for
mb_wayonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,PaymentIntent.payment_method_options
- ⚠️ Remove support for
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.