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
Latest stable
23.1.0
Last release 7 days ago
11 Nov 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
Nothing withdrawn
no release was ever pulled
15 years old
815 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
This release changes the pinned API version to 2026-05-27.private.
This release changes the pinned API version to 2026-05-27.private.
pause method on resource Subscriptionretrieve method on resource V2.Iam.ActivityLogmastercard on enum Issuing.Settlement.networkProductCatalog.TrialOffer.end_behavior.transition.price from string to expandable(Price)amount_paid_off_stripe on QuotePreviewInvoicetwint on enum QuotePreviewInvoice.payment_settings.payment_method_typesdiscountable on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]bizum and scalapay on SharedPayment.GrantedToken.payment_method_detailsbizum and scalapay on enum SharedPayment.GrantedToken.payment_method_details.typeSharedPayment.GrantedToken.agent_details to be requiredSubscriptionItem.billed_until from DateTime | null to DateTimepayment_behavior on SubscriptionResumeParamsstatus_details on SubscriptionSubscription.billing_schedules to be requiredao_bank_account, az_bank_account, bd_bank_account, bo_bank_account, br_bank_account, cl_bank_account, ga_bank_account, gh_bank_account, gi_bank_account, hn_bank_account, kr_bank_account, kz_bank_account, la_bank_account, ne_bank_account, ng_bank_account, ni_bank_account, py_bank_account, sa_bank_account, sm_bank_account, and uy_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typeV2.MoneyManagement.ReceivedCredit.bank_transfer.gb_bank_account.network from literal('fps') to enum('chaps'|'fps')chaps on enum V2.FinancialAddressCreditSimulationCreditParams.networkpayment_method_microdeposit_processing_error and siret_invalid on QuotePreviewInvoice.last_finalization_errorYour coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for retrieve method on resource Radar.CustomerEvaluation
retrieve method on resource Radar.CustomerEvaluationdisable_stripe_user_authentication on AccountSession.components.bills.featurestamara on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, and SharedPayment.GrantedToken.payment_method_detailsstatus on Charge.payment_method_details.card.account_fundingprocessed_transaction_type on Charge.payment_method_details.card.account_fundingitems on Checkout.SessionCreateParamsbrand on Checkout.Session.current_attempt.payment_method_details.cardtamara on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typefirst6 on ConfirmationToken.payment_method_preview.gift_card, PaymentMethod.gift_card, and SharedPayment.GrantedToken.payment_method_details.gift_cardtamara on enums ConfirmationToken.payment_method_preview.type, PaymentMethod.type, and SharedPayment.GrantedToken.payment_method_details.typetamara on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typefingerprint on GiftCardblik on Mandate.payment_method_detailsbuyer_id on Order.payment.settings.payment_method_options.wechat_pay, OrderCreateParams.payment.settings.payment_method_options.wechat_pay, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay, PaymentIntent.payment_method_options.wechat_pay, PaymentIntentConfirmParams.payment_method_options.wechat_pay, PaymentIntentCreateParams.payment_method_options.wechat_pay, and PaymentIntentUpdateParams.payment_method_options.wechat_paymini_program on enums OrderCreateParams.payment.settings.payment_method_options.wechat_pay.client, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay.client, PaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.clientmini_program on enums Order.payment.settings.payment_method_options.wechat_pay.client and PaymentIntent.payment_method_options.wechat_pay.clientpayment_method_details on PaymentAttemptRecordReportGuaranteedParams and PaymentRecordReportPaymentAttemptGuaranteedParamsfailed and refund_group on PaymentAttemptRecordReportRefundParams and PaymentRecordReportRefundParamsPaymentAttemptRecordReportRefundParams.outcome and PaymentRecordReportRefundParams.outcome from literal('refunded') to enum('failed'|'refunded')tamara on enums PaymentIntentConfirmParams.allowed_payment_method_types, PaymentIntentCreateParams.allowed_payment_method_types, and PaymentIntentUpdateParams.allowed_payment_method_typestamara on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_typesbeneficiary_details on PaymentIntent.payment_details.money_services, PaymentIntentConfirmParams.payment_details.money_services, PaymentIntentCreateParams.payment_details.money_services, and PaymentIntentUpdateParams.payment_details.money_servicesbeneficiary_account and beneficiary_details on PaymentIntent.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_fundingsender_account on PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_fundinggiven_name and surname on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_detailsname on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_detailsPaymentIntentConfirmParams.payment_method_options.card.capture_method, PaymentIntentCreateParams.payment_method_options.card.capture_method, and PaymentIntentUpdateParams.payment_method_options.card.capture_method from literal('manual') to enum('automatic_delayed'|'manual')wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_fundingautomatic_delayed on enums PaymentIntentConfirmParams.payment_method_options.card_present.capture_method, PaymentIntentCreateParams.payment_method_options.card_present.capture_method, and PaymentIntentUpdateParams.payment_method_options.card_present.capture_methodtransaction_verification_options on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.cryptoethereum and polygon on enums PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options.networks, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options.networks, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_options.networksethereum and polygon on enum PaymentIntentSimulateCryptoDepositParams.testHelpers.networkPaymentIntentSimulateCryptoDepositParams.testHelpers.token_currency from literal('usdc') to enum('usdc'|'usdg'|'usdp')forced_capture on PaymentIntent.advanced_feature_detailstamara on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typeswechat_pay_handle_app_redirect on PaymentIntent.next_action and SetupIntent.next_actionethereum and polygon on PaymentIntent.next_action.crypto_display_details.deposit_addressesPaymentIntent.next_action.crypto_display_details.deposit_addresses.base.supported_tokens[].token_currency, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana.supported_tokens[].token_currency, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempo.supported_tokens[].token_currency from literal('usdc') to enum('usdc'|'usdg'|'usdp')beneficiary_account on PaymentIntent.payment_details.money_servicesPaymentIntent.payment_method_options.card.capture_method from literal('manual') to enum('automatic_delayed'|'manual')automatic_delayed on enum PaymentIntent.payment_method_options.card_present.capture_methodethereum and polygon on enum PaymentIntent.payment_method_options.crypto.deposit_options.networksPaymentLocationUpdateParams.business_registration.siret from string to emptyable(string)card on PaymentRecordReportPaymentAttemptParams.payment_method_details and PaymentRecordReportPaymentParams.payment_method_detailsPaymentRecordReportPaymentAttemptParams.payment_method_details.type and PaymentRecordReportPaymentParams.payment_method_details.type from literal('custom') to enum('card'|'custom')managed_payments on Productpayment_attempt_record on RefundCreateParams and RefundListParamspayment_record on RefundListParamsprotections on V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments, V2.Core.Account.configuration.merchant.capabilities.affirm_payments, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.Account.configuration.merchant.capabilities.alma_payments, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments, V2.Core.Account.configuration.merchant.capabilities.blik_payments, V2.Core.Account.configuration.merchant.capabilities.boleto_payments, V2.Core.Account.configuration.merchant.capabilities.card_payments, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments, V2.Core.Account.configuration.merchant.capabilities.eps_payments, V2.Core.Account.configuration.merchant.capabilities.fpx_payments, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments, V2.Core.Account.configuration.merchant.capabilities.ideal_payments, V2.Core.Account.configuration.merchant.capabilities.jcb_payments, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.Account.configuration.merchant.capabilities.klarna_payments, V2.Core.Account.configuration.merchant.capabilities.konbini_payments, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments, V2.Core.Account.configuration.merchant.capabilities.link_payments, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments, V2.Core.Account.configuration.merchant.capabilities.p24_payments, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.Account.configuration.merchant.capabilities.payco_payments, V2.Core.Account.configuration.merchant.capabilities.paynow_payments, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.merchant.capabilities.swish_payments, V2.Core.Account.configuration.merchant.capabilities.twint_payments, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.zip_payments, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.Account.configuration.recipient.capabilities.cards, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets, V2.Core.Account.configuration.recipient.capabilities.paper_checks, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.Account.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.Account.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.Account.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.holds_currencies.eur, V2.Core.Account.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usd, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.Account.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.cards, V2.Core.Account.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.financial_accounts, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.AccountCreateParams.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.AccountCreateParams.configuration.merchant.capabilities.ach_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.acss_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.affirm_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.alma_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.bancontact_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.blik_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.boleto_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.card_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.cashapp_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.eps_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.fpx_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.grabpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.ideal_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.jcb_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.klarna_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.konbini_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.kr_card_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.link_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.mobilepay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.multibanco_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.naver_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.oxxo_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.p24_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.payco_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.paynow_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.promptpay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.swish_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.twint_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.AccountCreateParams.configuration.merchant.capabilities.zip_payments, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.local, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.AccountCreateParams.configuration.recipient.capabilities.cards, V2.Core.AccountCreateParams.configuration.recipient.capabilities.crypto_wallets, V2.Core.AccountCreateParams.configuration.recipient.capabilities.paper_checks, V2.Core.AccountCreateParams.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.AccountCreateParams.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.eur, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.usd, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.AccountCreateParams.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.cards, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.crypto_wallets, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers.financial_accounts, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.fifth_third.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead.debit_card, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead.prepaid_card, V2.Core.AccountUpdateParams.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.ach_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.acss_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.affirm_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.alma_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.bancontact_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.blik_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.boleto_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.card_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.cashapp_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.eps_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.fpx_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.grabpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.ideal_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.jcb_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.klarna_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.konbini_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.kr_card_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.link_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.mobilepay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.multibanco_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.naver_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.oxxo_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.p24_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.payco_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.paynow_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.promptpay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.swish_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.twint_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.AccountUpdateParams.configuration.merchant.capabilities.zip_payments, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.instant, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.local, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.cards, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.crypto_wallets, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.paper_checks, V2.Core.AccountUpdateParams.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.AccountUpdateParams.configuration.storer.capabilities.consumer.holds_currencies.usd, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.eur, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.usd, V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.AccountUpdateParams.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.cards, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.crypto_wallets, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments.paper_checks, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.bank_accounts, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.crypto_wallets, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers.financial_accountsThis release changes the pinned API version to 2026-06-10.preview.
This release changes the pinned API version to 2026-06-10.preview.
GiftCardOperation, GiftCard, and TaxFundretrieve method on resource GiftCardOperationactivate, cashout, check_balance, create, reload, retrieve, and void_operation methods on resource GiftCardlist and retrieve methods on resource TaxFundupdate_crypto_refund_address method on resource PaymentIntentperformance_location_details on Tax.CalculationCreateParams.line_items[], Tax.CalculationLineItem, and Tax.TransactionLineItemmoney_services on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, and PaymentIntentCaptureParams.payment_detailsfr_meal_voucher on Charge.payment_method_details.card.benefitsmulticapture on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_presentpix on Checkout.Session.current_attempt.payment_method_detailsjaywan on enum Checkout.Session.current_attempt.payment_method_details.card.brandprovisional_credit on Issuing.DisputeUpdateParams and Issuing.Disputereason on PaymentAttemptRecordReportCanceledParams and PaymentRecordReportPaymentAttemptCanceledParamsfiserv_valuelink, givex, and svs on PaymentAttemptRecord.processor_details and PaymentRecord.processor_detailsPaymentAttemptRecord.processor_details.type and PaymentRecord.processor_details.type from literal('custom') to enum('custom'|'fiserv_valuelink'|'givex'|'svs')capture_by and capture_delay on PaymentIntent.payment_method_options.card_present, 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.cardliquid_asset on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_fundingrequest_multicapture on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_presenttransaction_verification on enums PaymentIntentConfirmParams.payment_method_options.crypto.mode, PaymentIntentCreateParams.payment_method_options.crypto.mode, and PaymentIntentUpdateParams.payment_method_options.crypto.modeignore_application_fee, ignore_transfer_data, and request_partial_authorization on PaymentIntentConfirmParams.payment_method_options.gift_card, PaymentIntentCreateParams.payment_method_options.gift_card, and PaymentIntentUpdateParams.payment_method_options.gift_cardPaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher.siret, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher.siret, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher.siret, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucher.siret to be optionallatest_payment_attempt_record and payment_record on PaymentIntentreauthorization and reauthorize_before on PaymentIntent.advanced_feature_detailsrefund_address on PaymentIntent.next_action.crypto_display_details.deposit_addresses.base, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempolocation on PaymentIntent.payment_details and SetupIntent.setup_detailstransaction_verification on enum PaymentIntent.payment_method_options.crypto.modedata on Radar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details, Radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details, and Radar.CustomerEvaluationCreateParams.evaluation_context[].client_detailsRadar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details.radar_session, Radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details.radar_session, and Radar.CustomerEvaluationCreateParams.evaluation_context[].client_details.radar_session to be optionalpromotion on enum V2.Commerce.ProductCatalogImport.feed_typeV2.Core.FeeBatch.adjustments.tax_adjustment from amount to an objectV2.Core.FeeBatch.amount, V2.Core.FeeBatch.collection_records[].amount, V2.Core.FeeBatch.collection_records[].tax.amount, V2.Core.FeeBatch.tax.amount, V2.Core.FeeEntry.amount, and V2.Core.FeeEntry.tax.amount from amount to an objecttax_fund on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categorytax_fund on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowtax_fund on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typepromotion on enum V2.Commerce.ProductCatalogImportCreateParams.feed_typedefault_us_bank_account_cannot_be_archived on CannotProceedErrorAdd support for new resources DelegatedCheckout.OrderEvent, DelegatedCheckout.Order, V2.Billing.ContractLicensePricingQuantityChange, V2.Billing.Contr
DelegatedCheckout.OrderEvent, DelegatedCheckout.Order, V2.Billing.ContractLicensePricingQuantityChange, V2.Billing.Contract, and V2.Signals.AccountSignalretrieve method on resource DelegatedCheckout.Orderlist_orders method on resource DelegatedCheckout.RequestedSessionlist and retrieve methods on resource V2.Signals.AccountSignalactivate, cancel, create, list, retrieve, and update methods on resource V2.Billing.Contractbirth_address on AccountCreateParams.individual, AccountCreatePersonParams, AccountUpdateParams.individual, AccountUpdatePersonParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.personChargeCaptureParams.payment_details.money_services.transaction_type, ChargeUpdateParams.payment_details.money_services.transaction_type, PaymentIntentCaptureParams.payment_details.money_services.transaction_type, PaymentIntentConfirmParams.payment_details.money_services.transaction_type, PaymentIntentCreateParams.payment_details.money_services.transaction_type, and PaymentIntentUpdateParams.payment_details.money_services.transaction_type from literal('account_funding') to enum('account_funding'|'debt_repayment')proserv on enums Checkout.Session.automatic_surcharge.provider and PaymentLink.automatic_surcharge.providerprovisioning_decision and token_type on Issuing.Authorization.token_details and Issuing.Tokentoken_decision_recommendation on Issuing.Authorization.token_details.network_data.visa and Issuing.Token.network_data.visalanguage on Issuing.Token.network_data.devicedigital_asset_category on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_fundingstatic_address on PaymentIntent.payment_method_options.crypto.deposit_options, PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_optionspayment_reference on PaymentIntentCreateParams.payments_orchestrationpayment_details on PaymentIntentCreateParams.payments_orchestrationPaymentIntent.payment_details.money_services.transaction_type from literal('account_funding') to enum('account_funding'|'debt_repayment')ending_before, limit, and starting_after on PaymentLocationListParamsRadar.IssuingAuthorizationEvaluationCreateParams.card_details.last4 to be requiredschema on V2.Data.Reporting.QueryRun.result.file and V2.Reporting.ReportRun.result.filepayout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reasoninclude on V2.Data.Reporting.QueryRunRetrieveParams and V2.Reporting.ReportRunRetrieveParamsrequirements_collector on V2.Core.AccountCreateParams.defaults.responsibilities and V2.Core.AccountUpdateParams.defaults.responsibilitiesV2SignalsAccountSignalMerchantDelinquencyReadyEvent with related object V2.Signals.AccountSignalThis release changes the pinned API version to 2026-05-27.private.
This release changes the pinned API version to 2026-05-27.private.
Billing.AlertCreateParams.spend_threshold.group_by from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')Billing.Alert.spend_threshold.group_by from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')DelegatedCheckout.RequestedSession.affiliate_attributions to be requiredinstitution_requirement on enum FinancialConnections.Account.status_details.inactive.causewechat_pay on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsgift_card on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_optionspayment_details on PaymentIntentCreateParams.payments_orchestrationenabled on PaymentIntent.payment_details.benefit.fr_meal_voucher and SetupIntent.setup_details.benefit.fr_meal_voucherlogin_failed, registration_failed, registration_success, and type on Radar.CustomerEvaluationUpdateParamslatest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCardservice_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCarddebit_agreement on V2.MoneyManagement.ReceivedCredit.stripe_balance_paymentchaps on enum V2.FinancialAddressCreditSimulationCreditParams.networkcanonical_path on EventsV2CoreHealthTrafficVolumeDropFiringEvent.impact and EventsV2CoreHealthTrafficVolumeDropResolvedEvent.impactPaymentIntentExpiredEvent with resource PaymentIntentV2CoreHealthElementsErrorFiringEvent, V2CoreHealthElementsErrorResolvedEvent, V2CoreHealthInvoiceCountDroppedFiringEvent, and V2CoreHealthInvoiceCountDroppedResolvedEventSee the changelog for more details.
accounts.retrieveSee the changelog for more details.
See the changelog for more details.
Adds V2List and V2ListPromise types to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes…
This release changes the pinned API version to 2026-05-27.dahlia.
V2.Commerce.ProductCatalogImportcreate and retrieve methods on resource V2.Commerce.ProductCatalogImportbizum_payments and scalapay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesautomatic_transfer_rules_by_currency on BalanceSettingUpdateParams.payments.payouts and BalanceSettings.payments.payoutsstart_of_day on BalanceSettingUpdateParams.payments.settlement_timing and BalanceSettings.payments.settlement_timingdescription on ChargeCreateParams.transfer_data, PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_databizum on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethod, PaymentRecord.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, and SetupIntentUpdateParams.payment_method_optionsscalapay on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethod, PaymentRecord.payment_method_details, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datamandate on Charge.payment_method_details.twint, PaymentAttemptRecord.payment_method_details.twint, and PaymentRecord.payment_method_details.twintbizum and scalapay on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_typesCheckout.SessionCreateParams.payment_method_options.twint.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.twint.setup_future_usage, PaymentIntentCreateParams.payment_method_options.twint.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')bizum and scalapay on enum Checkout.SessionCreateParams.payment_method_typesCheckout.Session.payment_method_options.twint.setup_future_usage and PaymentIntent.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')bizum and scalapay on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typebizum and scalapay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typebizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typecredited_items on InvoiceItem.proration_detailstwint on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesdiscountable on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]billing_schedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscriptionmax_billed_until on enums InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_atamount_paid_off_stripe on Invoicetwint on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typestwint on Mandate.payment_method_details and SetupAttempt.payment_method_detailsmetadata on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, PaymentIntentUpdateParams.transfer_data, and Subscription.pending_updatepayment_data on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_databizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesblik_authorize on PaymentIntent.next_action and SetupIntent.next_actionpayment_method_options on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLinkbizum on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_typesbizum on enum PaymentLink.payment_method_typesactive on PaymentMethodConfigurationListParamsbilled_until on SubscriptionItemdiscount and discounts on Subscription.pending_updateverifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationsimulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.ReaderListParams.device_typeapi_error and print_content on Terminal.Reader.actionprint_content on enum Terminal.Reader.action.typesimulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.Reader.device_typecustomer on TestHelpers.TestClockCreateParams2026-05-27.dahlia on enum WebhookEndpointCreateParams.api_versionsigner on V2.Core.Account.identity.business_details.documents.proof_of_registration, V2.Core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_registration, and V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownershipazure_event_grid on V2.Core.EventDestinationCreateParams and V2.Core.EventDestinationno_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reasonazure_event_grid on enum V2.Core.EventDestination.typeazure_event_grid on enum V2.Core.EventDestinationCreateParams.typemeter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].codeV2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImportpayment_method_microdeposit_processing_error and siret_invalid on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorstripe-notify header is present in responseV2List and V2ListPromise types to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes. These fields will be removed in the next major release.// ❌ Before (v22.0.0-v22.1.1)
const oAuthToken: Stripe.OAuthToken = {};
// ✅ After (works on v22.1.2+)
const oAuthToken: Stripe.OAuthToken = {};
Stripe.V2.Core.AccountCreateParams.Configuration, Stripe.V2.Core.AccountCreateParams.Dashboard) are now accessible.See the changelog for more details.
Add support for new resources V2.Commerce.ProductCatalogImport, V2.Data.Reporting.QueryRun, V2.Extend.WorkflowRun, V2.Extend.Workflow, V2.Iam.Activity
V2.Commerce.ProductCatalogImport, V2.Data.Reporting.QueryRun, V2.Extend.WorkflowRun, V2.Extend.Workflow, V2.Iam.ActivityLog, V2.Network.BusinessProfile, and V2.OrchestratedCommerce.Agreementconfirm, create, list, retrieve, and terminate methods on resource V2.OrchestratedCommerce.Agreementme and retrieve methods on resource V2.Network.BusinessProfilelist method on resource V2.Iam.ActivityLoglist and retrieve methods on resource V2.Extend.WorkflowRuninvoke, list, and retrieve methods on resource V2.Extend.Workflowcreate and retrieve methods on resources V2.Commerce.ProductCatalogImport and V2.Data.Reporting.QueryRunV2.Billing.Cadence.settings_data.collection.payment_method_options.konbini, V2.Billing.CollectionSetting.payment_method_options.konbini, V2.Billing.CollectionSettingCreateParams.payment_method_options.konbini, V2.Billing.CollectionSettingUpdateParams.payment_method_options.konbini, and V2.Billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an objectV2.Billing.Cadence.settings_data.collection.payment_method_options.sepa_debit, V2.Billing.CollectionSetting.payment_method_options.sepa_debit, V2.Billing.CollectionSettingCreateParams.payment_method_options.sepa_debit, V2.Billing.CollectionSettingUpdateParams.payment_method_options.sepa_debit, and V2.Billing.CollectionSettingVersion.payment_method_options.sepa_debit from map(string: dynamic) to an objectcn_bank_account and jp_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typefutsu and toza on enums V2.Core.Vault.GbBankAccount.bank_account_type and V2.MoneyManagement.PayoutMethod.bank_account.bank_account_typeV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_processing from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_queued from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_succeeded from map(string: dynamic) to an objectpayout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reasoninbound_transfer_reversal, outbound_payment_reversal, outbound_transfer_reversal, received_credit_reversal, received_debit_reversal, and stripe_fee_tax on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryreturn from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryfutsu and toza on enums V2.Core.Vault.GbBankAccountCreateParams.bank_account_type, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bank_account_type, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bank_account_typeV2.Core.BatchJobCreateParams.endpoint.http_method from literal('post') to enum('delete'|'post')meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].codetreasury_transaction on EventsV2MoneyManagementTransactionCreatedEventV2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImportV2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2.Data.Reporting.QueryRunV2ExtendWorkflowRunFailedEvent, V2ExtendWorkflowRunStartedEvent, and V2ExtendWorkflowRunSucceededEvent with related object V2.Extend.WorkflowRunV2OrchestratedCommerceAgreementConfirmedEvent, V2OrchestratedCommerceAgreementCreatedEvent, V2OrchestratedCommerceAgreementPartiallyConfirmedEvent, and V2OrchestratedCommerceAgreementTerminatedEvent with related object V2.OrchestratedCommerce.AgreementCannotProceedErrorThis release changes the pinned API version to 2026-04-22.private.
This release changes the pinned API version to 2026-04-22.private.
SharedPayment.GrantedToken and SharedPayment.IssuedTokenretrieve method on resource SharedPayment.GrantedTokencreate and revoke test helper methods on resource SharedPayment.GrantedTokencreate, retrieve, and revoke methods on resource SharedPayment.IssuedTokenblik on Checkout.SessionCreateParams.payment_method_options, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsfo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].typeCheckout.Session.managed_payments, PaymentIntent.managed_payments, PaymentLink.managed_payments, and Subscription.managed_payments to be requiredshared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataInvoice.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, and Subscription.payment_settings.payment_method_options.pix to be requiredInvoice.payment_settings.payment_method_options.upi, QuotePreviewInvoice.payment_settings.payment_method_options.upi, and Subscription.payment_settings.payment_method_options.upi to be requiredfo_vat, gi_tin, it_cf, and py_ruc on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typevalidation_errors on Privacy.RedactionJobtax_details on Productblik on enum QuotePreviewInvoice.payment_settings.payment_method_typesQuotePreviewInvoice.total_taxes[].tax_rate_details.tax_rate from string to expandable(TaxRate)Radar.PaymentEvaluation.client_device_metadata_details.radar_session from string to string | nullSetupIntent.next_action.pix_display_qr_code.data to be requiredSetupIntent.next_action.pix_display_qr_code.expires_at to be requiredSetupIntent.next_action.pix_display_qr_code.hosted_instructions_url to be requiredSetupIntent.next_action.pix_display_qr_code.image_url_png to be requiredSetupIntent.next_action.pix_display_qr_code.image_url_svg to be requiredadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.RegistrationCreateParams.country_options.uspurpose on Treasury.OutboundPaymentCreateParams and Treasury.OutboundPaymentaction_blocked and approval_required on QuotePreviewInvoice.last_finalization_errorAdd support for new resource PaymentLocationCapability
PaymentLocationCapabilitylist, retrieve, and update methods on resource PaymentLocationCapabilityclose and simulate_network_lifecycle_dispute_response test helper methods on resource Issuing.DisputeDelegatedCheckout.RequestedSessionUpdateParams.discounts.codes from array(string) to emptyable(array(string))credited_items on InvoiceItem.proration_detailsbalance_response on Issuing.Authorizationpayment_evaluations on PaymentAttemptRecordReportCanceledParams, PaymentAttemptRecordReportFailedParams, PaymentRecordReportPaymentAttemptCanceledParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams.failed, and PaymentRecordReportPaymentParams.failedenabled on PaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucheradvanced_feature_details and allowed_payment_method_types on PaymentIntentPaymentLocationUpdateParams.address.city from string to emptyable(string)PaymentLocationUpdateParams.address.line1 from string to emptyable(string)PaymentLocationUpdateParams.address.line2 from string to emptyable(string)PaymentLocationUpdateParams.address.postal_code from string to emptyable(string)PaymentLocationUpdateParams.address.state from string to emptyable(string)SubscriptionPauseParams.type to be optionalpayment_behavior on SubscriptionResumeParamsstatus_details on SubscriptionAdd support for new resources V2.Core.FeeBatch, V2.Core.FeeEntry, V2.MoneyManagement.DebitDispute, and V2.MoneyManagement.FinancialAccountStatement
V2.Core.FeeBatch, V2.Core.FeeEntry, V2.MoneyManagement.DebitDispute, and V2.MoneyManagement.FinancialAccountStatementsimulate_network_lifecycle_pre_arbitration_response and simulate_network_lifecycle_pre_arbitration_submission test helper methods on resource Issuing.Disputelist method on resource PaymentLocationlist and retrieve methods on resources V2.Core.FeeBatch, V2.Core.FeeEntry, and V2.MoneyManagement.FinancialAccountStatementcreate, list, and retrieve methods on resource V2.MoneyManagement.DebitDisputediscounts on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSessionamount_sale on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_detailsamount_discount and breakdown on DelegatedCheckout.RequestedSession.total_detailscheck_deposit_address on Invoice.payment_settings.payment_method_options.check_scan, InvoiceCreateParams.payment_settings.payment_method_options.check_scan, InvoiceUpdateParams.payment_settings.payment_method_options.check_scan, QuotePreviewInvoice.payment_settings.payment_method_options.check_scan, Subscription.payment_settings.payment_method_options.check_scan, SubscriptionCreateParams.payment_settings.payment_method_options.check_scan, and SubscriptionUpdateParams.payment_settings.payment_method_options.check_scanpayment_evaluations on PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.guaranteed, and PaymentRecordReportPaymentParams.guaranteedlocation on PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, PaymentIntentUpdateParams.payment_details, SetupIntentConfirmParams.setup_details, SetupIntentCreateParams.setup_details, and SetupIntentUpdateParams.setup_detailsonboarding_data_update_acknowledged on PaymentLocationUpdateParamsPaymentLocationCreateParams.address.country and PaymentLocationUpdateParams.address.country to be optionalcustomer on Radar.CustomerEvaluationUpdateParamsstatus on Radar.CustomerEvaluationUpdateParams and Radar.CustomerEvaluationRadar.CustomerEvaluationUpdateParams.type to be optionalpayment_behavior on SubscriptionResumeParamsdispute_details on V2.MoneyManagement.ReceivedDebitdebit_dispute on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categorydebit_dispute on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowdebit_dispute on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typepayment_attempt_record on EventsV2PaymentsOffSessionPaymentAttemptFailedEvent and EventsV2PaymentsOffSessionPaymentFailedEventV2MoneyManagementFinancialAccountStatementCreatedEvent and V2MoneyManagementFinancialAccountStatementRestatedEvent with related object V2.MoneyManagement.FinancialAccountStatementAdd support for new resource PaymentLocation
PaymentLocationcreate, del, retrieve, and update methods on resource PaymentLocationprotections on AccountCreateParams.capabilities.card_payments, AccountUpdateParams.capabilities.card_payments, and Capabilitygift_card on ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, and SharedPayment.GrantedToken.payment_method_detailsgift_card on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typegift_card on enums ConfirmationToken.payment_method_preview.type, PaymentMethod.type, and SharedPayment.GrantedToken.payment_method_details.typegift_card on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typemetadata on DelegatedCheckout.RequestedSessionConfirmParamscredited_items on InvoiceItem.proration_detailsnetwork_lifecycle on Issuing.Disputegift_card on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_typesgift_card on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesstatus_details on SubscriptionAdd support for debit_card on V2.Core.Account.configuration.card_creator.capabilities.consumer.lead, V2.Core.Account.identity.attestations.terms_of_se
debit_card on V2.Core.Account.configuration.card_creator.capabilities.consumer.lead, V2.Core.Account.identity.attestations.terms_of_service.card_creator.consumer.lead, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.consumer.lead, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.consumer.leadconsumer.lead.debit_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilityconsumer.lead.debit_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability…from PaymentFlowsPrivatePaymentMethodsGiftCardDeprecatedDetailsResourceBalanceAmount to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodGiftCardD…
V2.Data.Analytics.MetricQueryResultcreate, retrieve, and revoke methods on resource SharedPayment.IssuedTokencreate method on resource V2.Data.Analytics.MetricQueryResultapp_distribution and sunbit_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesbalance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.componentsfee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.typesunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataphantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currencylast4 on Charge.payment_method_details.gift_card, PaymentAttemptRecord.payment_method_details.gift_card, and PaymentRecord.payment_method_details.gift_cardlocation and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarnasunbit on enum Checkout.SessionCreateParams.excluded_payment_method_typesblik on Checkout.SessionCreateParams.payment_method_options, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionssunbit on enum Checkout.SessionCreateParams.payment_method_typesfo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typeCheckout.Session.managed_payments, PaymentIntent.managed_payments, PaymentLink.managed_payments, and Subscription.managed_payments to be requiredshared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datasunbit on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typesunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeCreditNote.total_taxes[].tax_rate_details.tax_rate, CreditNoteLineItem.taxes[].tax_rate_details.tax_rate, Invoice.total_taxes[].tax_rate_details.tax_rate, InvoiceLineItem.taxes[].tax_rate_details.tax_rate, and QuotePreviewInvoice.total_taxes[].tax_rate_details.tax_rate from string to expandable(TaxRate)fo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typesunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typebuyer_consents on DelegatedCheckout.RequestedSessionConfirmParamsconsents on DelegatedCheckout.RequestedSession.buyer_consents.marketingblik on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesblik on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typesInvoice.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, and Subscription.payment_settings.payment_method_options.pix to be requiredInvoice.payment_settings.payment_method_options.upi, QuotePreviewInvoice.payment_settings.payment_method_options.upi, and Subscription.payment_settings.payment_method_options.upi to be requiredpayment_facilitator_id and sub_merchant_id on Issuing.AuthorizationCreateParams.testHelpers.merchant_data, Issuing.TransactionCreateForceCaptureParams.testHelpers.merchant_data, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.merchant_datacard_presence on Issuing.Authorizationallowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controlsfulfillment_error on enum Issuing.Card.cancellation_reasonfulfillment_error on enum Issuing.Card.replacement_reasonPaymentAttemptRecord.payment_method_details.gift_card.balance and PaymentRecord.payment_method_details.gift_card.balance from PaymentFlowsPrivatePaymentMethodsGiftCardDeprecatedDetailsResourceBalanceAmount to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodGiftCardDetailsResourceBalance | nullPaymentAttemptRecord.payment_method_details.gift_card.brand and PaymentRecord.payment_method_details.gift_card.brand from enum('fiserv_valuelink'|'givex'|'svs') to enum('fiserv_valuelink'|'givex'|'svs') | nullPaymentAttemptRecord.payment_method_details.gift_card.first6 and PaymentRecord.payment_method_details.gift_card.first6 from string to string | nullPaymentAttemptRecord.payment_method_details.gift_card.transaction_id and PaymentRecord.payment_method_details.gift_card.transaction_id from string to string | nullsunbit on enums PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_typesamount_to_confirm on PaymentIntentConfirmParamssunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesklarna_display_qr_code on PaymentIntent.next_actionsunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_typessunbit on enum PaymentLink.payment_method_typesvalidation_errors on Privacy.RedactionJobtax_details on ProductRadar.PaymentEvaluation.client_device_metadata_details.radar_session from string to string | nulllow, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_levelaccount on enum Radar.ValueListCreateParams.item_typeaccount on enum Radar.ValueList.item_typemoto on SetupAttempt.payment_method_details.cardSetupIntent.next_action.pix_display_qr_code.data to be requiredSetupIntent.next_action.pix_display_qr_code.expires_at to be requiredSetupIntent.next_action.pix_display_qr_code.hosted_instructions_url to be requiredSetupIntent.next_action.pix_display_qr_code.image_url_png to be requiredSetupIntent.next_action.pix_display_qr_code.image_url_svg to be requiredadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.RegistrationCreateParams.country_options.uspurpose on Treasury.OutboundPaymentCreateParams and Treasury.OutboundPayment2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_versioncrypto_wallet on V2.MoneyManagement.FinancialAddress.credentialsmx_bank_account on V2.MoneyManagement.FinancialAddress.credentials and V2.MoneyManagement.ReceivedCredit.bank_transfercrypto_wallet and mx_bank_account on enum V2.MoneyManagement.FinancialAddress.credentials.typecrypto_wallet_transfer on V2.MoneyManagement.ReceivedCrediteu_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transfercrypto_wallet, eu_bank_account, and mx_bank_account on enum V2.MoneyManagement.ReceivedCredit.bank_transfer.origin_typecrypto_wallet_transfer on enum V2.MoneyManagement.ReceivedCredit.typeV2.Payments.OffSessionPaymentCaptureParams.metadata and V2.Payments.OffSessionPaymentCreateParams.metadata to be optionalcrypto_properties and settlement_currency on V2.MoneyManagement.FinancialAddressCreateParamscrypto_wallet and mx_bank_account on enum V2.MoneyManagement.FinancialAddressCreateParams.typeV2CoreApprovalRequestCreatedEvent and V2CoreApprovalRequestExpiredEvent with related object V2.Core.ApprovalRequestV2ExtendExtensionRunFailedEventaction_blocked and approval_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorThis release changes the pinned API version to 2026-04-22.private.
This release changes the pinned API version to 2026-04-22.private.
V2.Commerce.ProductCatalogImport, V2.Core.ApprovalRequest, V2.Extend.WorkflowRun, V2.Extend.Workflow, V2.Iam.ActivityLog, V2.Network.BusinessProfile, and V2.OrchestratedCommerce.AgreementV2.Core.WorkflowRun and V2.Core.Workflowconfirm, create, list, retrieve, and terminate methods on resource V2.OrchestratedCommerce.Agreementme and retrieve methods on resource V2.Network.BusinessProfilelist method on resource V2.Iam.ActivityLoglist and retrieve methods on resource V2.Extend.WorkflowRuninvoke, list, and retrieve methods on resource V2.Extend.Workflowcancel, execute, list, retrieve, and submit methods on resource V2.Core.ApprovalRequestcreate and retrieve methods on resource V2.Commerce.ProductCatalogImportlist and retrieve methods on resource V2.Core.WorkflowRuninvoke, list, and retrieve methods on resource V2.Core.Workflowrenew_onboarding_link method on resource V2.Core.ClaimableSandboxcustomer on SharedPayment.IssuedTokenSharedPayment.IssuedToken.payment_method from string | null to stringbill_management and send_money on AccountSession.components.bills.featuresgift_card on Charge.payment_method_details, PaymentAttemptRecord.payment_method_details, and PaymentRecord.payment_method_detailscustom_payment_method_types on Checkout.SessionCreateParams and Checkout.Sessionpayment_record on Checkout.Sessionshared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentIntent, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapayment_method on ConfirmationToken.payment_method_preview.sepa_debit.generated_from, PaymentMethod.sepa_debit.generated_from, and SharedPayment.GrantedToken.payment_method_details.sepa_debit.generated_fromDelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].type, DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option.type, DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option_overrides[].type, DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option.type, and DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option_overrides[].type from string to enum('digital'|'shipping')return_url on DelegatedCheckout.RequestedSessionConfirmParamsbuyer_consents on DelegatedCheckout.RequestedSessioncrypto_transactions on Issuing.Authorization, Issuing.Dispute, and Issuing.Transactionpayment_facilitator_id and sub_merchant_id on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_dataidentifiers on OrderCreateParams.line_items[].product_data, OrderUpdateParams.line_items[].product_data, ProductCreateParams, ProductUpdateParams, and Productagent_details on PaymentIntentexternal_reference on PriceCreateParams and PriceUpdateParamslogin_succeeded and registration_succeeded on Radar.AccountEvaluation.events[] and Radar.AccountEvaluationUpdateParamsprint_content on Terminal.Reader.actionprint_content on enum Terminal.Reader.action.typecn_bank_account and jp_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typebm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enum V2.Core.Account.identity.business_details.id_numbers[].typebm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.identity.individual.id_numbers[].type and V2.Core.AccountPerson.id_numbers[].typeapp_channel on V2.Core.ClaimableSandboxCreateParams and V2.Core.ClaimableSandboxonboarding_link_details and owner_details on V2.Core.ClaimableSandboxclaim_url on V2.Core.ClaimableSandboxowner_account on V2.Core.ClaimableSandbox.sandbox_detailslive on enum V2.Core.ClaimableSandbox.statussnapshot_event on V2.Core.Eventfutsu and toza on enums V2.Core.Vault.GbBankAccount.bank_account_type and V2.MoneyManagement.PayoutMethod.bank_account.bank_account_typeV2.MoneyManagement.CurrencyConversion.financial_account to be optionalmultiprocessor_settlement on V2.MoneyManagement.FinancialAccountmultiprocessor_settlement on enum V2.MoneyManagement.FinancialAccount.typeca_bank_account on V2.MoneyManagement.FinancialAddress.credentials and V2.MoneyManagement.ReceivedCredit.bank_transferca_bank_account on enum V2.MoneyManagement.FinancialAddress.credentials.typetempo on enum V2.MoneyManagement.PayoutMethod.crypto_wallet.networkca_bank_account on enum V2.MoneyManagement.ReceivedCredit.bank_transfer.origin_typereturn from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryamount_details and payment_details on V2.Payments.OffSessionPaymentCaptureParams, V2.Payments.OffSessionPaymentCreateParams, and V2.Payments.OffSessionPaymentdescription on V2.Payments.OffSessionPaymentCreateParams and V2.Payments.OffSessionPaymentacss on enum V2.FinancialAddressCreditSimulationCreditParams.networkmcc on V2.Payments.OffSessionPaymentCreateParams.payment_method_options.cardV2.Payments.OffSessionPaymentCreateParams.payment_method_options.card.network_transaction_id to be optionalfutsu and toza on enums V2.Core.Vault.GbBankAccountCreateParams.bank_account_type, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bank_account_type, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bank_account_typetempo on enum V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.crypto_wallet.networkcredentials.ca_bank_account.account_number on enums V2.MoneyManagement.FinancialAddressListParams.include and V2.MoneyManagement.FinancialAddressRetrieveParams.includeca_bank_account on enum V2.MoneyManagement.FinancialAddressCreateParams.typemultiprocessor_settlement on enum V2.MoneyManagement.FinancialAccountListParams.typesstorage on V2.MoneyManagement.FinancialAccountUpdateParamsfx_quote on V2.MoneyManagement.CurrencyConversionCreateParamsV2.MoneyManagement.CurrencyConversionCreateParams.financial_account to be optionalonboarding_link_details on V2.Core.ClaimableSandboxCreateParamsV2.Core.BatchJobCreateParams.endpoint.http_method from literal('post') to enum('delete'|'post')bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typebm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].typemeter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].codetreasury_transaction on EventsV2MoneyManagementTransactionCreatedEventV1AccountApplicationAuthorizedEvent, V1AccountApplicationDeauthorizedEvent, V1AccountExternalAccountCreatedEvent, V1AccountExternalAccountDeletedEvent, V1AccountExternalAccountUpdatedEvent, V1BillingPortalSessionCreatedEvent, V1EntitlementsActiveEntitlementSummaryUpdatedEvent, V2CoreHealthMeterEventSummariesDelayedFiringEvent, and V2CoreHealthMeterEventSummariesDelayedResolvedEventV1AccountUpdatedEvent with related object AccountV1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFeeV1ApplicationFeeRefundUpdatedEvent with related object FeeRefundV1BalanceAvailableEvent with related object BalanceV1BillingAlertTriggeredEvent with related object Billing.AlertV1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.ConfigurationV1CapabilityUpdatedEvent with related object CapabilityV1CashBalanceFundsAvailableEvent with related object CashBalanceV1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object ChargeV1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object DisputeV1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object RefundV1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.SessionV1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.OrderV1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.ProductV1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object CouponV1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNoteV1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object CustomerV1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object SubscriptionV1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxIdV1CustomerCashBalanceTransactionCreatedEvent with related object CustomerCashBalanceTransactionV1FileCreatedEvent with related object FileV1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object FinancialConnections.AccountV1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSessionV1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object InvoiceV1InvoicePaymentPaidEvent with related object InvoicePaymentV1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItemV1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.AuthorizationV1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.CardV1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.CardholderV1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.DisputeV1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesignV1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.TokenV1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.TransactionV1MandateUpdatedEvent with related object MandateV1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntentV1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLinkV1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethodV1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object PayoutV1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object PersonV1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object PlanV1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object PriceV1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object ProductV1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCodeV1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object QuoteV1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarningV1ReviewClosedEvent and V1ReviewOpenedEvent with related object ReviewV1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntentV1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRunV1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object SourceV1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionScheduleV1TaxSettingsUpdatedEvent with related object Tax.SettingsV1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRateV1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.ReaderV1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClockV1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object TopupV1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object TransferV2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImportV2CoreApprovalRequestApprovedEvent, V2CoreApprovalRequestCanceledEvent, V2CoreApprovalRequestFailedEvent, V2CoreApprovalRequestRejectedEvent, and V2CoreApprovalRequestSucceededEvent with related object V2.Core.ApprovalRequestV2CoreClaimableSandboxUpdatedEvent with related object V2.Core.ClaimableSandboxV2ExtendWorkflowRunFailedEvent, V2ExtendWorkflowRunStartedEvent, and V2ExtendWorkflowRunSucceededEvent with related object V2.Extend.WorkflowRunV2OrchestratedCommerceAgreementConfirmedEvent, V2OrchestratedCommerceAgreementCreatedEvent, V2OrchestratedCommerceAgreementPartiallyConfirmedEvent, and V2OrchestratedCommerceAgreementTerminatedEvent with related object V2.OrchestratedCommerce.AgreementV2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent with related object V2.Core.ClaimableSandboxFxQuoteExpiredErrorinvalid_workflow_input_parameters and workflow_not_invokable on CannotProceedErrorAdded Stripe.Decimal as a usable type in the Stripe namespace, enabling type annotations like function takesDecimal(d: Stripe.Decimal).
#2703 Export Decimal type from Stripe namespace
Stripe.Decimal as a usable type in the Stripe namespace, enabling type annotations like function takesDecimal(d: Stripe.Decimal).#2704 Fix file upload regression: restore multipart request data processor
StripeInvalidRequestError on the /v1/files endpoint since v22.This release changes the pinned API version to 2026-04-22.dahlia.
This release changes the pinned API version to 2026-04-22.dahlia.
app_distribution and sunbit_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesbalance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.componentsfee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.typesunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataphantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currencylocation and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarnamandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pixmanaged_payments on Checkout.SessionCreateParams, Checkout.Session, PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, and Subscriptionsunbit on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_typesmandate_options on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pixCheckout.SessionCreateParams.payment_method_options.pix.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage, PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')sunbit on enum Checkout.SessionCreateParams.payment_method_typesfo_vat, gi_tin, it_cf, and py_ruc on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typeCheckout.Session.payment_method_options.pix.setup_future_usage and PaymentIntent.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')sunbit on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typesunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typefo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typesunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typepix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsupi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionspix and upi on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typespix and upi on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typescard_presence on Issuing.Authorizationallowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controlsfulfillment_error on enum Issuing.Card.cancellation_reasonfulfillment_error on enum Issuing.Card.replacement_reasonamount and currency on Mandate.multi_useamount_to_confirm on PaymentIntentConfirmParamssunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesklarna_display_qr_code on PaymentIntent.next_actionsunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_typessunbit on enum PaymentLink.payment_method_typeslow, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_levelaccount on enum Radar.ValueListCreateParams.item_typeaccount on enum Radar.ValueList.item_typemoto on SetupAttempt.payment_method_details.cardpix_display_qr_code on SetupIntent.next_action2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_versionaction_blocked and approval_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorPlease review the changelog for 22.0.2 for more information about changes in this release.
Please review the changelog for 22.0.2 for more information about changes in this release.
Please review the changelog for 22.0.1 for more information about changes in this release.
Please review the changelog for 22.0.1 for more information about changes in this release.
Please review the changelog for 22.0.0 for more information about changes in this release.
Please review the changelog for 22.0.0 for more information about changes in this release.
Add support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCardservice_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCardV2.Core.WorkflowRun and V2.Core.Workflowreport_authorized method on resource PaymentAttemptRecordlist and retrieve methods on resource V2.Core.WorkflowRuninvoke, list, and retrieve methods on resource V2.Core.Workflownext_action and status on SharedPayment.IssuedTokennetwork_id on SharedPayment.IssuedToken.seller_detailsbills on AccountSession.componentssettlement_currencies on BalanceSettingUpdateParams.payments and BalanceSettings.paymentsdefault_settlement_currency on BalanceSettings.paymentsaccount_funding on Charge.payment_method_details.cardautomatic_surcharge on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLinkbizum on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_optionssurcharge_cost on Checkout.Sessionamount_surcharge on Checkout.Session.total_detailsshared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataemail on enums Identity.VerificationReportListParams.type, Identity.VerificationSessionCreateParams.type, and Identity.VerificationSessionUpdateParams.typedetails on Identity.VerificationReport.emailemail on enums Identity.VerificationReport.type and Identity.VerificationSession.typeconfirm on Identity.VerificationSessionCreateParams and Identity.VerificationSessionUpdateParamssubscription on InvoiceItem.parent.schedule_detailsshared_payment_granted_token on PaymentIntentConfirmParams and PaymentIntentCreateParamsmoney_services on PaymentIntent.payment_detailsexternal_reference on PlanSharedPayment.GrantedToken.payment_method_details.billing_details to be requiredAdd support for payment_record on ApplicationFee.fee_source
payment_record on ApplicationFee.fee_sourcebeneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParams.payment_details.money_services.account_funding, ChargeUpdateParams.payment_details.money_services.account_funding, PaymentIntentCaptureParams.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_fundingChargeCaptureParams.payment_details.money_services.transaction_type, ChargeUpdateParams.payment_details.money_services.transaction_type, PaymentIntentCaptureParams.payment_details.money_services.transaction_type, PaymentIntentConfirmParams.payment_details.money_services.transaction_type, PaymentIntentCreateParams.payment_details.money_services.transaction_type, and PaymentIntentUpdateParams.payment_details.money_services.transaction_type from literal('account_funding') to emptyable(literal('account_funding'))bizum on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsbizum on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesquantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParams.amount_details.line_items[], PaymentIntentConfirmParams.amount_details.line_items[], PaymentIntentCreateParams.amount_details.line_items[], PaymentIntentDecrementAuthorizationParams.amount_details.line_items[], PaymentIntentIncrementAuthorizationParams.amount_details.line_items[], and PaymentIntentUpdateParams.amount_details.line_items[]liquid_asset and wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_fundingshared_payment_granted_token on PaymentMethodRadar.CustomerEvaluation.event_type from string to enum('login'|'registration')Radar.CustomerEvaluation.signals.account_sharing.risk_level and Radar.CustomerEvaluation.signals.multi_accounting.risk_level from string to enumdata on Radar.PaymentEvaluation.client_device_metadata_details and Radar.PaymentEvaluationCreateParams.client_device_metadata_detailssunbit on SharedPayment.GrantedToken.payment_method_detailssunbit on enum SharedPayment.GrantedToken.payment_method_details.typebm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin from enums V2.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, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typebm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp from enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].typeCannotProceedErrorThis release changes the pinned API version to 2026-04-01.preview and contains additional breaking changes. See the GA changelog for more information.
This release changes the pinned API version to 2026-04-01.preview and contains additional breaking changes. See the GA changelog for more information.
SharedPayment.IssuedToken and V2.Data.Reporting.QueryRuncreate and retrieve methods on resource V2.Data.Reporting.QueryRunpause and resume methods on resource V2.Payments.OffSessionPaymenttenant_keys, tenant_operator, and tenant_values on Billing.MeterListMeterEventSummariesParamsfleet_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentAmountDetailsLineItem.payment_method_options.card, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.card, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCreateParams.payment_details, PaymentIntentDecrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.card, and PaymentIntentUpdateParams.payment_detailsmoney_services on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_detailspayment_method_options on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSessionpayment_method_data on DelegatedCheckout.RequestedSessionConfirmParams, DelegatedCheckout.RequestedSessionCreateParams, and DelegatedCheckout.RequestedSessionUpdateParamscard_brands and payment_method_types on DelegatedCheckout.RequestedSession.seller_detailsDelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable(SharedPayment.IssuedToken)requires_action on enum DelegatedCheckout.RequestedSession.statuscheck_scan on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionscheck_scan on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesprocessor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.failed, PaymentRecordReportPaymentAttemptParams.guaranteed, PaymentRecordReportPaymentParams.failed, and PaymentRecordReportPaymentParams.guaranteedpayment_details on 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.cardbill_from on QuotePreviewSubscriptionSchedule.billing_schedules[], Subscription.billing_schedules[], and SubscriptionSchedule.billing_schedules[]agent_details, payment_method_details, and risk_details on SharedPayment.GrantedTokenpaper_checks on V2.Account.configuration.recipient_data.features, V2.AccountCreateParams.configuration.recipient_data.features, V2.AccountUpdateParams.configuration.recipient_data.features, V2.Core.Account.configuration.recipient.capabilities, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.recipient.capabilities, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountUpdateParams.configuration.recipient.capabilities, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_paymentspaper_checks on enum V2.Account.configuration.supportable_features.recipient_datapaper_checks on enum V2.Account.requirements[].impact.required_for_featuresV2.Billing.Cadence.settings_data.collection.payment_method_options.konbini, V2.Billing.CollectionSetting.payment_method_options.konbini, V2.Billing.CollectionSettingCreateParams.payment_method_options.konbini, V2.Billing.CollectionSettingUpdateParams.payment_method_options.konbini, and V2.Billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an objectV2.Billing.Cadence.settings_data.collection.payment_method_options.sepa_debit, V2.Billing.CollectionSetting.payment_method_options.sepa_debit, V2.Billing.CollectionSettingCreateParams.payment_method_options.sepa_debit, V2.Billing.CollectionSettingUpdateParams.payment_method_options.sepa_debit, and V2.Billing.CollectionSettingVersion.payment_method_options.sepa_debit from map(string: dynamic) to an objectid on V2.Billing.CadenceSpendModifier.max_billing_period_spend.amount.custom_pricing_unit, V2.Billing.IntentAction.apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit, and V2.Billing.IntentCreateParams.actions[].apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unitoutbound_payments.paper_checks and paper_checks on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitybm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.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, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typebm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].typeV2.Core.Event.reason.request.client.stripe_action from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_processing from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_queued from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_succeeded from map(string: dynamic) to an objectpaper_check_attachment_too_large, paper_check_expired, and paper_check_undeliverable on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reasontown on V2.MoneyManagement.OutboundPayment.tracking_details.paper_check.mailing_addressV2.MoneyManagement.OutboundPayment.delivery_options.paper_check.memo to be requiredpayout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reasonapplication_fee_amount_requested on V2.Payments.OffSessionPaymentcompartment_id on V2.Payments.OffSessionPaymentexceeded_retry_window on enum V2.Payments.OffSessionPayment.failure_reasonretry_until on V2.Payments.OffSessionPayment.retry_detailspaused on enum V2.Payments.OffSessionPayment.statusV2.Reporting.ReportRun.result.file to be optionalapplication_fee_amount on V2.Payments.OffSessionPaymentCaptureParams and V2.Payments.OffSessionPaymentCreateParamspaper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityoutbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilityalert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEventapi_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEventstripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEventV2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2.Data.Reporting.QueryRunV2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object V2.Payments.OffSessionPaymentAdded emitEventBodies config option to include request and response bodies in request/response events.
parseEventNotificationAsync to match existing sync functionemitEventBodies config option to include request and response bodies in request/response events.httpClient config type from HttpClient class to HttpClientInterface interface.// ✅ Fixed
import { Stripe } from 'stripe';
Initialization of Stripe class with new keyword is now possible for CJS based TypeScript project. Resolves: 2660 `ts import Stripe = require('stripe')
new keyword is now possible for CJS based TypeScript project. Resolves: 2660import Stripe = require('stripe');
// ✅ Both statements work
const stripeNew: Stripe.Stripe = new Stripe('sk_test_...');
const stripeCalled: Stripe.Stripe = Stripe('sk_test_...');
Stripe constructor config parameter to use StripeConfig type instead of Record<string, unknown>, restoring compile-time type safety.authenticator property to StripeConfig.Stripe.API_VERSION to retain the literal API version type.StripeConfig.stripeContext to accept StripeContext objects in addition to strings.rawRequest with absolute urlsstring[] to WebhookHeader type for compatibility with express
string[] to the type of signature param in stripe.webhooks.construct_event method.This release uses the same pinned API version to 2026-03-25.dahlia as the last major release. The breaking changes in this release are prefixed with ⚠…
This release uses the same pinned API version to 2026-03-25.dahlia as the last major release. The breaking changes in this release are prefixed with ⚠️ below. There's also a detailed migration guide to simplify your upgrade process.
Stripe.StripeContext is no longer exported as a type. Use Stripe.StripeContextType instead.Stripe.errors.StripeError is no longer a type. Use typeof Stripe.errors.StripeError or Stripe.ErrorType instead.new Stripe() to create a StripeClient instead of calling it:// Before
const stripeClient = Stripe("sk_test_...");
// After
const stripeClient = new Stripe("sk_test_...");
#2645 ⚠️ Remove stripeMethod and standardize how function args are handled (including removing callback support)
async / await insteadRequestOptions under the apiKey propertyparams and options objects are no longer mixed. If present on a method, RequestParams must always come first and RequestOptions must always come second. To supply options without params, pass undefined as the first argument explicitlyStripeResource: createFullPath, createResourcePathWithSymbols, extend, method and _joinUrlParts. These were mostly intended for internal use and we no longer need themAs a result, the following call patterns are no longer supported:
stripe.customers.retrieve('cus_123', 'sk_test_123')
stripe.customers.create({name: 'david', host: 'example.com'}, 'sk_test_123')
stripe.customers.create({apiKey: 'sk_test_123'})
stripe.customers.list(customers => {
// do something with customers
})
#2643 ⚠️ Removed per-request host override. To use a custom host, set it in the client configuration. All requests from that client will use that host.
Before:
import Stripe from 'stripe';
const stripe = new Stripe('sk_test_...');
const customer = await stripe.customers.create({
email: 'customer@example.com',
}, {host: 'example.com'});
After:
import Stripe from 'stripe';
const stripe = new Stripe('sk_test_...', {host: 'example.com'});
// goes to example.com
const customer = await stripe.customers.create({
email: 'customer@example.com',
});
#2638 Converted V2/Amount.ts to V2/V2Amount.ts
See the changelog for more details.
This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 21.0.0 which contains breaking changes. Please re…
This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 21.0.0 which contains breaking changes. Please review the changelog for 21.0.0 if upgrading from older SDK versions.
ProductCatalog.TrialOffer, Tax.Location, and V2.Core.BatchJobcreate method on resource ProductCatalog.TrialOffercreate, list, and retrieve methods on resource Tax.Locationcancel, create, and retrieve methods on resource V2.Core.BatchJobperformance_location on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItemperformance on enums Tax.Calculation.shipping_cost.tax_breakdown[].sourcing, Tax.CalculationLineItem.tax_breakdown[].sourcing, and Tax.Transaction.shipping_cost.tax_breakdown[].sourcingadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typetrial_offer on InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set, InvoiceCreatePreviewParams.schedule_details.phases[].items[], QuoteCreateParams.lines[].actions[].add_item, QuoteCreateParams.lines[].actions[].set_items[], QuoteLine.actions[].add_item, QuoteLine.actions[].set_items[], QuotePreviewSubscriptionSchedule.phases[].items[], QuoteUpdateParams.lines[].actions[].add_item, QuoteUpdateParams.lines[].actions[].set_items[], SubscriptionSchedule.phases[].items[], SubscriptionScheduleAmendParams.amendments[].item_actions[].add, SubscriptionScheduleAmendParams.amendments[].item_actions[].set, SubscriptionScheduleCreateParams.phases[].items[], and SubscriptionScheduleUpdateParams.phases[].items[]risk_reserved on Balancesource_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balancetax_details on Checkout.SessionCreateParams.line_items[].price_data.product_data, Checkout.SessionUpdateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, PlanCreateParams.product[0], PriceCreateParams.product_data, ProductCreateParams, and ProductUpdateParamspending_invoice_item_interval on Checkout.SessionUpdateParams.subscription_datahosted and ui_mode on FinancialConnections.SessionCreateParams and FinancialConnections.Sessionurl on FinancialConnections.Sessionexpires_after_seconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pixcurrent_trial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_detailsamount_details and payment_details on PaymentIntentDecrementAuthorizationParamsmandate_options on PaymentIntent.payment_method_options.stripe_balancemanaged_payments on PaymentLinkCreateParams and PaymentLinkstripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionsbilling_cycle_anchor on Subscription.trial_settings.end_behavior, SubscriptionCreateParams.trial_settings.end_behavior, and SubscriptionUpdateParams.trial_settings.end_behavioradmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.typeadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.country_options.usrequirements on TaxCodeV2.Billing.Cadence.settings_data.collection.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSetting.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingCreateParams.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingUpdateParams.payment_method_options.card.mandate_options.amount, and V2.Billing.CollectionSettingVersion.payment_method_options.card.mandate_options.amount from longInteger to int64_stringar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typetimezone on V2.Core.Account.defaults, V2.Core.AccountCreateParams.defaults, and V2.Core.AccountUpdateParams.defaultsazure_event_grid on V2.Core.EventDestinationCreateParams and V2.Core.EventDestinationno_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reasonazure_event_grid on enums V2.Core.EventDestination.type and V2.Core.EventDestinationCreateParams.typesupported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.cardV2.Core.Vault.GbBankAccount.sort_code and V2.Core.Vault.GbBankAccountCreateParams.sort_code to be optionalrestricted on V2.MoneyManagement.PayoutMethodcurrencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.countries.value.fields[]counterparty and description on V2.MoneyManagement.Transactioncurrency on V2.Core.Vault.GbBankAccountCreateParams, V2.Core.Vault.UsBankAccountCreateParams, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.card, V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.cardiban on V2.Core.Vault.GbBankAccountCreateParamsV2.Core.Vault.GbBankAccountCreateParams.account_number to be optionalcurrency on enum InvalidPaymentMethodError.invalid_paramV2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object V2.Core.BatchJobservice_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.last_finalization_errorSee the changelog for more details.
This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.
This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.
RiskSignalsupi_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesrisk_signals on Accountfinancial_account_rewards and nesting_demo on AccountSession.componentsfraud_intent on AccountSignalsrelated_accounts on enum AccountSignals.delinquency.indicators[].indicatorrisk_reserved on Balancebillable_items on Billing.Alert.spend_threshold.filtersupi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, 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, and SetupIntentUpdateParams.payment_method_optionstempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.networksource_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balanceintegration_identifier on Checkout.SessionCreateParams and Checkout.Sessionapplication on enums Checkout.Session.automatic_tax.liability.type, Checkout.Session.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.automatic_tax.liability.type, Checkout.SessionCreateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionCreateParams.subscription_data.invoice_settings.issuer.type, Checkout.SessionUpdateParams.automatic_tax.liability.type, Checkout.SessionUpdateParams.invoice_creation.invoice_data.issuer.type, Checkout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type, Invoice.automatic_tax.liability.type, Invoice.issuer.type, InvoiceCreateParams.automatic_tax.liability.type, InvoiceCreateParams.issuer.type, InvoiceCreatePreviewParams.automatic_tax.liability.type, InvoiceCreatePreviewParams.issuer.type, InvoiceCreatePreviewParams.schedule_details.phases[].automatic_tax.liability.type, InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings.issuer.type, InvoiceUpdateParams.automatic_tax.liability.type, InvoiceUpdateParams.issuer.type, PaymentLink.automatic_tax.liability.type, PaymentLink.invoice_creation.invoice_data.issuer.type, PaymentLink.subscription_data.invoice_settings.issuer.type, PaymentLinkCreateParams.automatic_tax.liability.type, PaymentLinkCreateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkCreateParams.subscription_data.invoice_settings.issuer.type, PaymentLinkUpdateParams.automatic_tax.liability.type, PaymentLinkUpdateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkUpdateParams.subscription_data.invoice_settings.issuer.type, Quote.automatic_tax.liability.type, Quote.invoice_settings.issuer.type, QuoteCreateParams.automatic_tax.liability.type, QuoteCreateParams.invoice_settings.issuer.type, QuotePreviewInvoice.automatic_tax.liability.type, QuotePreviewInvoice.issuer.type, QuotePreviewSubscriptionSchedule.default_settings.automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.default_settings.invoice_settings.issuer.type, QuotePreviewSubscriptionSchedule.phases[].automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.phases[].invoice_settings.issuer.type, QuoteUpdateParams.automatic_tax.liability.type, QuoteUpdateParams.invoice_settings.issuer.type, Subscription.automatic_tax.liability.type, Subscription.invoice_settings.issuer.type, SubscriptionCreateParams.automatic_tax.liability.type, SubscriptionCreateParams.invoice_settings.issuer.type, SubscriptionSchedule.default_settings.automatic_tax.liability.type, SubscriptionSchedule.default_settings.invoice_settings.issuer.type, SubscriptionSchedule.phases[].automatic_tax.liability.type, SubscriptionSchedule.phases[].invoice_settings.issuer.type, SubscriptionScheduleCreateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleCreateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleCreateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleCreateParams.phases[].invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleUpdateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleUpdateParams.phases[].invoice_settings.issuer.type, SubscriptionUpdateParams.automatic_tax.liability.type, and SubscriptionUpdateParams.invoice_settings.issuer.typeupi on enum Checkout.SessionCreateParams.excluded_payment_method_typesCheckout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code from string to emptyable(string)crypto on Checkout.SessionCreateParams.payment_method_optionsupi on enum Checkout.SessionCreateParams.payment_method_typespending_invoice_item_interval on Checkout.SessionCreateParams.subscription_data and Checkout.SessionUpdateParams.subscription_dataelements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modecustom, embedded, and hosted from enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modeCheckout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code to be optionalau_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.current_attempt.payment_method_detailsmarine_carbon_removal on enum Climate.Supplier.removal_pathwayupi on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typeupi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typemetadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeselected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.fulfillment_detailsline_item_keys on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[] and DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[]quantity_decimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]expires_after_seconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pixlevel on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_riskrisk_level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_riskda, pl, and sv on enums Issuing.Cardholder.preferred_locales, Issuing.CardholderCreateParams.preferred_locales, and Issuing.CardholderUpdateParams.preferred_localeslifecycle_controls on Issuing.CardCreateParams and Issuing.CardIssuing.Token.network_data.visa.card_reference_id from string to string | nullPaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to enum | nullPaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to longInteger | nullPaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to longInteger | nullPaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to enum('credit'|'debit'|'prepaid'|'unknown') | nullPaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to string | nullPaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to boolean | nullcryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_securesurcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_detailsupi on enums 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, and SetupIntentUpdateParams.excluded_payment_method_typesmandate_options on PaymentIntent.payment_method_options.stripe_balance, PaymentIntentConfirmParams.payment_method_options.stripe_balance, PaymentIntentCreateParams.payment_method_options.stripe_balance, and PaymentIntentUpdateParams.payment_method_options.stripe_balanceamount_details and payment_details on PaymentIntentDecrementAuthorizationParamsupi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_actionmanaged_payments on PaymentLinkCreateParams and PaymentLinkupi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_typesrecommended_action and signals on Radar.PaymentEvaluationinsights on Radar.PaymentEvaluationcrypto_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_typestripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionsresolved on enum SharedPayment.GrantedToken.deactivated_reasonrecurring_interval on SharedPayment.GrantedToken.usage_limitsSharedPayment.GrantedToken.usage_limits.expires_at from DateTime to DateTime | nullpresentment_details on Subscriptioncanceled_by_retention_policy on enum Subscription.cancellation_details.reason2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_versioninvoice_resources on V2.Billing.Intentamount_due and customer_balance_applied on V2.Billing.Intent.amount_detailsrecurring_credit_grant on V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[], V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[]consumer_privacy_disclosures and consumer_storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_serviceinclude on V2.Billing.IntentCreateParams and V2.Billing.IntentReserveParamsservice_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorV2.Core.AccountEvaluationV2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponentscreate method on resource V2.Core.AccountEvaluationretrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponentsmodify_rates method on resource V2.Billing.RateCardremove_discounts method on resource V2.Billing.PricingPlanSubscriptioneg_bank_account on enum V2.Account.configuration.recipient_data.default_outbound_destination.typeinvoice_resources on V2.Billing.Intentamount_due and customer_balance_applied on V2.Billing.Intent.amount_detailsexpires_at on V2.Billing.Intent.status_transitionsdiscount on V2.Billing.IntentAction.apply and V2.Billing.IntentCreateParams.actions[].applytimestamp on V2.Billing.IntentAction.apply.effective_at and V2.Billing.IntentCreateParams.actions[].apply.effective_atcurrent_billing_period_start and timestamp on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.typediscount on enums V2.Billing.IntentAction.apply.type and V2.Billing.IntentCreateParams.actions[].apply.typeV2.Billing.IntentAction.deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type from literal('license_fee') to enum('license_fee'|'recurring_credit_grant')service_cycle on V2.Billing.LicenseFee and V2.Billing.RateCardlatest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCardservice_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCardV2.Billing.LicenseFee.transform_quantity.divide_by, V2.Billing.LicenseFeeCreateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeUpdateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeVersion.transform_quantity.divide_by, V2.Billing.RateCardRate.transform_quantity.divide_by, and V2.Billing.RateCardRateCreateParams.transform_quantity.divide_by from longInteger to int64_stringdiscount_details and pricing_plan_component_details on V2.Billing.PricingPlanSubscriptioncrypto_wallets on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitycrypto from enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitybalance_by_funds_type on V2.MoneyManagement.FinancialAccount.paymentsnext_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].typetreasury_transaction_entry on V2.MoneyManagement.TransactionEntrytreasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowtreasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_other, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typetreasury_transaction on V2.MoneyManagement.Transactionno_valid_payment_method on enum V2.Payments.OffSessionPayment.failure_reasonmetadata on V2.Payments.SettlementAllocationIntentSplitV2.Reporting.ReportRun.result.file.size from longInteger to int64_stringstatement_descriptor on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundTransferCreateParamsinclude on V2.Billing.IntentCreateParams, V2.Billing.IntentReserveParams, V2.Billing.PricingPlanSubscriptionListParams, V2.Billing.PricingPlanSubscriptionRetrieveParams, V2.MoneyManagement.FinancialAccountListParams, and V2.MoneyManagement.FinancialAccountRetrieveParamsV1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEventSee the changelog for more details.
This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migra…
This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
Note: we're releasing another major version very soon that overhauls and improves the package's structure and typescript types. That will also use
2026-03-25.dahliaas an API version and will mostly be a drop-in replacement.
decimal_string fields changed type from string to Stripe.Decimal in both request params and response objects. Code that reads or writes these fields as string will need to use Stripe.Decimal instead (construct via Decimal.from("1.23"), serialize via .toString()). Affected fields across v1 and v2 APIs:
currency_conversion.fx_ratemetric_tons; Climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)This release changes the pinned API version to 2026-03-25.dahlia.
This release contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
Note: we're releasing another major version very soon that overhauls and improves the package's structure and typescript types. That will also use
2026-03-25.dahliaas an API version and will mostly be a drop-in replacement.
decimal_string fields changed type from string to Stripe.Decimal in both request params and response objects. Code that reads or writes these fields as string will need to use Stripe.Decimal instead (construct via Decimal.from("1.23"), serialize via .toString()). Affected fields across v1 and v2 APIs:
currency_conversion.fx_ratemetric_tons; Climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)upi_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesupi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, 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, and SetupIntentUpdateParams.payment_method_optionstempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.networkintegration_identifier on Checkout.SessionCreateParams and Checkout.Sessionupi on enums Checkout.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, and SetupIntentUpdateParams.excluded_payment_method_typescrypto on Checkout.SessionCreateParams.payment_method_optionsupi on enum Checkout.SessionCreateParams.payment_method_typespending_invoice_item_interval on Checkout.SessionCreateParams.subscription_dataelements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modemarine_carbon_removal on enum Climate.Supplier.removal_pathwayupi on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.typeupi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typemetadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typequantity_decimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_riskrisk_level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risklifecycle_controls on Issuing.CardCreateParams and Issuing.CardIssuing.Token.network_data.visa.card_reference_id from string to string | nullPaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to enum | nullPaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to longInteger | nullPaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to longInteger | nullPaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to enum('credit'|'debit'|'prepaid'|'unknown') | nullPaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to string | nullPaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to boolean | nullcryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secureupi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_actionupi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_typesrecommended_action and signals on Radar.PaymentEvaluationinsights on Radar.PaymentEvaluationcrypto_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_typecanceled_by_retention_policy on enum Subscription.cancellation_details.reason2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_versionV2.Core.EventDestination.events_from and V2.Core.EventDestinationCreateParams.events_from from enum('other_accounts'|'self') to stringservice_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorAdd support for simulate_crypto_deposit test helper method on resource PaymentIntent
simulate_crypto_deposit test helper method on resource PaymentIntentdeposit_options and mode on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.cryptocrypto_display_details on PaymentIntent.next_actionOrchestration.PaymentAttempt and Radar.CustomerEvaluationretrieve method on resource Orchestration.PaymentAttemptcreate and update methods on resource Radar.CustomerEvaluationapprove method on resource Checkout.Sessionreport_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecordcreate_us_paper_check_on_application on AccountSessionCreateParams.components.check_scanning.featuresAccountSignals.delinquency to be optionalapproval_method on Checkout.SessionCreateParams and Checkout.Sessioncurrent_attempt on Checkout.Sessionselected_fulfillment_option_overrides on DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_detailspricing_plan_subscription_details on InvoiceItem.parent and InvoiceLineItem.parentlicense_fee_subscription_details on InvoiceItem.parent and InvoiceLineItem.parentpricing_plan_subscription and pricing_plan_version on InvoiceItem.parent.rate_card_subscription_details and InvoiceLineItem.parent.rate_card_subscription_detailspricing_plan_subscription_details on enum InvoiceItem.parent.typelicense_fee_subscription_details from enum InvoiceItem.parent.typediscounts on enum InvoiceItem.frozen_fieldspricing_plan_subscription_details on enum InvoiceLineItem.parent.typelicense_fee_subscription_details from enum InvoiceLineItem.parent.typetoken_details on Issuing.Authorizationfailure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams.failed, and PaymentRecordReportPaymentParams.failedPaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optionalPaymentRecordReportPaymentAttemptFailedParams.failed_at to be optionalPaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optionalPaymentRecordReportRefundParams.refunded to be optionalnow from enums QuoteCreateParams.subscription_data.billing_schedules[].bill_from.type, QuoteCreateParams.subscription_data_overrides[].billing_schedules[].bill_from.type, QuoteUpdateParams.subscription_data.billing_schedules[].bill_from.type, and QuoteUpdateParams.subscription_data_overrides[].billing_schedules[].bill_from.typeRadar.IssuingAuthorizationEvaluationCreateParams.card_details.bin_country to be requiredrecurring_interval on SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limitsSharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits.expires_at to be optionalhome_rule_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.ushome_rule_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.typeAdd support for new resource Radar.IssuingAuthorizationEvaluation
Radar.IssuingAuthorizationEvaluationcreate method on resource Radar.IssuingAuthorizationEvaluationfee_credits on enum BalanceTransaction.balance_typeaffiliate_attributions to affiliate_attribution on DelegatedCheckout.RequestedSessionConfirmParams and DelegatedCheckout.RequestedSessionCreateParamsamount_to_counter on Disputefrozen_fields on InvoiceItemnext_billing_period_start on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.typeconsumer on V2.Core.Account.configuration.card_creator.capabilities, V2.Core.Account.identity.attestations.terms_of_service.card_creator, V2.Core.AccountCreateParams.configuration.card_creator.capabilities, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creatorfifth_third on V2.Core.Account.configuration.card_creator.capabilities.commercial, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercialprepaid_card on V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bank, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bank, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bankcommercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitypayment_method_data on V2.Payments.OffSessionPaymentCreateParamsV2.Payments.OffSessionPaymentCreateParams.payment_method to be optionalcommercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capabilityThis release changes the pinned API version to 2026-03-04.preview.
This release changes the pinned API version to 2026-03-04.preview.
Billing.AlertRecovered and Profilereauthorize method on resource PaymentIntentsmart_disputes on Account.settings, AccountCreateParams.settings, AccountUpdateParams.settings, V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchantemail_customers_on_successful_payment on Account.settings.payments, AccountCreateParams.settings.payments, and AccountUpdateParams.settings.paymentssettings on QuoteLine.actions[].add_discount, QuoteLine.actions[].add_item.discounts[], QuoteLine.actions[].set_discounts[], QuoteLine.actions[].set_items[].discounts[], QuotePreviewSubscriptionSchedule.phases[].discounts[], QuotePreviewSubscriptionSchedule.phases[].items[].discounts[], SubscriptionSchedule.phases[].discounts[], and SubscriptionSchedule.phases[].items[].discounts[]balance_update_details on Billing.CreditBalanceSummary.balances[]reauthorization and reauthorize_before on Charge.payment_method_details.card_present, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_presentlocation and reader on Charge.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, and PaymentRecord.payment_method_details.interac_presentmanaged_payments on Checkout.SessionCreateParams, Checkout.Session, PaymentIntent, SetupIntent, and Subscriptionlk_vat on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typelk_vat on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typedigital on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[], DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option, and DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_optionDelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option.shipping to be optionalaffiliate_attributions on DelegatedCheckout.RequestedSessionConfirmParams, DelegatedCheckout.RequestedSessionCreateParams, and DelegatedCheckout.RequestedSessionfulfillment_type on DelegatedCheckout.RequestedSession.line_item_details[]marketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.seller_detailsamount_to_counter on DisputeUpdateParamsreserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typesdisplay_name and service_user_number on Mandate.payment_method_details.bacs_debitPaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to string | nullPaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from string | null to stringrequest_reauthorization on PaymentIntent.payment_method_options.card_present, 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.cardtransaction_purpose 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_accountrequires_reauthorization on enum PaymentIntent.statusoptional_items on PaymentLinkUpdateParamsbilling_schedules_invalid on enum Quote.status_details.stale.last_reason.typecard_issuer_decline on Radar.PaymentEvaluation.insightspayment_behavior on SubscriptionItemDeleteParamsbilling_cycle_anchor on Subscription.trial_settings.end_behaviorlk on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionscellular and stripe_s710 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationsimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionar_bank_account, bt_bank_account, co_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enums V2.Account.configuration.recipient_data.default_outbound_destination.type and V2.Core.Account.configuration.recipient.default_outbound_destination.typerecipient_onboarding and recipient_update on V2.Core.AccountLink.use_case and V2.Core.AccountLinkCreateParams.use_caserecipient_onboarding and recipient_update on enums V2.Core.AccountLink.use_case.type and V2.Core.AccountLinkCreateParams.use_case.typeconsumer on V2.Core.Account.configuration.storer.capabilities, V2.Core.AccountCreateParams.configuration.storer.capabilities, and V2.Core.AccountUpdateParams.configuration.storer.capabilitiesconsumer.holds_currencies.usd on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilityfunds_usage_type on V2.MoneyManagement.FinancialAccount.storage and V2.MoneyManagement.FinancialAccountCreateParams.storagepurpose on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundPaymentbranch_number and swift_code on V2.MoneyManagement.PayoutMethod.bank_accountdispute, inbound_payment_failure, inbound_payment, india_mdr_processing_fee, payment_method_passthrough_fee, refund, and tax_withholding on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categorycharge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryV2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow to be optionalconsumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilityBillingAlertRecoveredEvent with resource Billing.AlertRecoveredReserveHoldCreatedEvent and ReserveHoldUpdatedEvent with resource Reserve.HoldReservePlanCreatedEvent, ReservePlanDisabledEvent, ReservePlanExpiredEvent, and ReservePlanUpdatedEvent with resource Reserve.PlanReserveReleaseCreatedEvent with resource Reserve.ReleaseV2BillingRateCardCustomPricingUnitOverageRateCreatedEvent with related object V2.Billing.RateCardCustomPricingUnitOverageRateV2IamStripeAccessGrantApprovedEvent, V2IamStripeAccessGrantCanceledEvent, V2IamStripeAccessGrantDeniedEvent, V2IamStripeAccessGrantRemovedEvent, V2IamStripeAccessGrantRequestedEvent, and V2IamStripeAccessGrantUpdatedEventstorer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorThis release changes the pinned API version to 2026-02-25.preview.
This release changes the pinned API version to 2026-02-25.preview.
AccountSignalsretrieve method on resource AccountSignalsaggregation_period, group_by, and triggered_at on Billing.AlertTriggeredexternal_account_collection on AccountLinkCreateParams.collection_optionsfunding_source on ApplicationFeeDelegatedCheckout.RequestedSessionConfirmParams.payment_method_data.billing_details.address.line1, DelegatedCheckout.RequestedSessionCreateParams.fulfillment_details.address.line1, DelegatedCheckout.RequestedSessionCreateParams.payment_method_data.billing_details.address.line1, DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.address.line1, and DelegatedCheckout.RequestedSessionUpdateParams.payment_method_data.billing_details.address.line1 to be optionalhosted and ui_mode on FinancialConnections.SessionCreateParams and FinancialConnections.Sessionurl on FinancialConnections.Sessionbilling_cycle_anchor on SubscriptionCreateParams.trial_settings.end_behavior and SubscriptionUpdateParams.trial_settings.end_behaviorSee the changelog for more details.
This release changes the pinned API version to 2026-02-25.clover.
This release changes the pinned API version to 2026-02-25.clover.
Reserve.Hold, Reserve.Plan, and Reserve.Releaselocation and reader on Charge.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, and PaymentRecord.payment_method_details.interac_presentlk_vat on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typelk_vat on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank 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_typesdisplay_name and service_user_number on Mandate.payment_method_details.bacs_debitPaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to string | nullPaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from string | null to stringtransaction_purpose 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_accountoptional_items on PaymentLinkUpdateParamscard_issuer_decline on Radar.PaymentEvaluation.insightspayment_behavior on SubscriptionItemDeleteParamslk on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionscellular and stripe_s710 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationsimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionReserveHoldCreatedEvent and ReserveHoldUpdatedEvent with resource Reserve.HoldReservePlanCreatedEvent, ReservePlanDisabledEvent, ReservePlanExpiredEvent, and ReservePlanUpdatedEvent with resource Reserve.PlanReserveReleaseCreatedEvent with resource Reserve.Releasestorer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorFixes 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
UnhandledPromiseRejection error on failed V2 List operations
UnhandledPromiseRejectionThis release changes the pinned API version to 2026-01-28.preview.
This release changes the pinned API version to 2026-01-28.preview.
FinancialConnections.Authorizationretrieve method on resource FinancialConnections.Authorizationdetach_payment method on resource Invoicecancel, list_line_items, and reopen methods on resource Orderattach_cadence method on resource Subscriptionadditional_files and site on Account.settings.paypay_payments, AccountCreateParams.settings.paypay_payments, and AccountUpdateParams.settings.paypay_paymentscapital on Account.settingsCharge.payment_method_details.stripe_balance.source_type, ConfirmationToken.payment_method_preview.stripe_balance.source_type, PaymentAttemptRecord.payment_method_details.stripe_balance.source_type, PaymentMethod.stripe_balance.source_type, and PaymentRecord.payment_method_details.stripe_balance.source_type from enum('bank_account'|'card'|'fpx') to enum('bank_account'|'card'|'fpx') | nullpl_nip on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].typecapital.financing_summary.line_of_credit_update on enum Event.typeauthorization and status_details on FinancialConnections.Accountrelink_options on FinancialConnections.SessionCreateParams and FinancialConnections.SessionFinancialConnections.SessionCreateParams.account_holder to be optionalrelink_result on FinancialConnections.Sessionbilling_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscriptionbilling_cadence_details on Invoice.parent and QuotePreviewInvoice.parentbilling_cadence_details from enums Invoice.parent.type and QuotePreviewInvoice.parent.typepl_nip on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typecar_rental_data, flight_data, and lodging_data on PaymentIntent.payment_detailsQuotePreviewInvoice.payment_settings.payment_method_options.payto to be requiredcapital.financing_summary.line_of_credit_update on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_eventsae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typealternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethodaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_accountfingerprint on V2.MoneyManagement.PayoutMethod.cardInvoicePaymentDetachedEvent with resource InvoicePaymentrequest_blocked on QuotePreviewInvoice.last_finalization_errorblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededError⚠️ Add support for new value spend_threshold on enums Billing.Alert.alert_type, Billing.AlertCreateParams.alert_type, and Billing.AlertListParams.aler
spend_threshold on enums Billing.Alert.alert_type, Billing.AlertCreateParams.alert_type, and Billing.AlertListParams.alert_typespend_threshold on Billing.AlertCreateParams and Billing.Alertinvoice_item, proration_details, proration, and subscription on InvoiceLineItem.parent.schedule_detailscustom on PaymentMethodUpdateParamspayment_method_reference and usage on PaymentMethod.customoutstanding_usage_through and unused_time_from on SubscriptionPauseParams.bill_foroutstanding_usage and unused_time on SubscriptionPauseParams.bill_forpayment_behavior on SubscriptionResumeParamsAdd support for new resources V2.Billing.CadenceSpendModifier, V2.Billing.OneTimeItem, and V2.Billing.RateCardCustomPricingUnitOverageRate
V2.Billing.CadenceSpendModifier, V2.Billing.OneTimeItem, and V2.Billing.RateCardCustomPricingUnitOverageRatecreate, del, list, and retrieve methods on resource V2.Billing.RateCardCustomPricingUnitOverageRatecreate, list, retrieve, and update methods on resource V2.Billing.OneTimeItemretrieve method on resource V2.Billing.CadenceSpendModifierEventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount.value, V2.Billing.ServiceAction.credit_grant.amount.monetary.value, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary.value, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary.value, V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary.value, V2.Core.Account.identity.business_details.annual_revenue.amount.value, V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.FinancialAddressCreditSimulationCreditParams.amount.value, V2.FinancialAddressGeneratedMicrodeposits.amounts[].value, V2.MoneyManagement.Adjustment.amount.value, V2.MoneyManagement.CurrencyConversion.from.amount.value, V2.MoneyManagement.CurrencyConversion.to.amount.value, V2.MoneyManagement.CurrencyConversionCreateParams.from.amount.value, V2.MoneyManagement.CurrencyConversionCreateParams.to.amount.value, V2.MoneyManagement.FinancialAccount.balance.available.value.value, V2.MoneyManagement.FinancialAccount.balance.inbound_pending.value.value, V2.MoneyManagement.FinancialAccount.balance.outbound_pending.value.value, V2.MoneyManagement.FinancialAccount.payments.starting_balance.available.value.value, V2.MoneyManagement.InboundTransfer.amount.value, V2.MoneyManagement.InboundTransfer.from.debited.value, V2.MoneyManagement.InboundTransfer.to.credited.value, V2.MoneyManagement.InboundTransferCreateParams.amount.value, V2.MoneyManagement.OutboundPayment.amount.value, V2.MoneyManagement.OutboundPayment.from.debited.value, V2.MoneyManagement.OutboundPayment.to.credited.value, V2.MoneyManagement.OutboundPaymentCreateParams.amount.value, V2.MoneyManagement.OutboundPaymentQuote.amount.value, V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount.value, V2.MoneyManagement.OutboundPaymentQuote.from.debited.value, V2.MoneyManagement.OutboundPaymentQuote.to.credited.value, V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount.value, V2.MoneyManagement.OutboundTransfer.amount.value, V2.MoneyManagement.OutboundTransfer.from.debited.value, V2.MoneyManagement.OutboundTransfer.to.credited.value, V2.MoneyManagement.OutboundTransferCreateParams.amount.value, V2.MoneyManagement.ReceivedCredit.amount.value, V2.MoneyManagement.ReceivedCredit.external_amount.value, V2.MoneyManagement.ReceivedDebit.amount.value, V2.MoneyManagement.ReceivedDebit.card_spend.authorization.amount.value, V2.MoneyManagement.ReceivedDebit.card_spend.card_transactions[].amount.value, V2.MoneyManagement.ReceivedDebit.external_amount.value, V2.MoneyManagement.Transaction.amount.value, V2.MoneyManagement.Transaction.balance_impact.available.value, V2.MoneyManagement.Transaction.balance_impact.inbound_pending.value, V2.MoneyManagement.Transaction.balance_impact.outbound_pending.value, V2.MoneyManagement.TransactionEntry.balance_impact.available.value, V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending.value, V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending.value, V2.Payments.OffSessionPayment.amount_capturable.value, V2.Payments.OffSessionPayment.amount_requested.value, V2.Payments.OffSessionPaymentCreateParams.amount.value, V2.Payments.SettlementAllocationIntent.amount.value, V2.Payments.SettlementAllocationIntentCreateParams.amount.value, V2.Payments.SettlementAllocationIntentSplit.amount.value, V2.Payments.SettlementAllocationIntentSplitCreateParams.amount.value, and V2.Payments.SettlementAllocationIntentUpdateParams.amount.value to be requiredEventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount.currency, V2.Billing.ServiceAction.credit_grant.amount.monetary.currency, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary.currency, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary.currency, V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary.currency, V2.Core.Account.identity.business_details.annual_revenue.amount.currency, V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.FinancialAddressCreditSimulationCreditParams.amount.currency, V2.FinancialAddressGeneratedMicrodeposits.amounts[].currency, V2.MoneyManagement.Adjustment.amount.currency, V2.MoneyManagement.CurrencyConversion.from.amount.currency, V2.MoneyManagement.CurrencyConversion.to.amount.currency, V2.MoneyManagement.CurrencyConversionCreateParams.from.amount.currency, V2.MoneyManagement.CurrencyConversionCreateParams.to.amount.currency, V2.MoneyManagement.FinancialAccount.balance.available.value.currency, V2.MoneyManagement.FinancialAccount.balance.inbound_pending.value.currency, V2.MoneyManagement.FinancialAccount.balance.outbound_pending.value.currency, V2.MoneyManagement.FinancialAccount.payments.starting_balance.available.value.currency, V2.MoneyManagement.InboundTransfer.amount.currency, V2.MoneyManagement.InboundTransfer.from.debited.currency, V2.MoneyManagement.InboundTransfer.to.credited.currency, V2.MoneyManagement.InboundTransferCreateParams.amount.currency, V2.MoneyManagement.OutboundPayment.amount.currency, V2.MoneyManagement.OutboundPayment.from.debited.currency, V2.MoneyManagement.OutboundPayment.to.credited.currency, V2.MoneyManagement.OutboundPaymentCreateParams.amount.currency, V2.MoneyManagement.OutboundPaymentQuote.amount.currency, V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount.currency, V2.MoneyManagement.OutboundPaymentQuote.from.debited.currency, V2.MoneyManagement.OutboundPaymentQuote.to.credited.currency, V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount.currency, V2.MoneyManagement.OutboundTransfer.amount.currency, V2.MoneyManagement.OutboundTransfer.from.debited.currency, V2.MoneyManagement.OutboundTransfer.to.credited.currency, V2.MoneyManagement.OutboundTransferCreateParams.amount.currency, V2.MoneyManagement.ReceivedCredit.amount.currency, V2.MoneyManagement.ReceivedCredit.external_amount.currency, V2.MoneyManagement.ReceivedDebit.amount.currency, V2.MoneyManagement.ReceivedDebit.card_spend.authorization.amount.currency, V2.MoneyManagement.ReceivedDebit.card_spend.card_transactions[].amount.currency, V2.MoneyManagement.ReceivedDebit.external_amount.currency, V2.MoneyManagement.Transaction.amount.currency, V2.MoneyManagement.Transaction.balance_impact.available.currency, V2.MoneyManagement.Transaction.balance_impact.inbound_pending.currency, V2.MoneyManagement.Transaction.balance_impact.outbound_pending.currency, V2.MoneyManagement.TransactionEntry.balance_impact.available.currency, V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending.currency, V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending.currency, V2.Payments.OffSessionPayment.amount_capturable.currency, V2.Payments.OffSessionPayment.amount_requested.currency, V2.Payments.OffSessionPaymentCreateParams.amount.currency, V2.Payments.SettlementAllocationIntent.amount.currency, V2.Payments.SettlementAllocationIntentCreateParams.amount.currency, V2.Payments.SettlementAllocationIntentSplit.amount.currency, V2.Payments.SettlementAllocationIntentSplitCreateParams.amount.currency, and V2.Payments.SettlementAllocationIntentUpdateParams.amount.currency to be requiredsettlement_type on ApplicationFeerate_card_custom_pricing_unit_overage_rate_details on InvoiceItem.pricing and InvoiceLineItem.pricingrate_card_custom_pricing_unit_overage_rate_details on enums InvoiceItem.pricing.type and InvoiceLineItem.pricing.typedefault_settings on InvoiceCreatePreviewParams.schedule_detailsQuoteUpdateParams.subscription_data_overrides[].billing_schedules from emptyable(array(billing_schedules_update_specs)) to array(billing_schedules_update_specs)payment_behavior on SubscriptionResumeParamseffective_at and spend_modifier_rule on V2.Billing.IntentAction.apply, V2.Billing.IntentAction.remove, V2.Billing.IntentCreateParams.actions[].apply, and V2.Billing.IntentCreateParams.actions[].removeV2.Billing.IntentAction.apply.type, V2.Billing.IntentAction.remove.type, V2.Billing.IntentCreateParams.actions[].apply.type, and V2.Billing.IntentCreateParams.actions[].remove.type from literal('invoice_discount_rule') to enum('invoice_discount_rule'|'spend_modifier_rule')Add support for new resource V2.Core.ConnectionSession
V2.Core.ConnectionSessioncreate and retrieve methods on resource V2.Core.ConnectionSessionlist method on resources V2.Payments.SettlementAllocationIntentSplit and V2.Payments.SettlementAllocationIntentagentic_commerce_settings on AccountSessionCreateParams.componentsterminal_hardware_orders and terminal_hardware_shop on AccountSession.components and AccountSessionCreateParams.componentsnetwork_cost_passthrough_report on AccountSession.componentsae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enums V2.Account.configuration.recipient_data.default_outbound_destination.type and V2.Core.Account.configuration.recipient.default_outbound_destination.typecadence_data on V2.Billing.IntentCreateParams and V2.Billing.Intentcancellation_details on V2.Billing.IntentAction.deactivate, V2.Billing.IntentCreateParams.actions[].deactivate, and V2.Billing.PricingPlanSubscriptioncontact_phone on V2.Core.AccountCreateParams, V2.Core.AccountTokenCreateParams, V2.Core.AccountUpdateParams, and V2.Core.Accountregistration_date on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, V2.Core.AccountTokenCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_detailsgb_vat on enums V2.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, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typereference on V2.MoneyManagement.Adjustmentaccrued_fees on V2.MoneyManagement.FinancialAccountstarting_balance on V2.MoneyManagement.FinancialAccount.paymentsaccrued_fees on enum V2.MoneyManagement.FinancialAccount.typeaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_accountfingerprint on V2.MoneyManagement.PayoutMethod.cardcard_spend on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebitcard_spend on enum V2.MoneyManagement.ReceivedCredit.typecard_spend on enum V2.MoneyManagement.ReceivedDebit.typeadvance, anticipation_repayment, balance_transfer, charge_failure, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, connect_reserved_funds, contribution, dispute_reversal, financing_paydown_reversal, financing_paydown, inbound_transfer_reversal, issuing_dispute_fraud_liability_debit, issuing_dispute_provisional_credit_reversal, issuing_dispute_provisional_credit, issuing_dispute, minimum_balance_hold, network_cost, obligation, outbound_payment_reversal, outbound_transfer_reversal, partial_capture_reversal, payment_network_reserved_funds, platform_earning_refund, platform_earning, platform_fee, received_credit_reversal, received_debit_reversal, refund_failure, risk_reserved_funds, stripe_balance_payment_debit_reversal, stripe_balance_payment_debit, stripe_fee_tax, transfer_reversal, and unreconciled_customer_funds on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typeV2.Payments.SettlementAllocationIntentSplit.flow to be optionalaccrued_fees on enum V2.MoneyManagement.FinancialAccountListParams.typesV2.Billing.RateCardRateCreateParams.metered_item to be requiredblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededErrorThis release changes the pinned API version to 2026-01-28.preview.
This release changes the pinned API version to 2026-01-28.preview.
FrMealVouchersOnboarding, Reserve.Hold, Reserve.Plan, and Reserve.Releasecreate, list, retrieve, and update methods on resource FrMealVouchersOnboardinglist and retrieve methods on resources Reserve.Hold and Reserve.Releaseretrieve method on resource Reserve.Planpause method on resource Subscriptionservice_period_details on Discountagentic_commerce_settings on AccountSession.componentsrisk_reserved on enum BalanceTransaction.balance_typeservice_period on enums Checkout.SessionCreateParams.discounts[].coupon_data.duration, Checkout.SessionUpdateParams.discounts[].coupon_data.duration, Coupon.duration, and CouponCreateParams.durationservice_period on CouponCreateParams and CouponInvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable(Price)settings on InvoiceCreatePreviewParams.discounts[], InvoiceCreatePreviewParams.schedule_details.amendments[].discount_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].discount_actions[].set, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add.discounts[], InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set.discounts[], InvoiceCreatePreviewParams.schedule_details.phases[].discounts[], InvoiceCreatePreviewParams.schedule_details.phases[].items[].discounts[], InvoiceCreatePreviewParams.subscription_details.items[].discounts[], QuoteCreateParams.lines[].actions[].add_discount, QuoteCreateParams.lines[].actions[].add_item.discounts[], QuoteCreateParams.lines[].actions[].set_discounts[], QuoteCreateParams.lines[].actions[].set_items[].discounts[], QuoteUpdateParams.lines[].actions[].add_discount, QuoteUpdateParams.lines[].actions[].add_item.discounts[], QuoteUpdateParams.lines[].actions[].set_discounts[], QuoteUpdateParams.lines[].actions[].set_items[].discounts[], SubscriptionCreateParams.discounts[], SubscriptionCreateParams.items[].discounts[], SubscriptionItemCreateParams.discounts[], SubscriptionItemUpdateParams.discounts[], SubscriptionScheduleAmendParams.amendments[].discount_actions[].add, SubscriptionScheduleAmendParams.amendments[].discount_actions[].set, SubscriptionScheduleAmendParams.amendments[].item_actions[].add.discounts[], SubscriptionScheduleAmendParams.amendments[].item_actions[].set.discounts[], SubscriptionScheduleCreateParams.phases[].discounts[], SubscriptionScheduleCreateParams.phases[].items[].discounts[], SubscriptionScheduleUpdateParams.phases[].discounts[], SubscriptionScheduleUpdateParams.phases[].items[].discounts[], SubscriptionUpdateParams.discounts[], and SubscriptionUpdateParams.items[].discounts[]subtotal on InvoiceLineItembilling_cadence on SubscriptionListParamsFixes 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
UnhandledPromiseRejection error on failed V2 List operations
UnhandledPromiseRejectionThis release changes the pinned API version to 2026-01-28.clover.
This release changes the pinned API version to 2026-01-28.clover.
Radar.PaymentEvaluationcreate method on resource Radar.PaymentEvaluationadjustable_quantity on LineItemrisk_reserved on enum BalanceTransaction.balance_typereserve_hold and reserve_release on enum BalanceTransaction.type2.3.0 and 2.3.1 on enums Charge.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, and SetupIntentUpdateParams.payment_method_options.card.three_d_secure.versionadyen on enums Charge.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, and SetupIntentUpdateParams.payment_method_data.ideal.bankADYBNL2A on enums Charge.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, and SetupAttempt.payment_method_details.ideal.bicpl_nip on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typepl_nip on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typeInvoice.payment_settings.payment_method_options.payto and Subscription.payment_settings.payment_method_options.payto to be requiredenforce_arithmetic_validation on PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_detailserror on PaymentIntent.amount_detailsbgn on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingtopup on Treasury.ReceivedDebit.linked_flowscontact_phone on V2.Core.AccountCreateParams, V2.Core.AccountTokenCreateParams, V2.Core.AccountUpdateParams, and V2.Core.Accountregistration_date on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, V2.Core.AccountTokenCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_detailsgb_vat on enums V2.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, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typerequest_blocked on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorqs dependency
qs dependency, addressing Issue #2117.Remove support for pause method on resource Subscription
pause method on resource SubscriptionQuote.subscription_data.phase_effective_at and Quote.subscription_data_overrides[].phase_effective_at from enum('billing_period_start'|'phase_start') to enum('billing_period_start'|'phase_start') | nullOne column per quarter.