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 6 days ago
23 Sep 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
802 releases · first in 2011
Add support for create_preview method on resource Invoice
create_preview method on resource Invoicecharged_off_at on Capital.FinancingOfferCheckout.Session.automatic_tax.liability, Checkout.Session.invoice_creation.invoice_data.issuer, PaymentLink.automatic_tax.liability, PaymentLink.invoice_creation.invoice_data.issuer, PaymentLink.subscription_data.invoice_settings.issuer, PaymentLink.subscription_data.invoice_settings, Quote.automatic_tax.liability, Quote.invoice_settings.issuer, SubscriptionSchedule.default_settings.automatic_tax.liability, SubscriptionSchedule.default_settings.invoice_settings.issuer, SubscriptionSchedule.phases[].automatic_tax.liability, and SubscriptionSchedule.phases[].invoice_settings.issuer to be requireddisabled and enabled on enums CustomerSession.components.payment_element.features.payment_method_remove, CustomerSession.components.payment_element.features.payment_method_save, CustomerSession.components.payment_element.features.payment_method_set_as_default, CustomerSession.components.payment_element.features.payment_method_update, CustomerSessionCreateParams.components.payment_element.features.payment_method_remove, CustomerSessionCreateParams.components.payment_element.features.payment_method_save, CustomerSessionCreateParams.components.payment_element.features.payment_method_set_as_default, and CustomerSessionCreateParams.components.payment_element.features.payment_method_updateauto and never from enums CustomerSession.components.payment_element.features.payment_method_remove, CustomerSession.components.payment_element.features.payment_method_save, CustomerSession.components.payment_element.features.payment_method_set_as_default, CustomerSession.components.payment_element.features.payment_method_update, CustomerSessionCreateParams.components.payment_element.features.payment_method_remove, CustomerSessionCreateParams.components.payment_element.features.payment_method_save, CustomerSessionCreateParams.components.payment_element.features.payment_method_set_as_default, and CustomerSessionCreateParams.components.payment_element.features.payment_method_updateenhanced_evidence on Dispute.evidence and DisputeUpdateParams.evidenceenhanced_eligibility_types on Disputeenhanced_eligibility on Dispute.evidence_detailspromotion_code on InvoiceUpcomingLinesParams.schedule_details.amendments[].discount_actions[].add, InvoiceUpcomingLinesParams.schedule_details.amendments[].discount_actions[].remove, InvoiceUpcomingLinesParams.schedule_details.amendments[].discount_actions[].set, InvoiceUpcomingLinesParams.schedule_details.amendments[].item_actions[].add.discounts[], InvoiceUpcomingLinesParams.schedule_details.amendments[].item_actions[].set.discounts[], InvoiceUpcomingLinesParams.schedule_details.phases[].add_invoice_items[].discounts[], InvoiceUpcomingLinesParams.schedule_details.phases[].discounts[], InvoiceUpcomingLinesParams.schedule_details.phases[].items[].discounts[], InvoiceUpcomingLinesParams.subscription_details.items[].discounts[], InvoiceUpcomingLinesParams.subscription_items[].discounts[], InvoiceUpcomingParams.schedule_details.amendments[].discount_actions[].add, InvoiceUpcomingParams.schedule_details.amendments[].discount_actions[].remove, InvoiceUpcomingParams.schedule_details.amendments[].discount_actions[].set, InvoiceUpcomingParams.schedule_details.amendments[].item_actions[].add.discounts[], InvoiceUpcomingParams.schedule_details.amendments[].item_actions[].set.discounts[], InvoiceUpcomingParams.schedule_details.phases[].add_invoice_items[].discounts[], InvoiceUpcomingParams.schedule_details.phases[].discounts[], InvoiceUpcomingParams.schedule_details.phases[].items[].discounts[], InvoiceUpcomingParams.subscription_details.items[].discounts[], InvoiceUpcomingParams.subscription_items[].discounts[], QuoteCreateParams.lines[].actions[].add_item.discounts[], QuoteCreateParams.lines[].actions[].remove_discount, QuoteCreateParams.lines[].actions[].set_discounts[], QuoteCreateParams.lines[].actions[].set_items[].discounts[], QuoteCreateParams.phases[].discounts[], QuoteLine.actions[].add_discount, QuoteLine.actions[].add_item.discounts[], QuoteLine.actions[].remove_discount, QuoteLine.actions[].set_discounts[], QuoteLine.actions[].set_items[].discounts[], QuoteUpdateParams.lines[].actions[].add_item.discounts[], QuoteUpdateParams.lines[].actions[].remove_discount, QuoteUpdateParams.lines[].actions[].set_discounts[], QuoteUpdateParams.lines[].actions[].set_items[].discounts[], QuoteUpdateParams.phases[].discounts[], SubscriptionCreateParams.add_invoice_items[].discounts[], SubscriptionCreateParams.discounts[], SubscriptionCreateParams.items[].discounts[], SubscriptionItemCreateParams.discounts[], SubscriptionItemUpdateParams.discounts[], SubscriptionSchedule.phases[].add_invoice_items[].discounts[], SubscriptionSchedule.phases[].discounts[], SubscriptionSchedule.phases[].items[].discounts[], SubscriptionScheduleAmendParams.amendments[].discount_actions[].add, SubscriptionScheduleAmendParams.amendments[].discount_actions[].remove, SubscriptionScheduleAmendParams.amendments[].discount_actions[].set, SubscriptionScheduleAmendParams.amendments[].item_actions[].add.discounts[], SubscriptionScheduleAmendParams.amendments[].item_actions[].set.discounts[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[].discounts[], SubscriptionScheduleCreateParams.phases[].discounts[], SubscriptionScheduleCreateParams.phases[].items[].discounts[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[].discounts[], SubscriptionScheduleUpdateParams.phases[].discounts[], SubscriptionScheduleUpdateParams.phases[].items[].discounts[], SubscriptionUpdateParams.add_invoice_items[].discounts[], SubscriptionUpdateParams.discounts[], and SubscriptionUpdateParams.items[].discounts[]nn on enum ConfirmationToken.payment_method_preview.ideal.bankNNBANL2G on enum ConfirmationToken.payment_method_preview.ideal.bicInvoice.automatic_tax.liability, Invoice.issuer, and Subscription.automatic_tax.liability to be requiredraw_request usageOne column per quarter.
Add support for annual_revenue and estimated_worker_count on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.b
annual_revenue and estimated_worker_count on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profileregistered_charity on enums Account.company.structure, AccountCreateParams.company.structure, AccountUpdateParams.company.structure, and TokenCreateParams.account.company.structurecollection_options on AccountLinkCreateParamsliability on Checkout.Session.automatic_tax, Checkout.SessionCreateParams.automatic_tax, PaymentLink.automatic_tax, PaymentLinkCreateParams.automatic_tax, PaymentLinkUpdateParams.automatic_tax, Quote.automatic_tax, QuoteCreateParams.automatic_tax, QuoteUpdateParams.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, SubscriptionSchedule.phases[].automatic_tax, SubscriptionScheduleCreateParams.default_settings.automatic_tax, SubscriptionScheduleCreateParams.phases[].automatic_tax, SubscriptionScheduleUpdateParams.default_settings.automatic_tax, and SubscriptionScheduleUpdateParams.phases[].automatic_taxissuer on Checkout.Session.invoice_creation.invoice_data, Checkout.SessionCreateParams.invoice_creation.invoice_data, PaymentLink.invoice_creation.invoice_data, PaymentLinkCreateParams.invoice_creation.invoice_data, PaymentLinkUpdateParams.invoice_creation.invoice_data, Quote.invoice_settings, QuoteCreateParams.invoice_settings, QuoteUpdateParams.invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases[].invoice_settings, SubscriptionScheduleCreateParams.default_settings.invoice_settings, SubscriptionScheduleCreateParams.phases[].invoice_settings, SubscriptionScheduleUpdateParams.default_settings.invoice_settings, and SubscriptionScheduleUpdateParams.phases[].invoice_settingsinvoice_settings on Checkout.SessionCreateParams.subscription_data, PaymentLink.subscription_data, PaymentLinkCreateParams.subscription_data, and PaymentLinkUpdateParams.subscription_datachallenge on enums Invoice.payment_settings.payment_method_options.card.request_three_d_secure, InvoiceCreateParams.payment_settings.payment_method_options.card.request_three_d_secure, InvoiceUpdateParams.payment_settings.payment_method_options.card.request_three_d_secure, Subscription.payment_settings.payment_method_options.card.request_three_d_secure, SubscriptionCreateParams.payment_settings.payment_method_options.card.request_three_d_secure, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.request_three_d_securepromotion_code on InvoiceUpcomingLinesParams.discounts[], InvoiceUpcomingLinesParams.invoice_items[].discounts[], InvoiceUpcomingParams.discounts[], and InvoiceUpcomingParams.invoice_items[].discounts[]account_type on PaymentMethodUpdateParams.us_bank_accountBankAccount, Card, and CardToken details on the external_account parameter in AccountUpdateParamsnn on enums Charge.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, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bankNNBANL2G on enums Charge.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bicCustomerSession.components.buy_button, CustomerSession.components.pricing_table, and Subscription.billing_cycle_anchor_config to be requiredissuer on InvoiceCreateParams, InvoiceUpcomingLinesParams, InvoiceUpcomingParams, InvoiceUpdateParams, and Invoiceliability on Invoice.automatic_tax, InvoiceCreateParams.automatic_tax, InvoiceUpcomingLinesParams.automatic_tax, InvoiceUpcomingParams.automatic_tax, InvoiceUpdateParams.automatic_tax, Subscription.automatic_tax, SubscriptionCreateParams.automatic_tax, and SubscriptionUpdateParams.automatic_taxon_behalf_of on InvoiceUpcomingLinesParams and InvoiceUpcomingParamspin on Issuing.CardCreateParamsrevocation_reason on Mandate.payment_method_details.bacs_debitcustomer_balance on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationinvoice_settings on SubscriptionCreateParams and SubscriptionUpdateParamsAdd support for new value nn on enum ConfirmationToken.payment_method_preview.ideal.bank
nn on enum ConfirmationToken.payment_method_preview.ideal.bankNNBANL2G on enum ConfirmationToken.payment_method_preview.ideal.bicInvoice.automatic_tax.liability, Invoice.issuer, and Subscription.automatic_tax.liability to be requiredraw_request usageAdd support for providing BankAccount, Card, and CardToken details on the external_account parameter in AccountUpdateParams
BankAccount, Card, and CardToken details on the external_account parameter in AccountUpdateParamsnn on enums Charge.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, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bankNNBANL2G on enums Charge.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bicCustomerSession.components.buy_button, CustomerSession.components.pricing_table, and Subscription.billing_cycle_anchor_config to be requiredissuer on InvoiceCreateParams, InvoiceUpcomingLinesParams, InvoiceUpcomingParams, InvoiceUpdateParams, and Invoiceliability on Invoice.automatic_tax, InvoiceCreateParams.automatic_tax, InvoiceUpcomingLinesParams.automatic_tax, InvoiceUpcomingParams.automatic_tax, InvoiceUpdateParams.automatic_tax, Subscription.automatic_tax, SubscriptionCreateParams.automatic_tax, and SubscriptionUpdateParams.automatic_taxon_behalf_of on InvoiceUpcomingLinesParams and InvoiceUpcomingParamspin on Issuing.CardCreateParamsrevocation_reason on Mandate.payment_method_details.bacs_debitcustomer_balance on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationinvoice_settings on SubscriptionCreateParams and SubscriptionUpdateParamsAdd support for amount on ChargeCaptureParams.payment_details.flight.segments[], ChargeUpdateParams.payment_details.flight.segments[], PaymentIntentCa
amount on ChargeCaptureParams.payment_details.flight.segments[], ChargeUpdateParams.payment_details.flight.segments[], PaymentIntentCaptureParams.payment_details.flight.segments[], PaymentIntentConfirmParams.payment_details.flight.segments[], PaymentIntentCreateParams.payment_details.flight.segments[], and PaymentIntentUpdateParams.payment_details.flight.segments[]number_of_rooms and room_class on ChargeCaptureParams.payment_details.lodging, ChargeUpdateParams.payment_details.lodging, PaymentIntentCaptureParams.payment_details.lodging, PaymentIntentConfirmParams.payment_details.lodging, PaymentIntentCreateParams.payment_details.lodging, and PaymentIntentUpdateParams.payment_details.lodgingConfirmationToken.setup_future_usage to be requiredbuy_button on CustomerSession.components and CustomerSessionCreateParams.componentshigh_risk_industry, insufficient_margin_ratio, insufficient_operating_profit, insufficient_reserves, insufficient_time_in_network, lacking_cash_account, and poor_payment_history_with_platform on enums Issuing.CreditUnderwritingRecord.decision.application_rejected.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.application_rejected.reasons[], and Issuing.CreditUnderwritingRecordReportDecisionParams.decision.application_rejected.reasons[]high_risk_industry, insufficient_margin_ratio, insufficient_operating_profit, insufficient_reserves, insufficient_time_in_network, and lacking_cash_account on enums Issuing.CreditUnderwritingRecord.decision.credit_limit_decreased.reasons[], Issuing.CreditUnderwritingRecord.decision.credit_line_closed.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.credit_limit_decreased.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.credit_line_closed.reasons[], Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams.decision.credit_limit_decreased.reasons[], and Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams.decision.credit_line_closed.reasons[]AccountSession.components.capital_financing_promotion.features to be requiredAdd support for new resource CustomerSession
CustomerSessioncreate method on resource CustomerSessionobligation_inbound, obligation_payout_failure, obligation_payout, and obligation_reversal_outbound from enum BalanceTransaction.typeeps and p24 on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]obligation from enum Reporting.ReportRunCreateParams.parameters.reporting_categorybilling_cycle_anchor_config on SubscriptionCreateParams and SubscriptionChange AccountSession.components.capital_financing_promotion.features to be required
AccountSession.components.capital_financing_promotion.features to be requiredAdd support for retrieve method on resource Tax.Registration
retrieve method on resource Tax.RegistrationAccountSession.components.payment_details.features, AccountSession.components.payment_details, AccountSession.components.payments.features, AccountSession.components.payments, AccountSession.components.payouts.features, AccountSession.components.payouts, PaymentLink.inactive_message, and PaymentLink.restrictions to be requiredSubscriptionSchedule.default_settings.invoice_settings from InvoiceSettingSubscriptionScheduleSetting | null to InvoiceSettingSubscriptionScheduleSettingAdd support for capital_financing_promotion on AccountSession.components and AccountSessionCreateParams.components
capital_financing_promotion on AccountSession.components and AccountSessionCreateParams.componentsshipping_address_invalid on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeFinancialConnections.Account.balance_refresh.next_refresh_available_at, FinancialConnections.Account.subscriptions, and FinancialConnections.Account.transaction_refresh to be requiredInvoice.issuer and SubscriptionSchedule.default_settings.invoice_settings.issuer from ConnectAccountReference | null to ConnectAccountReferencePaymentLink.subscription_data.invoice_settings from PaymentLinksResourceSubscriptionDataInvoiceSettings | null to PaymentLinksResourceSubscriptionDataInvoiceSettingsship_from_details on Tax.CalculationCreateParams, Tax.Calculation, and Tax.TransactionAdd support for collection_method on Mandate.payment_method_details.us_bank_account
collection_method on Mandate.payment_method_details.us_bank_accountmandate_options on PaymentIntent.payment_method_options.us_bank_account, PaymentIntentConfirmParams.payment_method_options.us_bank_account, PaymentIntentCreateParams.payment_method_options.us_bank_account, PaymentIntentUpdateParams.payment_method_options.us_bank_account, SetupIntent.payment_method_options.us_bank_account, SetupIntentConfirmParams.payment_method_options.us_bank_account, SetupIntentCreateParams.payment_method_options.us_bank_account, and SetupIntentUpdateParams.payment_method_options.us_bank_accountFinancialConnections.Transactionlist and retrieve methods on resource Transactionsubscribe and unsubscribe methods on resource FinancialConnections.Accountfeatures on AccountSessionCreateParams.components.payoutsedit_payout_schedule, instant_payouts, and standard_payouts on AccountSession.components.payouts.featuresCheckout.Session.payment_method_options.us_bank_account.financial_connections.prefetch[], Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntent.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntent.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], and SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[] from literal('balances') to enum('balances'|'transactions')financial_connections.account.refreshed_transactions on enum Event.typetransactions on enum FinancialConnections.AccountRefreshParams.features[]subscriptions and transaction_refresh on FinancialConnections.Accountnext_refresh_available_at on FinancialConnections.Account.balance_refreshtransactions on enums FinancialConnections.Session.prefetch[] and FinancialConnections.SessionCreateParams.prefetch[]unknown on enums Issuing.Authorization.verification_data.authentication_exemption.type and Issuing.AuthorizationCreateParams.testHelpers.verification_data.authentication_exemption.typechallenge on enums PaymentIntent.payment_method_options.card.request_three_d_secure, PaymentIntentConfirmParams.payment_method_options.card.request_three_d_secure, PaymentIntentCreateParams.payment_method_options.card.request_three_d_secure, PaymentIntentUpdateParams.payment_method_options.card.request_three_d_secure, SetupIntent.payment_method_options.card.request_three_d_secure, SetupIntentConfirmParams.payment_method_options.card.request_three_d_secure, SetupIntentCreateParams.payment_method_options.card.request_three_d_secure, and SetupIntentUpdateParams.payment_method_options.card.request_three_d_securerevolut_pay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationQuote.invoice_settings from InvoiceSettingQuoteSetting | null to InvoiceSettingQuoteSettingdestination_details on Refundfinancial_connections.account.refreshed_transactions on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for preview_mode and subscription_details on InvoiceUpcomingLinesParams and InvoiceUpcomingParams
preview_mode and subscription_details on InvoiceUpcomingLinesParams and InvoiceUpcomingParamssubscription_trial_from_plan on InvoiceUpcomingLinesParams and InvoiceUpcomingParamsbilling_behavior, end_behavior, and proration_behavior on InvoiceUpcomingLinesParams.schedule_details and InvoiceUpcomingParams.schedule_detailsAdd support for payment_method_reuse_agreement on Checkout.Session.consent_collection, Checkout.SessionCreateParams.consent_collection, PaymentLink.co
usage to X-Stripe-Client-Telemetrypayment_method_reuse_agreement on Checkout.Session.consent_collection, Checkout.SessionCreateParams.consent_collection, PaymentLink.consent_collection, and PaymentLinkCreateParams.consent_collectionafter_submit on Checkout.Session.custom_text, Checkout.SessionCreateParams.custom_text, PaymentLink.custom_text, PaymentLinkCreateParams.custom_text, and PaymentLinkUpdateParams.custom_textcreated on Radar.EarlyFraudWarningListParamsAdd support for retrieve method on resource FinancialConnections.Transaction
retrieve method on resource FinancialConnections.Transactionissuing_card and issuing_cards_list on AccountSessionCreateParams.componentspayment_method_remove, payment_method_save, and payment_method_set_as_default on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.featurespayment_method_detach and payment_method_set_as_customer_default on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.featuresAdd support for payment_details, payments, and payouts on AccountSession.components and AccountSessionCreateParams.components
payment_details, payments, and payouts on AccountSession.components and AccountSessionCreateParams.componentsfeatures on AccountSession.components.account_onboarding and AccountSessionCreateParams.components.account_onboardingcustomer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codepayment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.typeClimate.Product.metric_tons_available to be requiredvarious from enum Climate.Supplier.removal_pathwaychallenge_only and challenge from enum PaymentIntent.payment_method_options.card.request_three_d_secureinactive_message and restrictions on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLinktransfer_group on PaymentLink.payment_intent_data, PaymentLinkCreateParams.payment_intent_data, and PaymentLinkUpdateParams.payment_intent_datatrial_settings on PaymentLink.subscription_data, PaymentLinkCreateParams.subscription_data, and PaymentLinkUpdateParams.subscription_dataSee the changelog for more details.
Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
Climate.Order, Climate.Product, and Climate.Suppliercancel, create, list, retrieve, and update methods on resource Orderlist and retrieve methods on resources Product and Supplierfinancial_connections_account_inactive on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeclimate_order_purchase and climate_order_refund on enum BalanceTransaction.typecreated on Checkout.SessionListParamsvalidate_location on CustomerCreateParams.tax and CustomerUpdateParams.taxclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enum Event.typechallenge on enums PaymentIntent.payment_method_options.card.request_three_d_secure and SetupIntent.payment_method_options.card.request_three_d_secureclimate_order_purchase and climate_order_refund on enum Reporting.ReportRunCreateParams.parameters.reporting_categoryclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
Climate.Order, Climate.Product, and Climate.Supplierfinancial_connections_account_inactive on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enum Event.typeclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Rename .delivery.receipient to .delivery.recipient on Charge and PaymentIntent APIs.
.delivery.receipient to .delivery.recipient on Charge and PaymentIntent APIs.components on CustomerSessionCreateParams and CustomerSessionAdd support for electronic_commerce_indicator on Charge.payment_method_details.card.three_d_secure and SetupAttempt.payment_method_details.card.three_
electronic_commerce_indicator on Charge.payment_method_details.card.three_d_secure and SetupAttempt.payment_method_details.card.three_d_secureexemption_indicator_applied and exemption_indicator on Charge.payment_method_details.card.three_d_securetransaction_id on Charge.payment_method_details.card.three_d_secure, Issuing.Authorization.network_data, Issuing.Transaction.network_data, and SetupAttempt.payment_method_details.card.three_d_secureoffline on Charge.payment_method_details.card_presentsystem_trace_audit_number on Issuing.Authorization.network_datanetwork_risk_score on Issuing.Authorization.pending_request and Issuing.Authorization.request_history[]requested_at on Issuing.Authorization.request_history[]authorization_code on Issuing.Transaction.network_datathree_d_secure on PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card, SetupIntentConfirmParams.payment_method_options.card, SetupIntentCreateParams.payment_method_options.card, and SetupIntentUpdateParams.payment_method_options.cardAdd support for event_details and subscription on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_detai
event_details and subscription on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_detailsaffiliate and delivery on ChargeCaptureParams.payment_details.car_rental, ChargeCaptureParams.payment_details.flight, ChargeCaptureParams.payment_details.lodging, ChargeUpdateParams.payment_details.car_rental, ChargeUpdateParams.payment_details.flight, ChargeUpdateParams.payment_details.lodging, PaymentIntent.payment_details.car_rental, PaymentIntentCaptureParams.payment_details.car_rental, PaymentIntentCaptureParams.payment_details.flight, PaymentIntentCaptureParams.payment_details.lodging, PaymentIntentConfirmParams.payment_details.car_rental, PaymentIntentConfirmParams.payment_details.flight, PaymentIntentConfirmParams.payment_details.lodging, PaymentIntentCreateParams.payment_details.car_rental, PaymentIntentCreateParams.payment_details.flight, PaymentIntentCreateParams.payment_details.lodging, PaymentIntentUpdateParams.payment_details.car_rental, PaymentIntentUpdateParams.payment_details.flight, and PaymentIntentUpdateParams.payment_details.lodgingdrivers on ChargeCaptureParams.payment_details.car_rental, ChargeUpdateParams.payment_details.car_rental, PaymentIntent.payment_details.car_rental, PaymentIntentCaptureParams.payment_details.car_rental, PaymentIntentConfirmParams.payment_details.car_rental, PaymentIntentCreateParams.payment_details.car_rental, and PaymentIntentUpdateParams.payment_details.car_rentalpassengers on ChargeCaptureParams.payment_details.flight, ChargeCaptureParams.payment_details.lodging, ChargeUpdateParams.payment_details.flight, ChargeUpdateParams.payment_details.lodging, PaymentIntentCaptureParams.payment_details.flight, PaymentIntentCaptureParams.payment_details.lodging, PaymentIntentConfirmParams.payment_details.flight, PaymentIntentConfirmParams.payment_details.lodging, PaymentIntentCreateParams.payment_details.flight, PaymentIntentCreateParams.payment_details.lodging, PaymentIntentUpdateParams.payment_details.flight, and PaymentIntentUpdateParams.payment_details.lodgingcreated on CustomerSessionissuing_card and issuing_cards_list on AccountSessionCreateParams.componentsAdd support for bacs_debit_payments on AccountCreateParams.settings and AccountUpdateParams.settings
bacs_debit_payments on AccountCreateParams.settings and AccountUpdateParams.settingsservice_user_number on Account.settings.bacs_debit_paymentsAccount.settings.bacs_debit_payments.display_name from string to string | nullcapture_before on Charge.payment_method_details.cardpaypal on Checkout.Session.payment_method_optionstax_amounts on CreditNoteCreateParams.lines[], CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]network_data on Issuing.Transactionstatus on Checkout.SessionListParamsAdd support for new value quote.reestimate_failed on enum Event.type
quote.reestimate_failed on enum Event.typemetadata on QuoteCreateParams.phases[], QuotePhase, and QuoteUpdateParams.phases[]last_reestimation_details on Quote.computedquote.reestimate_failed on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new value terminal_reader_hardware_fault on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAt
terminal_reader_hardware_fault on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeCharge.payment_method_details.card.amount_authorized, Checkout.Session.payment_method_configuration_details, PaymentIntent.latest_charge, PaymentIntent.payment_method_configuration_details, and SetupIntent.payment_method_configuration_details to be requiredProduct.features[].name to be optionalmetadata on Quote.subscription_data, QuoteCreateParams.subscription_data, and QuoteUpdateParams.subscription_dataAdd support for attach_payment_intent method on resource Invoice
attach_payment_intent method on resource Invoicerevolut_pay on ConfirmationToken.payment_method_previewrevolut_pay on enum ConfirmationToken.payment_method_preview.typeConfirmationToken.payment_method_preview.paypal.payer_email, ConfirmationToken.payment_method_preview.paypal.payer_id, Issuing.Authorization.merchant_data.url, Issuing.Authorization.verification_data.three_d_secure, Issuing.Transaction.merchant_data.url, Order.payment.settings.payment_method_options.paypal.reference, and QuoteLine.set_schedule_end to be requiredrefunds on CreditNoteCreateParams, CreditNotePreviewLinesParams, CreditNotePreviewParams, and CreditNotepost_payment_amount and pre_payment_amount on CreditNoteinvoice.payment.overpaid on enum Event.typeschedule_details on InvoiceUpcomingLinesParams and InvoiceUpcomingParamsamounts_due on InvoiceCreateParams, InvoiceUpdateParams, and Invoicepayments on Invoicecreated on Issuing.PersonalizationDesignending_before, limit, and starting_after on Tax.RegistrationListParamsTax.RegistrationCreateParams.active_from to be 'now' | DateTimeinvoice.payment.overpaid on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resource Tax.Registration
Tax.Registrationcreate, list, and update methods on resource Registrationrevolut_pay_payments on Account APIs.token_card_network_invalid on error code enums.payment_unreconciled on enum BalanceTransaction.typerevolut_pay throughout the API..paypal.payer_email to be required in several locations.aba and swift on FundingInstructions.bank_transfer.financial_addresses[] and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[]ach, domestic_wire_us, and swift on enums FundingInstructions.bank_transfer.financial_addresses[].supported_networks[] and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networks[]aba and swift on enums FundingInstructions.bank_transfer.financial_addresses[].type and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].typeurl on Issuing.Authorization.merchant_data, Issuing.AuthorizationCreateParams.testHelpers.merchant_data, Issuing.Transaction.merchant_data, Issuing.TransactionCreateForceCaptureParams.testHelpers.merchant_data, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.merchant_dataauthentication_exemption and three_d_secure on Issuing.Authorization.verification_data and Issuing.AuthorizationCreateParams.testHelpers.verification_datadescription on PaymentLink.payment_intent_data, PaymentLinkCreateParams.payment_intent_data, and PaymentLinkUpdateParams.payment_intent_dataunreconciled_customer_funds on enum Reporting.ReportRunCreateParams.parameters.reporting_categoryAdd support for new resource Margin
Margincreate, list, retrieve, and update methods on resource Marginsubsellers on Checkout.SessionCreateParams.payment_method_options.paypal, Order.payment.settings.payment_method_options.paypal, OrderCreateParams.payment.settings.payment_method_options.paypal, OrderUpdateParams.payment.settings.payment_method_options.paypal, PaymentIntent.payment_method_options.paypal, PaymentIntentConfirmParams.payment_method_options.paypal, PaymentIntentCreateParams.payment_method_options.paypal, PaymentIntentUpdateParams.payment_method_options.paypal, SetupIntent.payment_method_options.paypal, SetupIntentConfirmParams.payment_method_options.paypal, SetupIntentCreateParams.payment_method_options.paypal, and SetupIntentUpdateParams.payment_method_options.paypaldefault_margins on InvoiceCreateParams, InvoiceUpdateParams, and Invoicetotal_margin_amounts on Invoicemargins on InvoiceItemCreateParams, InvoiceItemUpdateParams, and InvoiceItemapplicant_is_not_beneficial_owner, current_account_tier_ineligible, customer_requested_account_closure, dispute_rate_too_high, and invalid_business_license on enums Issuing.CreditUnderwritingRecord.decision.credit_limit_decreased.reasons[], Issuing.CreditUnderwritingRecord.decision.credit_line_closed.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.credit_limit_decreased.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.credit_line_closed.reasons[], Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams.decision.credit_limit_decreased.reasons[], and Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams.decision.credit_line_closed.reasons[]applicant_is_not_beneficial_owner, current_account_tier_ineligible, customer_requested_account_closure, dispute_rate_too_high, and invalid_business_license on enums Issuing.CreditUnderwritingRecord.decision.application_rejected.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.application_rejected.reasons[], and Issuing.CreditUnderwritingRecordReportDecisionParams.decision.application_rejected.reasons[]change_in_financial_state, change_in_utilization_of_credit_line, decrease_in_income_to_expense_ratio, decrease_in_social_media_performance, exceeds_acceptable_platform_exposure, has_recent_credit_limit_increase, insufficient_credit_utilization, insufficient_usage_as_qualified_expenses, and poor_payment_history_with_platform from enums Issuing.CreditUnderwritingRecord.decision.application_rejected.reasons[], Issuing.CreditUnderwritingRecordCorrectParams.decision.application_rejected.reasons[], and Issuing.CreditUnderwritingRecordReportDecisionParams.decision.application_rejected.reasons[]is_default on Issuing.PersonalizationDesign.preferences, Issuing.PersonalizationDesignCreateParams.preferences, Issuing.PersonalizationDesignListParams.preferences, and Issuing.PersonalizationDesignUpdateParams.preferencesis_platform_default on Issuing.PersonalizationDesign.preferences and Issuing.PersonalizationDesignListParams.preferencesaccount_default on Issuing.PersonalizationDesign.preferences, Issuing.PersonalizationDesignCreateParams.preferences, Issuing.PersonalizationDesignListParams.preferences, and Issuing.PersonalizationDesignUpdateParams.preferencesplatform_default on Issuing.PersonalizationDesign.preferences and Issuing.PersonalizationDesignListParams.preferencesliability on PaymentLink.automatic_tax, PaymentLinkCreateParams.automatic_tax, and PaymentLinkUpdateParams.automatic_taxissuer on PaymentLink.invoice_creation.invoice_data, PaymentLinkCreateParams.invoice_creation.invoice_data, and PaymentLinkUpdateParams.invoice_creation.invoice_datainvoice_settings on PaymentLink.subscription_data, PaymentLinkCreateParams.subscription_data, and PaymentLinkUpdateParams.subscription_dataaccept_failed_validations on enum Quote.status_details.stale.last_reason.typeAdd support for new value balance_invalid_parameter on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt
balance_invalid_parameter on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeIssuing.Cardholder.individual.card_issuing to be optionalUpdate pinned API version to 2023-10-16
Add support for new value invalid_dob_age_under_minimum on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAc
invalid_dob_age_under_minimum on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeCheckout.Session.client_secret and Checkout.Session.ui_mode to be requiredThis release changes the pinned API version to 2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe
2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe package.legal_guardian on AccountPersonsParams.relationship and TokenCreateParams.person.relationshipinvalid_address_highway_contract_box, invalid_address_private_mailbox, invalid_business_profile_name_denylisted, invalid_business_profile_name, invalid_company_name_denylisted, invalid_dob_age_over_maximum, invalid_product_description_length, invalid_product_description_url_match, invalid_statement_descriptor_business_mismatch, invalid_statement_descriptor_denylisted, invalid_statement_descriptor_length, invalid_statement_descriptor_prefix_denylisted, invalid_statement_descriptor_prefix_mismatch, invalid_tax_id_format, invalid_tax_id, invalid_url_denylisted, invalid_url_format, invalid_url_length, invalid_url_web_presence_detected, invalid_url_website_business_information_mismatch, invalid_url_website_empty, invalid_url_website_inaccessible_geoblocked, invalid_url_website_inaccessible_password_protected, invalid_url_website_inaccessible, invalid_url_website_incomplete_cancellation_policy, invalid_url_website_incomplete_customer_service_details, invalid_url_website_incomplete_legal_restrictions, invalid_url_website_incomplete_refund_policy, invalid_url_website_incomplete_return_policy, invalid_url_website_incomplete_terms_and_conditions, invalid_url_website_incomplete_under_construction, invalid_url_website_incomplete, and invalid_url_website_other on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeadditional_tos_acceptances on TokenCreateParams.person2023-10-16 on enum WebhookEndpointCreateParams.api_versionSee the changelog for more details.
Add support for new values issuing_token.created and issuing_token.updated on enum Event.type
issuing_token.created and issuing_token.updated on enum Event.typeissuing_token.created and issuing_token.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resources AccountNotice and Issuing.CreditUnderwritingRecord
AccountNotice and Issuing.CreditUnderwritingRecordlist, retrieve, and update methods on resource AccountNoticecorrect, create_from_application, create_from_proactive_review, list, report_decision, and retrieve methods on resource CreditUnderwritingRecordCheckout.Session.automatic_tax.liability.account, Checkout.Session.invoice_creation.invoice_data.issuer.account, Invoice.automatic_tax.liability.account, Invoice.issuer.account, Quote.automatic_tax.liability.account, Quote.invoice_settings.issuer.account, Subscription.automatic_tax.liability.account, SubscriptionSchedule.default_settings.automatic_tax.liability.account, SubscriptionSchedule.default_settings.invoice_settings.issuer.account, SubscriptionSchedule.phases[].automatic_tax.liability.account, and SubscriptionSchedule.phases[].invoice_settings.issuer.account from expandable(Account) | null to expandable(Account)Checkout.Session.automatic_tax.liability.account, Checkout.Session.invoice_creation.invoice_data.issuer.account, Invoice.automatic_tax.liability.account, Invoice.issuer.account, Issuing.Transaction.network_data.processing_date, Quote.automatic_tax.liability.account, Quote.invoice_settings.issuer.account, Subscription.automatic_tax.liability.account, SubscriptionSchedule.default_settings.automatic_tax.liability.account, SubscriptionSchedule.default_settings.invoice_settings.issuer.account, SubscriptionSchedule.phases[].automatic_tax.liability.account, and SubscriptionSchedule.phases[].invoice_settings.issuer.account to be optionalaccount_notice.created and account_notice.updated on enum Event.typelocal_amusement_tax and state_communications_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.typeaccount_notice.created and account_notice.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for redirect_on_completion, return_url, and ui_mode on Checkout.SessionCreateParams and Checkout.Session
redirect_on_completion, return_url, and ui_mode on Checkout.SessionCreateParams and Checkout.SessionCheckout.Session.custom_fields[].dropdown, Checkout.Session.custom_fields[].numeric, Checkout.Session.custom_fields[].text, Checkout.SessionCreateParams.success_url, PaymentLink.custom_fields[].dropdown, PaymentLink.custom_fields[].numeric, and PaymentLink.custom_fields[].text to be optionalclient_secret on Checkout.SessionCheckout.Session.custom_fields[].dropdown from PaymentPagesCheckoutSessionCustomFieldsDropdown | null to PaymentPagesCheckoutSessionCustomFieldsDropdownCheckout.Session.custom_fields[].numeric and Checkout.Session.custom_fields[].text from PaymentPagesCheckoutSessionCustomFieldsNumeric | null to PaymentPagesCheckoutSessionCustomFieldsNumericpostal_code on Issuing.Authorization.verification_dataPaymentLink.custom_fields[].dropdown from PaymentLinksResourceCustomFieldsDropdown | null to PaymentLinksResourceCustomFieldsDropdownPaymentLink.custom_fields[].numeric and PaymentLink.custom_fields[].text from PaymentLinksResourceCustomFieldsNumeric | null to PaymentLinksResourceCustomFieldsNumericoffline on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.ConfigurationAdd support for mark_draft and mark_stale methods on resource Quote
mark_draft and mark_stale methods on resource Quotedraft_quote, mark_stale_quote, and preview_invoice_lines methods on resource Quoteliability on Checkout.Session.automatic_tax and Checkout.SessionCreateParams.automatic_taxissuer on Checkout.Session.invoice_creation.invoice_data and Checkout.SessionCreateParams.invoice_creation.invoice_datainvoice_settings on Checkout.SessionCreateParams.subscription_datapersonalization_design on Issuing.CardListParamsallow_backdated_lines on QuoteCreateParams, QuoteUpdateParams, and QuoteAdd support for new resource Issuing.Token
Issuing.Tokenlist, retrieve, and update methods on resource Tokenamount_authorized, extended_authorization, incremental_authorization, multicapture, and overcapture on Charge.payment_method_details.cardtoken on Issuing.Authorization and Issuing.Transactionauthorization_code on Issuing.Authorization.request_history[]request_extended_authorization, request_multicapture, and request_overcapture on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.cardrequest_incremental_authorization on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.cardfinal_capture on PaymentIntentCaptureParamsmetadata on PaymentLink.payment_intent_data, PaymentLink.subscription_data, PaymentLinkCreateParams.payment_intent_data, and PaymentLinkCreateParams.subscription_datastatement_descriptor_suffix and statement_descriptor on PaymentLink.payment_intent_data and PaymentLinkCreateParams.payment_intent_datapayment_intent_data and subscription_data on PaymentLinkUpdateParamsRename resources Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundle
Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundlecapital_financing_offer and capital_financing_reporting on enum AccountLinkCreateParams.typefeatures on AccountSession.components.payment_details, AccountSession.components.payments, AccountSession.components.payouts, AccountSessionCreateParams.components.account_onboarding, AccountSessionCreateParams.components.payment_details, AccountSessionCreateParams.components.payments, and AccountSessionCreateParams.components.payoutsConfirmationToken.payment_method_preview.us_bank_account.financial_connections_account and ConfirmationToken.payment_method_preview.us_bank_account.status_details to be requiredreason on EventAdd support for rendering on InvoiceCreateParams, InvoiceUpdateParams, and Invoice
rendering on InvoiceCreateParams, InvoiceUpdateParams, and InvoicePaymentMethod.us_bank_account.financial_connections_account and PaymentMethod.us_bank_account.status_details to be requiredRemove support for customer on ConfirmationToken
customer on ConfirmationTokenissuer on InvoiceCreateParams, InvoiceUpcomingLinesParams, InvoiceUpcomingParams, InvoiceUpdateParams, Invoice, Quote.invoice_settings, QuoteCreateParams.invoice_settings, QuoteUpdateParams.invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases[].invoice_settings, SubscriptionScheduleCreateParams.default_settings.invoice_settings, SubscriptionScheduleCreateParams.phases[].invoice_settings, SubscriptionScheduleUpdateParams.default_settings.invoice_settings, and SubscriptionScheduleUpdateParams.phases[].invoice_settingson_behalf_of on InvoiceUpcomingLinesParams and InvoiceUpcomingParamsliability on Invoice.automatic_tax, InvoiceCreateParams.automatic_tax, InvoiceUpcomingLinesParams.automatic_tax, InvoiceUpcomingParams.automatic_tax, InvoiceUpdateParams.automatic_tax, Quote.automatic_tax, QuoteCreateParams.automatic_tax, QuoteUpdateParams.automatic_tax, Subscription.automatic_tax, SubscriptionCreateParams.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, SubscriptionSchedule.phases[].automatic_tax, SubscriptionScheduleCreateParams.default_settings.automatic_tax, SubscriptionScheduleCreateParams.phases[].automatic_tax, SubscriptionScheduleUpdateParams.default_settings.automatic_tax, SubscriptionScheduleUpdateParams.phases[].automatic_tax, and SubscriptionUpdateParams.automatic_taxIssuing.CardDesignUpdateParams.carrier_text from carrier_text_param to emptyStringable(carrier_text_param)invoice_settings on SubscriptionCreateParams and SubscriptionUpdateParamsAdd support for terms_of_service_acceptance on Checkout.Session.custom_text, Checkout.SessionCreateParams.custom_text, PaymentLink.custom_text, Paymen
terms_of_service_acceptance on Checkout.Session.custom_text, Checkout.SessionCreateParams.custom_text, PaymentLink.custom_text, PaymentLinkCreateParams.custom_text, and PaymentLinkUpdateParams.custom_textAdd support for new resource ConfirmationToken
ConfirmationTokenretrieve method on resource ConfirmationTokencreate method on resource Issuing.CardDesignreject_testmode test helper method on resource Issuing.CardDesignissuing_card_design.rejected on enum Event.typefeatures on Issuing.CardBundlepreferences on Issuing.CardDesignListParams, Issuing.CardDesignUpdateParams, and Issuing.CardDesignpreference on Issuing.CardDesignListParams, Issuing.CardDesignUpdateParams, and Issuing.CardDesigncard_bundle on Issuing.CardDesignUpdateParamscard_logo and carrier_text on Issuing.CardDesignUpdateParams and Issuing.CardDesignIssuing.CardDesignUpdateParams.lookup_key and Issuing.CardDesignUpdateParams.name from string to emptyStringable(string)rejection_reasons on Issuing.CardDesignconfirmation_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, SetupIntentConfirmParams, and SetupIntentCreateParamsissuing_card_design.rejected on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resource PaymentMethodConfiguration
PaymentMethodConfigurationcreate, list, retrieve, and update methods on resource PaymentMethodConfigurationpayment_method_configuration on Checkout.SessionCreateParams, PaymentIntentCreateParams, PaymentIntentUpdateParams, SetupIntentCreateParams, and SetupIntentUpdateParamspayment_method_configuration_details on Checkout.Session, PaymentIntent, and SetupIntentcapture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorizationcreate_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.Transactionstripe_tax_inactive on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codenonce on EphemeralKeyCreateParamscashback_amount on Issuing.Authorization.amount_details, Issuing.Authorization.pending_request.amount_details, Issuing.Authorization.request_history[].amount_details, and Issuing.Transaction.amount_detailsserial_number on Terminal.ReaderListParamsRemove support for submit_card test helper method on resource Issuing.Card
submit_card test helper method on resource Issuing.Cardtax_forms on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settingscard_design on Issuing.CardUpdateParamssubmitted from enum Issuing.Card.shipping.statusplatform_default on enums Issuing.CardDesign.preference and Issuing.CardDesignListParams.preferenceAdd support for new resource PaymentMethodDomain
PaymentMethodDomaincreate, list, retrieve, update, and validate methods on resource PaymentMethodDomainn26 on enums Charge.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, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bankNTSBDEB1 on enums Charge.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bictreasury.credit_reversal.created, treasury.credit_reversal.posted, treasury.debit_reversal.completed, treasury.debit_reversal.created, treasury.debit_reversal.initial_credit_granted, treasury.financial_account.closed, treasury.financial_account.created, treasury.financial_account.features_status_updated, treasury.inbound_transfer.canceled, treasury.inbound_transfer.created, treasury.inbound_transfer.failed, treasury.inbound_transfer.succeeded, treasury.outbound_payment.canceled, treasury.outbound_payment.created, treasury.outbound_payment.expected_arrival_date_updated, treasury.outbound_payment.failed, treasury.outbound_payment.posted, treasury.outbound_payment.returned, treasury.outbound_transfer.canceled, treasury.outbound_transfer.created, treasury.outbound_transfer.expected_arrival_date_updated, treasury.outbound_transfer.failed, treasury.outbound_transfer.posted, treasury.outbound_transfer.returned, treasury.received_credit.created, treasury.received_credit.failed, treasury.received_credit.succeeded, and treasury.received_debit.created on enum Event.typeinvoiceitem.updated from enum Event.typefeatures on ProductCreateParams, ProductUpdateParams, and Productinvoiceitem.updated from enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Rename Quote.listPreviewSubscriptionSchedules to Quote.listPreviewSchedules and `Quote.listPreview
Quote.listPreviewSubscriptionSchedules to Quote.listPreviewSchedules and `Quote.listPreviewAdd support for new resource AccountSession
AccountSessioncreate method on resource AccountSessionobligation_inbound, obligation_outbound, obligation_payout_failure, obligation_payout, obligation_reversal_inbound, and obligation_reversal_outbound on enum BalanceTransaction.typeEvent.type from string to enumapplication on PaymentLinkobligation on enum Reporting.ReportRunCreateParams.parameters.reporting_categoryAdd support for retention on BillingPortal.Session.flow.subscription_cancel and BillingPortal.SessionCreateParams.flow_data.subscription_cancel
retention on BillingPortal.Session.flow.subscription_cancel and BillingPortal.SessionCreateParams.flow_data.subscription_cancelprefetch on Checkout.Session.payment_method_options.us_bank_account.financial_connections, Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections, FinancialConnections.SessionCreateParams, FinancialConnections.Session, Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections, InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, PaymentIntent.payment_method_options.us_bank_account.financial_connections, PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections, PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections, PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections, SetupIntent.payment_method_options.us_bank_account.financial_connections, SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections, SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections, SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections, Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections, SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, and SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connectionspayment_method_details on DisputePaymentIntentCreateParams.mandate_data and SetupIntentCreateParams.mandate_data from secret_key_param to emptyStringable(secret_key_param)PaymentIntentConfirmParams.mandate_data and SetupIntentConfirmParams.mandate_data from secret_key_param | client_key_param to emptyStringable(secret_key_param | client_key_param)balance_transaction on CustomerCashBalanceTransaction.adjusted_for_overdraftmaxNetworkRetries options JSDocAdd support for flat_amount on Tax.TransactionCreateReversalParams
flat_amount on Tax.TransactionCreateReversalParamsSee the changelog for more details.
2023-08-16.More information is available in the stripe-node v13 migration guide " ⚠️" symbol highlights breaking changes.
2023-08-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-node.del method on Subcriptions. Please use the cancel method instead, which was introduced in v9.14.0:verification_directors_mismatch, verification_document_directors_mismatch, verification_extraneous_directors, and verification_missing_directors on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codecustom_account_update and custom_account_verification from enum AccountLinkCreateParams.type
available_on on BalanceTransactionListParams
.AddExtraParam if sending the parameter is still required.alternate_statement_descriptors and dispute on Charge
destination on Charge
transfer_data or on_behalf_of instead.shipping_rates on Checkout.SessionCreateParams
shipping_options instead.coupon and trial_from_plan on Checkout.SessionCreateParams.subscription_data
// @ts-ignore or any if sending the parameter is still required.card_present from enums CustomerListPaymentMethodsParams.type and PaymentMethodListParams.type
charge_refunded from enum Dispute.status
blik on Mandate.payment_method_details, PaymentMethodUpdateParams, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
acss_debit, affirm, au_becs_debit, bacs_debit, cashapp, sepa_debit, and zip on PaymentMethodUpdateParams
country on PaymentMethod.link
recurring on PriceUpdateParams
attributes, caption, and deactivate_on on ProductCreateParams, ProductUpdateParams, and Product
2023-08-16 on enum WebhookEndpointCreateParams.api_versionAdd support for new resources QuotePreviewInvoice and QuotePreviewSchedule
QuotePreviewInvoice and QuotePreviewScheduleCheckout.Session.payment_method_options.us_bank_account.financial_connections.prefetch, FinancialConnections.Session.prefetch, Invoice.charge, Invoice.customer, Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch, PaymentIntent.payment_method_options.us_bank_account.financial_connections.prefetch, SetupIntent.payment_method_options.us_bank_account.financial_connections.prefetch, and Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch to be requiredapplies_to on Invoice and SubscriptionSchedulecl, co, id, kr, mx, my, sa, th, tr, and vn on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionshk on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsAdd support for paypal on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
paypal on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationquote.accept_failed on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new values incorporated_partnership and unincorporated_partnership on enums Account.company.structure, AccountCreateParams.company.str
incorporated_partnership and unincorporated_partnership on enums Account.company.structure, AccountCreateParams.company.structure, AccountUpdateParams.company.structure, and TokenCreateParams.account.company.structurepayment_reversal on enum BalanceTransaction.typeInvoice.subscription_details.metadata and Invoice.subscription_details to be requiredAdd support for submit_card test helper method on resource Issuing.Card
submit_card test helper method on resource Issuing.Cardaddress_validation on Issuing.Card.shipping and Issuing.CardCreateParams.shippingshipping on Issuing.CardUpdateParamssubmitted on enum Issuing.Card.shipping.statusOrderCreateParams.line_items[].product_data.description, OrderCreateParams.line_items[].product_data.tax_code, OrderCreateParams.shipping_details.phone, OrderUpdateParams.description, OrderUpdateParams.line_items[].product_data.description, OrderUpdateParams.line_items[].product_data.tax_code, OrderUpdateParams.shipping_details.phone, PaymentMethodConfigurationListParams.application, and QuoteUpdateParams.subscription_data_overrides[].description from string to emptyStringable(string)reason on QuoteMarkStaleQuoteParamsmarked_stale on Quote.status_details.stale.last_reasonTax.FormListParams.payee.type to be optionalChange many types from string to emptyStringable(string)
string to emptyStringable(string)subscription_details on Invoicepreferred_settlement_speed on PaymentIntent.payment_method_options.us_bank_account, PaymentIntentConfirmParams.payment_method_options.us_bank_account, PaymentIntentCreateParams.payment_method_options.us_bank_account, and PaymentIntentUpdateParams.payment_method_options.us_bank_accountsepa_debit_fingerprint and us_bank_account_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_typeUpdated stable APIs to the latest version
Add support for monthly_estimated_revenue on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
Add support for monthly_estimated_revenue on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
Add support for new value ro_tin on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_
ro_tin on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, and Tax.Transaction.customer_details.tax_ids[].typeexcluded_territory, jurisdiction_unsupported, and vat_exempt from enums Checkout.Session.shipping_cost.taxes[].taxability_reason, Checkout.Session.total_details.breakdown.taxes[].taxability_reason, CreditNote.shipping_cost.taxes[].taxability_reason, Invoice.shipping_cost.taxes[].taxability_reason, LineItem.taxes[].taxability_reason, Quote.computed.recurring.total_details.breakdown.taxes[].taxability_reason, Quote.computed.upfront.total_details.breakdown.taxes[].taxability_reason, and Quote.total_details.breakdown.taxes[].taxability_reasonro_tin on enums CustomerCreateParams.tax_id_data[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, and Tax.CalculationCreateParams.customer_details.tax_ids[].typeuse_stripe_sdk on SetupIntentConfirmParams and SetupIntentCreateParamsservice_tax on enums TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typeCheckoutSessionCreateParams -> Checkout.SessionCreateParamsAdd support for new resource PaymentMethodConfiguration
PaymentMethodConfigurationcreate, list, retrieve, and update methods on resource PaymentMethodConfigurationpayment_method_configuration on PaymentIntentCreateParams and PaymentIntentUpdateParamspayment_method_configuration_details on PaymentIntentTax.SettingRetrieveParam to Tax.SettingsRetrieveParam and Tax.SettingUpdateParams to Tax.SettingsUpdateParams (parity with main release)Your coding agent can read these notes before it upgrades. Set up the MCP server →