NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4265 most downloaded on npm
Stripe API wrapper
Last release 4 days ago
01 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
15 years old
805 releases · first in 2011
Change Account.controller.type to be required
Change type of UsageRecordCreateParams.timestamp from integer to literal('now') | integer
UsageRecordCreateParams.timestamp from integer to literal('now') | integerUsageRecordCreateParams.timestamp to be optionalOne column per quarter.
Change Charge.payment_method_details.klarna.payment_method_category, Charge.payment_method_details.klarna.preferred_locale, Checkout.Session.customer_
Charge.payment_method_details.klarna.payment_method_category, Charge.payment_method_details.klarna.preferred_locale, Checkout.Session.customer_details.phone, and PaymentMethod.klarna.dob to be requiredklarna on enum Checkout.SessionCreateParams.payment_method_types[]Add support for payment_method_category and preferred_locale on Charge.payment_method_details.klarna
payment_method_category and preferred_locale on Charge.payment_method_details.klarnaklarna on enums CustomerListPaymentMethodsParams.type and PaymentMethodListParams.typeklarna on PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntent.payment_method_options, PaymentMethodCreateParams, and PaymentMethodklarna on enums PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, and PaymentIntentConfirmParams.payment_method_data.typeklarna on enum PaymentMethodCreateParams.typeklarna on enum PaymentMethod.typeAdd support for list_payment_methods method on resource Customer
list_payment_methods method on resource CustomerAdd support for phone_number_collection on Checkout.SessionCreateParams and Checkout.Session
phone_number_collection on Checkout.SessionCreateParams and Checkout.Sessionphone on Checkout.Session.customer_detailsPaymentMethodListParams.customer to be optionalcustomer_id on enums Radar.ValueListCreateParams.item_type and Radar.ValueList.item_typebbpos_wisepos_e on enums Terminal.ReaderListParams.device_type and Terminal.Reader.device_typeAdd support for klarna_payments on AccountUpdateParams.capabilities, AccountCreateParams.capabilities, and Account.capabilities
klarna_payments on AccountUpdateParams.capabilities, AccountCreateParams.capabilities, and Account.capabilitiesAdd support for amount_authorized and overcapture_supported on Charge.payment_method_details.card_present
Add support for full_name_aliases on AccountUpdateParams.individual, AccountCreateParams.individual, PersonCreateParams, PersonUpdateParams, Person, T
Change Account.future_requirements.alternatives, Account.requirements.alternatives, Capability.future_requirements.alternatives, Capability.requiremen
Account.future_requirements.alternatives, Account.requirements.alternatives, Capability.future_requirements.alternatives, Capability.requirements.alternatives, Checkout.Session.after_expiration, Checkout.Session.consent, Checkout.Session.consent_collection, Checkout.Session.expires_at, Checkout.Session.recovered_from, Person.future_requirements.alternatives, and Person.requirements.alternatives to be requiredCapability.future_requirements.alternatives, Capability.requirements.alternatives, Person.future_requirements.alternatives, and Person.requirements.alternatives from array(AccountRequirementsAlternative) to nullable(array(AccountRequirementsAlternative))rst on enums TaxRateCreateParams.tax_type, TaxRateUpdateParams.tax_type, and TaxRate.tax_typecheckout.session.expired on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]BillingPortal.Configuration.features.subscription_cancel.cancellation_reason to be requireddefault_for on Checkout.SessionCreateParams.payment_method_options.acss_debit.mandate_options, Checkout.Session.payment_method_options.acss_debit.mandate_options, Mandate.payment_method_details.acss_debit, SetupIntentCreateParams.payment_method_options.acss_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.acss_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.acss_debit.mandate_options, and SetupIntent.payment_method_options.acss_debit.mandate_optionsacss_debit on InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Invoice.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, SubscriptionUpdateParams.payment_settings.payment_method_options, and Subscription.payment_settings.payment_method_optionsacss_debit on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Invoice.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], SubscriptionUpdateParams.payment_settings.payment_method_types[], and Subscription.payment_settings.payment_method_types[]livemode on Reporting.ReportTypeAdd support for future_requirements on Account, Capability, and Person
future_requirements on Account, Capability, and Personalternatives on Account.requirements, Capability.requirements, and Person.requirementsAdd support for after_expiration, consent_collection, and expires_at on Checkout.SessionCreateParams and Checkout.Session
* #1198 Add support for paginting SearchResult objects.
Add support for cancellation_reason on BillingPortal.ConfigurationCreateParams.features.subscription_cancel, BillingPortal.ConfigurationUpdateParams.f
cancellation_reason on BillingPortal.ConfigurationCreateParams.features.subscription_cancel, BillingPortal.ConfigurationUpdateParams.features.subscription_cancel, and BillingPortal.Configuration.features.subscription_cancelAdd support for new value fil on enums Checkout.SessionCreateParams.locale and Checkout.Session.locale
fil on enums Checkout.SessionCreateParams.locale and Checkout.Session.localeau_arn on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, and TaxId.typeau_arn on enums CustomerCreateParams.tax_id_data[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typeAdd support for locale on BillingPortal.SessionCreateParams and BillingPortal.Session
locale on BillingPortal.SessionCreateParams and BillingPortal.SessionInvoice.collection_method and Subscription.collection_method from nullable(enum('charge_automatically'|'send_invoice')) to enum('charge_automatically'|'send_invoice')Change type of PaymentIntentCreateParams.payment_method_options.sofort.preferred_language, PaymentIntentUpdateParams.payment_method_options.sofort.pre
PaymentIntentCreateParams.payment_method_options.sofort.preferred_language, PaymentIntentUpdateParams.payment_method_options.sofort.preferred_language, and PaymentIntentConfirmParams.payment_method_options.sofort.preferred_language from enum to emptyStringable(enum)Price.tax_behavior, Product.tax_code, Quote.automatic_tax, and TaxRate.tax_type to be required* #1200 Add support for fullPath on method specs * #1199 Explicitly define basic method specs * #1206 Fix Typescript definition for StripeResource.Las
Bugfix: add missing autopagination methods to Quote.listLineItems and Quote.listComputedUpfrontLineItems
Quote.listLineItems and Quote.listComputedUpfrontLineItemsaccount_type on BankAccount, ExternalAccountUpdateParams, and TokenCreateParams.bank_accountcategory_code on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_dataredacted on enum Review.closed_reasonAccount.retrieve.attributes fields mistakenly defined as Stripe.MetadataAdd support for new values hr, ko, and vi on enums Checkout.SessionCreateParams.locale and Checkout.Session.locale
hr, ko, and vi on enums Checkout.SessionCreateParams.locale and Checkout.Session.localepayment_settings on SubscriptionCreateParams, SubscriptionUpdateParams, and SubscriptionRemove support for values api_connection_error, authentication_error, and rate_limit_error from enums StripeError.type, StripeErrorResponse.error.type
api_connection_error, authentication_error, and rate_limit_error from enums StripeError.type, StripeErrorResponse.error.type, Invoice.last_finalization_error.type, PaymentIntent.last_payment_error.type, SetupAttempt.setup_error.type, and SetupIntent.last_setup_error.typewallet on Issuing.Transactionideal on PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_options, PaymentIntentConfirmParams.payment_method_options, and PaymentIntent.payment_method_options* #1102 , #1191 Add support for stripeAccount when initializing the client
Add support for quote.accepted, quote.canceled, quote.created, and quote.finalized events.
Add support for new resource Quote
Quotequote on Invoicequote_accept on enum Invoice.billing_reasonCharge.payment_method_details.card.three_d_secure.result, SetupAttempt.payment_method_details.card.three_d_secure.result, Charge.payment_method_details.card.three_d_secure.version, and SetupAttempt.payment_method_details.card.three_d_secure.version to be nullable.Add support for new value boleto on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_me
boleto on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], and Invoice.payment_settings.payment_method_types[].Add support for wechat_pay on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, PaymentIntentCreateParams.payment_me
wechat_pay on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntent.payment_method_options, PaymentMethodCreateParams, and PaymentMethodwechat_pay on enums Checkout.SessionCreateParams.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Invoice.payment_settings.payment_method_types[], PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentMethodCreateParams.type, PaymentMethodListParams.type, and PaymentMethod.typewechat_pay_display_qr_code, wechat_pay_redirect_to_android_app, and wechat_pay_redirect_to_ios_app on PaymentIntent.next_actionAdded support for boleto_payments on Account.capabilities
boleto_payments on Account.capabilitiesboleto and oxxo on Checkout.SessionCreateParams.payment_method_options and Checkout.Session.payment_method_optionsboleto and oxxo as members of the type enum inside Checkout.SessionCreateParams.payment_method_types[].Added support for boleto on PaymentMethodCreateParams, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, Paymen
boleto on PaymentMethodCreateParams, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, Charge.payment_method_details and PaymentMethodPaymentMethodListParams.type, PaymentMethodCreateParams.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, PaymentIntentCreataParams.payment_method_data.type and PaymentMethod.type added new enum members: boletoboleto_display_details on PaymentIntent.next_actionTaxIdCreateParams.type, Invoice.customer_tax_ids[].type, InvoiceLineItemListUpcomingParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, CustomerCreateParams.tax_id_data[].type, Checkout.Session.customer_details.tax_ids[].type and TaxId.type added new enum members: il_vat.Add support for new TaxId types: ca_pst_mb, ca_pst_bc, ca_gst_hst, and ca_pst_sk.
ca_pst_mb, ca_pst_bc, ca_gst_hst, and ca_pst_sk.Add support for url on Checkout Session.
url on Checkout Session.Update Terminal.Reader.location to be expandable (TypeScript breaking change)
tax_id_collection on Checkout Session.tax_id_collection and SessionCreateParamsTerminal.Reader.location to be expandable (TypeScript breaking change)Add support for controller on Account.
controller on Account.Add support for new resource TaxCode.
TaxCode.tax_code on Product, ProductCreateParams, ProductUpdateParams, PriceCreateParams.product_data, PlanCreateParams.product, and Checkout SessionCreateParams.line_items[].price_data.product_data.tax to Customer, CustomerCreateParams, CustomerUpdateParams.default_settings[automatic_tax] and phases[].automatic_tax on SubscriptionSchedule, SubscriptionScheduleCreateParams, and SubscriptionScheduleUpdateParams.automatic_tax on Subscription, SubscriptionCreateParams, SubscriptionUpdateParams; Invoice, InvoiceCreateParams, InvoiceRetrieveUpcomingParams and InvoiceLineItemListUpcomingParams; Checkout Session and Checkout SessionCreateParams.tax_behavior to Price, PriceCreateParams, PriceUpdateParams and to the many Param objects that contain price_data:
SubscriptionScheduleCreateParams and SubscriptionScheduleUpdateParams, beneath phases[].add_invoice_items[] and phases[].items[]SubscriptionItemCreateParams and SubscriptionItemUpdateParams, on the top-levelSubscriptionCreateParams create and UpdateCreateParams, beneath items[] and add_invoice_items[]InvoiceItemCreateParams and InvoiceItemUpdateParams, on the top-levelInvoiceRetrieveUpcomingParams and InvoiceLineItemListUpcomingParams beneath subscription_items[] and invoice_items[].SessionCreateParams, beneath line_items[].customer_update to Checkout SessionCreateParams.customer_details to InvoiceRetrieveUpcomingParams and InvoiceLineItemListUpcomingParams.tax_type to TaxRate, TaxRateCreateParams, and TaxRateUpdateParams.Added support for llc, free_zone_llc, free_zone_establishment and sole_establishment to the structure enum on Account.company, AccountCreateParams.com
llc, free_zone_llc, free_zone_establishment and sole_establishment to the structure enum on Account.company, AccountCreateParams.company, AccountUpdateParams.company and TokenCreateParams.account.company.Added support for documents on PersonUpdateParams, PersonCreateParams and TokenCreateParams.person
documents on PersonUpdateParams, PersonCreateParams and TokenCreateParams.personAccountUpdateParams.business_profile.support_url and AccountCreatParams.business_profile.support_url changed from string to Stripe.Emptyable
AccountUpdateParams.business_profile.support_url and AccountCreatParams.business_profile.support_url changed from string to Stripe.Emptyable<string>File.purpose added new enum members: finance_report_run, document_provider_identity_document, and sigma_scheduled_queryCouponCreateParams.duration and CouponCreateParams.products to be optional.Added support for reference on Charge.payment_method_details.afterpay_clearpay
reference on Charge.payment_method_details.afterpay_clearpayafterpay_clearpay on PaymentIntent.payment_method_options.Add support for payment_intent on Radar.EarlyFraudWarning
payment_intent on Radar.EarlyFraudWarningAdd support for card_present on PaymentIntent#confirm.payment_method_options, PaymentIntent#update.payment_method_options, PaymentIntent#create.paymen
card_present on PaymentIntent#confirm.payment_method_options, PaymentIntent#update.payment_method_options, PaymentIntent#create.payment_method_options and PaymentIntent.payment_method_optionsSubscriptionItem#create.payment_behavior, Subscription#update.payment_behavior, Subscription#create.payment_behavior and SubscriptionItem#update.payment_behavior added new enum members: default_incompleteAdd support for single_member_llc as an enum member of Account.company.structure and TokenCreateParams.account.company.structure added new enum member
AccountCreateParams.external_accountsingle_member_llc as an enum member of Account.company.structure and TokenCreateParams.account.company.structure added new enum members:dhl and royal_mail as enum members of Issuing.Card.shipping.carrier.Add support for currency on Checkout.Session.PaymentMethodOptions.AcssDebit
currency on Checkout.Session.PaymentMethodOptions.AcssDebitAdd support for acss_debit_payments on Account.capabilities
acss_debit_payments on Account.capabilitiespayment_method_options on Checkout.Sessionacss_debit on SetupIntent.payment_method_options, SetupAttempt.payment_method_details, PaymentMethod, PaymentIntent.payment_method_options, PaymentIntentUpdateParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, Mandate.payment_method_details and SetupIntent.payment_method_optionsverify_with_microdeposits on PaymentIntent.next_action and SetupIntent.next_actionacss_debit as member of the type enum on PaymentMethod and PaymentIntent, and inside Checkout.SessionCreateParams.payment_method_types[].Add support for subscription_pause on BillingPortal.ConfigurationUpdateParams.features, BillingPortal.ConfigurationCreateParams.features and BillingPo
subscription_pause on BillingPortal.ConfigurationUpdateParams.features, BillingPortal.ConfigurationCreateParams.features and BillingPortal.Configuration.featuresAdd support for transfer_data on SessionCreateParams.subscription_data
Capability.requirements.errors[].code, Account.requirements.errors[].code and Person.requirements.errors[].code added new enum members: verification_m
Capability.requirements.errors[].code, Account.requirements.errors[].code and Person.requirements.errors[].code added new enum members: verification_missing_owners, verification_missing_executives and verification_requires_additional_memorandum_of_associationsSessionCreateParams.locale and Checkout.Session.locale added new enum members: thAdded support for shipping_rates on SessionCreateOptions
Added support for BillingPortal.Configuration API.
BillingPortal.Configuration API.Terminal.LocationUpdateParams.country is now optional.Add support for on_behalf_of to Invoice
Add support for afterpay_clearpay on PaymentMethod, PaymentIntent.payment_method_data, and Charge.payment_method_details.
afterpay_clearpay on PaymentMethod, PaymentIntent.payment_method_data, and Charge.payment_method_details.afterpay_clearpay as a payment method type on PaymentMethod, PaymentIntent and Checkout.Sessionadjustable_quantity on SessionCreateParams.LineItembacs_debit, au_becs_debit and sepa_debit on SetupAttempt.payment_method_detailsAdd support for afterpay_clearpay_payments on Account.capabilities
afterpay_clearpay_payments on Account.capabilitiespayment_settings on InvoiceLineItem.amount_subtotal and LineItem.amount_total changed from nullable(integer) to integer
LineItem.amount_subtotal and LineItem.amount_total changed from nullable(integer) to integerEphemeralKeys.createAdded support for nationality on Person, PersonUpdateParams, PersonCreateParams and TokenCreateParams.person
nationality on Person, PersonUpdateParams, PersonCreateParams and TokenCreateParams.persongb_vat to TaxId.type enum.Issuing.Transaction.type dropped enum members: 'dispute'
Issuing.Transaction.type dropped enum members: 'dispute'LineItem.price can now be null.* #1104 Make request timeout errors eligible for retry
Added support for dynamic_tax_rates on Checkout.SessionCreateParams.line_items
dynamic_tax_rates on Checkout.SessionCreateParams.line_itemscustomer_details on Checkout.Sessiontype on Issuing.TransactionListParamscountry and state on TaxRateUpdateParams, TaxRateCreateParams and TaxRateAdded support for company_registration_verification, company_ministerial_decree, company_memorandum_of_association, company_license and company_tax_id
company_registration_verification, company_ministerial_decree, company_memorandum_of_association, company_license and company_tax_id_verification on AccountUpdateParams.documents and AccountCreateParams.documentsAdded support for card_present on SetupAttempt.payment_method_details
Prefix deleted references with Stripe. for consistency.
Stripe. for consistency.bank on PaymentMethod[eps].tos_shown_and_accepted to payment_method_options[p24] on PaymentMethod.* #1080 fixed promises example * #1084 Add support for documents on Account create and update
Add support for account_tax_ids on Invoice
account_tax_ids on Invoicepayment_method_options[sepa_debit] on PaymentIntentYour coding agent can read these notes before it upgrades. Set up the MCP server →