releases.shpreview
Stripe/stripe-python

stripe-python

$npx -y @buildinternet/releases show stripe-python
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases24Avg7/moVersionsv14.2.0a3 → v15.1.0a4
Jan 28, 2026

This release changes the pinned API version to 2026-01-28.clover.

  • #1725 Update generated code
    • Add support for new resource radar.PaymentEvaluation
    • Add support for create method on resource radar.PaymentEvaluation
    • Add support for adjustable_quantity on LineItem
    • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
    • Add support for new values reserve_hold and reserve_release on enum BalanceTransaction.type
    • Add support for new values 2.3.0 and 2.3.1 on enums Charge.PaymentMethodDetail.Card.ThreeDSecure.version, PaymentIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, PaymentIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version, SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.version, SetupIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version, SetupIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version, and SetupIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version
    • Add support for new value adyen on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bank
    • Add support for new value ADYBNL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
    • Add support for new value pl_nip on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
    • Add support for new value pl_nip on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.type
    • Change Invoice.PaymentSetting.PaymentMethodOption.payto and Subscription.PaymentSetting.PaymentMethodOption.payto to be required
    • Add support for enforce_arithmetic_validation on PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetail
    • Add support for error on PaymentIntent.AmountDetail
    • Remove support for bgn on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTipping
    • Add support for topup on Treasury.ReceivedDebit.LinkedFlow
    • Add support for contact_phone on V2.Core.Account, v2.core.AccountCreateParams, v2.core.AccountModifyParams, and v2.core.AccountTokenCreateParams
    • Add support for registration_date on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetail
    • Add support for new value gb_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type
    • Add support for error code request_blocked on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
  • #1722 Add documentation for undocumented API parameters

See the changelog for more details.

Jan 21, 2026
  • #1723 Update generated code for private-preview
    • Remove support for pause method on resource Subscription
    • Change type of Quote.SubscriptionDataOverride.phase_effective_at and Quote.SubscriptionDatum.phase_effective_at from enum('billing_period_start'|'phase_start') to nullable(enum('billing_period_start'|'phase_start'))

See the changelog for more details.

Jan 16, 2026
  • #1720 Update generated code
    • Add support for event notifications V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingDefaultsUpdatedEvent, V2CoreAccountIncludingFutureRequirementsUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, V2CoreAccountIncludingRequirementsUpdatedEvent, and V2CoreAccountUpdatedEvent with related object v2.core.Account
    • Add support for event notification V2CoreAccountLinkReturnedEvent
    • Add support for event notifications V2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object v2.core.AccountPerson
  • #1687 Fix DeprecationWarning when encoding StripeObject metadata (fixes #1651)
  • #1703 Update ci to run on Python 3.14 as well

See the changelog for more details.

Jan 14, 2026
  • #1718 Update generated code for private-preview
    • Add support for risk_details on DelegatedCheckout.RequestedSession
    • Remove support for description, images, and name on DelegatedCheckout.RequestedSession.LineItemDetail
    • Add support for name on ProductCatalog.TrialOffer and product_catalog.TrialOfferCreateParams
    • Add support for login_failed and registration_failed on Radar.AccountEvaluation.Event and radar.AccountEvaluationModifyParams
    • Change type of radar.AccountEvaluationModifyParams.type from literal('registration_succeeded') to enum('login_failed'|'login_succeeded'|'registration_failed'|'registration_succeeded')

See the changelog for more details.

Jan 7, 2026
  • #1711 Update generated code for private-preview
    • Add support for tracking_details on V2.MoneyManagement.OutboundPayment
    • Add support for paper_check on V2.MoneyManagement.OutboundPayment.DeliveryOption and v2.money_management.OutboundPaymentCreateParamsDeliveryOption
    • Add support for event notification V2CoreAccountIncludingFutureRequirementsUpdatedEvent with related object v2.core.Account
    • Add support for error code account_rate_limit_exceeded on RateLimitError
  • #1698 Update generated code for private-preview
    • Add support for new resource tax.Location
    • Add support for create, list, and retrieve methods on resource tax.Location
    • Add support for pause method on resource Subscription
    • Add support for performance_location on InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail, ProductCreateParamsTaxDetail, ProductModifyParamsTaxDetail, Tax.CalculationLineItem, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail, checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail, and tax.CalculationCreateParamsLineItem
    • Add support for new value performance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.sourcing
    • Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type, Tax.Calculation.TaxBreakdown.TaxRateDetail.tax_type, Tax.CalculationLineItem.TaxBreakdown.TaxRateDetail.tax_type, and Tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type
    • Change type of delegated_checkout.RequestedSessionModifyParams.metadata from map(string: string) to emptyable(map(string: string))
    • Change type of delegated_checkout.RequestedSessionModifyParams.payment_method_data from payment_method_data to emptyable(payment_method_data)
    • Change type of delegated_checkout.RequestedSessionModifyParams.shared_metadata from map(string: string) to emptyable(map(string: string))
    • Add support for subscription on Invoice.Parent.ScheduleDetail and QuotePreviewInvoice.Parent.ScheduleDetail
    • Change type of PaymentIntentConfirmParamsPaymentDetailBenefit.fr_meal_voucher, PaymentIntentCreateParamsPaymentDetailBenefit.fr_meal_voucher, PaymentIntentModifyParamsPaymentDetailBenefit.fr_meal_voucher, SetupIntentConfirmParamsSetupDetailBenefit.fr_meal_voucher, SetupIntentCreateParamsSetupDetailBenefit.fr_meal_voucher, and SetupIntentModifyParamsSetupDetailBenefit.fr_meal_voucher from payment_details_benefit_fr_meal_voucher to emptyable(payment_details_benefit_fr_meal_voucher)
    • Add support for tax_details on PlanCreateParamsProduct and PriceCreateParamsProductDatum
    • Add support for external_reference on Plan and Price
    • Add support for new value phase_start on enums Quote.SubscriptionDataOverride.phase_effective_at, Quote.SubscriptionDatum.phase_effective_at, QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_at
    • Remove support for value line_start from enums Quote.SubscriptionDataOverride.phase_effective_at, Quote.SubscriptionDatum.phase_effective_at, QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_at
    • Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type
    • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.CountryOption.Me
    • Add support for requirements on TaxCode

See the changelog for more details.

Dec 16, 2025

This release changes the pinned API version to 2025-12-15.preview.

  • #1653 Add EventNotificationHandler
  • #1680 Update generated code for beta
    • Add support for new resources reserve.Hold, reserve.Plan, and reserve.Release
    • Add support for list and retrieve methods on resources reserve.Hold and reserve.Release
    • Add support for retrieve method on resource reserve.Plan
    • Change Billing.CreditBalanceSummary.customer_account, Billing.CreditGrant.customer_account, BillingPortal.Session.customer_account, CashBalance.customer_account, Checkout.Session.customer_account, ConfirmationToken.PaymentMethodPreview.customer_account, CreditNote.customer_account, CustomerBalanceTransaction.customer_account, CustomerCashBalanceTransaction.customer_account, CustomerSession.customer_account, Discount.customer_account, Invoice.customer_account, InvoiceItem.customer_account, PaymentIntent.customer_account, PaymentMethod.customer_account, PromotionCode.customer_account, Quote.customer_account, QuotePreviewInvoice.customer_account, QuotePreviewSubscriptionSchedule.customer_account, SetupAttempt.customer_account, Subscription.customer_account, SubscriptionSchedule.customer_account, TaxId.Owner.customer_account, and TaxId.customer_account to be required
    • Change type of V2.FinancialAddressGeneratedMicrodeposits.amounts from amount to an object
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.amount from longInteger to emptyable(longInteger)
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount_type, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.amount_type, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.amount_type from enum('fixed'|'maximum') to emptyable(enum('fixed'|'maximum'))
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.end_date, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.end_date, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.end_date, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.end_date, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.end_date from string to emptyable(string)
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payment_schedule, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.payment_schedule from enum to emptyable(enum)
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.payments_per_period, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.payments_per_period from longInteger to emptyable(longInteger)
    • Change type of PaymentIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.purpose, PaymentIntentCreateParamsPaymentMethodOptionPaytoMandateOption.purpose, PaymentIntentModifyParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.purpose, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.purpose, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.purpose from enum to emptyable(enum)
    • Change type of SetupIntentConfirmParamsPaymentMethodOptionPaytoMandateOption.start_date, SetupIntentCreateParamsPaymentMethodOptionPaytoMandateOption.start_date, SetupIntentModifyParamsPaymentMethodOptionPaytoMandateOption.start_date, and checkout.SessionCreateParamsPaymentMethodOptionPaytoMandateOption.start_date from string to emptyable(string)
    • Change Identity.VerificationSession.related_customer_account to be required
    • Add support for async_workflows on PaymentIntent
    • Add support for payto on QuotePreviewInvoice.PaymentSetting.PaymentMethodOption
    • Add support for new value payto on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
    • Remove support for requested on V2.Core.Account.Configuration.Customer.Capability.AutomaticIndirectTax, V2.Core.Account.Configuration.Merchant.Capability.AchDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.AcssDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.AffirmPayment, V2.Core.Account.Configuration.Merchant.Capability.AfterpayClearpayPayment, V2.Core.Account.Configuration.Merchant.Capability.AlmaPayment, V2.Core.Account.Configuration.Merchant.Capability.AmazonPayPayment, V2.Core.Account.Configuration.Merchant.Capability.AuBecsDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.BacsDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.BancontactPayment, V2.Core.Account.Configuration.Merchant.Capability.BlikPayment, V2.Core.Account.Configuration.Merchant.Capability.BoletoPayment, V2.Core.Account.Configuration.Merchant.Capability.CardPayment, V2.Core.Account.Configuration.Merchant.Capability.CartesBancairesPayment, V2.Core.Account.Configuration.Merchant.Capability.CashappPayment, V2.Core.Account.Configuration.Merchant.Capability.EpsPayment, V2.Core.Account.Configuration.Merchant.Capability.FpxPayment, V2.Core.Account.Configuration.Merchant.Capability.GbBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.GrabpayPayment, V2.Core.Account.Configuration.Merchant.Capability.IdealPayment, V2.Core.Account.Configuration.Merchant.Capability.JcbPayment, V2.Core.Account.Configuration.Merchant.Capability.JpBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.KakaoPayPayment, V2.Core.Account.Configuration.Merchant.Capability.KlarnaPayment, V2.Core.Account.Configuration.Merchant.Capability.KonbiniPayment, V2.Core.Account.Configuration.Merchant.Capability.KrCardPayment, V2.Core.Account.Configuration.Merchant.Capability.LinkPayment, V2.Core.Account.Configuration.Merchant.Capability.MobilepayPayment, V2.Core.Account.Configuration.Merchant.Capability.MultibancoPayment, V2.Core.Account.Configuration.Merchant.Capability.MxBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.NaverPayPayment, V2.Core.Account.Configuration.Merchant.Capability.OxxoPayment, V2.Core.Account.Configuration.Merchant.Capability.P24Payment, V2.Core.Account.Configuration.Merchant.Capability.PayByBankPayment, V2.Core.Account.Configuration.Merchant.Capability.PaycoPayment, V2.Core.Account.Configuration.Merchant.Capability.PaynowPayment, V2.Core.Account.Configuration.Merchant.Capability.PromptpayPayment, V2.Core.Account.Configuration.Merchant.Capability.RevolutPayPayment, V2.Core.Account.Configuration.Merchant.Capability.SamsungPayPayment, V2.Core.Account.Configuration.Merchant.Capability.SepaBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.SepaDebitPayment, V2.Core.Account.Configuration.Merchant.Capability.StripeBalance.Payout, V2.Core.Account.Configuration.Merchant.Capability.SwishPayment, V2.Core.Account.Configuration.Merchant.Capability.TwintPayment, V2.Core.Account.Configuration.Merchant.Capability.UsBankTransferPayment, V2.Core.Account.Configuration.Merchant.Capability.ZipPayment, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Local, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Wire, V2.Core.Account.Configuration.Recipient.Capability.Card, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.Payout, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.StripeTransfer, V2.Core.Account.Configuration.Storer.Capability.FinancialAddress.BankAccount, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Eur, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Gbp, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Usd, V2.Core.Account.Configuration.Storer.Capability.InboundTransfer.BankAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.BankAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.Card, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.FinancialAccount, V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.BankAccount, and V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.FinancialAccount
    • Add support for new values al_bank_account, am_bank_account, bn_bank_account, bw_bank_account, dz_bank_account, gy_bank_account, jm_bank_account, jo_bank_account, kw_bank_account, lk_bank_account, ma_bank_account, om_bank_account, and tz_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
    • Change type of V2.Core.Account.Identity.BusinessDetail.AnnualRevenue.amount, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.amount, V2.MoneyManagement.Adjustment.amount, V2.MoneyManagement.InboundTransfer.amount, V2.MoneyManagement.OutboundPayment.amount, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.amount, V2.MoneyManagement.OutboundPaymentQuote.amount, V2.MoneyManagement.OutboundTransfer.amount, V2.MoneyManagement.ReceivedCredit.amount, V2.MoneyManagement.ReceivedDebit.amount, V2.MoneyManagement.Transaction.amount, v2.FinancialAddressCreditSimulationCreditParams.amount, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenue.amount, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenue.amount, v2.money_management.InboundTransferCreateParams.amount, v2.money_management.OutboundPaymentCreateParams.amount, v2.money_management.OutboundPaymentQuoteCreateParams.amount, and v2.money_management.OutboundTransferCreateParams.amount from amount to an object
    • Add support for new values at_stn, at_vat, be_vat, bg_vat, ca_gst_hst, cy_he, cy_vat, cz_vat, de_stn, dk_vat, ee_vat, es_vat, fi_vat, fr_rna, gr_afm, gr_vat, hr_mbs, hr_oib, hr_vat, hu_tin, hu_vat, ie_trn, ie_vat, lt_vat, lu_nif, lu_vat, lv_vat, mt_tin, mt_vat, my_itn, nl_rsin, nl_vat, nz_ird, pl_nip, pl_vat, ro_orc, ro_vat, se_vat, si_tin, si_vat, sk_dic, and sk_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type
    • Remove support for value hk_mbs from enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type
    • Add support for new values ar_cuil, at_stn, be_nrn, bg_ucn, bn_nric, ca_sin, ch_oasi, cl_rut, cn_pp, co_nuip, cr_ci, cy_tic, cz_rc, dk_cpr, do_cie, ec_ci, ee_ik, es_nif, fi_hetu, fr_nir, gb_nino, gr_afm, hr_oib, hu_ad, id_nik, ie_ppsn, is_kt, it_cf, jp_inc, ke_pin, li_peid, lt_ak, lu_nif, lv_pk, ng_nin, no_nin, nz_ird, pl_pesel, pt_nif, ro_cnp, se_pin, sk_dic, tr_tin, uy_dni, and za_id on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.type
    • Change V2.Core.Account.Default.responsibilities to be required
    • Change V2.Core.Account.Default.Responsibility.fees_collector to be optional
    • Change V2.Core.Account.Default.Responsibility.losses_collector to be optional
    • Add support for financial_connections_account on V2.Core.Vault.UsBankAccount and V2.MoneyManagement.PayoutMethod.BankAccount
    • Change type of V2.MoneyManagement.FinancialAccount.Balance.available, V2.MoneyManagement.Transaction.BalanceImpact.available, and V2.MoneyManagement.TransactionEntry.BalanceImpact.available from amount to an object
    • Change type of V2.MoneyManagement.FinancialAccount.Balance.inbound_pending, V2.MoneyManagement.Transaction.BalanceImpact.inbound_pending, and V2.MoneyManagement.TransactionEntry.BalanceImpact.inbound_pending from amount to an object
    • Change type of V2.MoneyManagement.FinancialAccount.Balance.outbound_pending, V2.MoneyManagement.Transaction.BalanceImpact.outbound_pending, and V2.MoneyManagement.TransactionEntry.BalanceImpact.outbound_pending from amount to an object
    • Change type of V2.MoneyManagement.InboundTransfer.From.debited, V2.MoneyManagement.OutboundPayment.From.debited, V2.MoneyManagement.OutboundPaymentQuote.From.debited, and V2.MoneyManagement.OutboundTransfer.From.debited from amount to an object
    • Change type of V2.MoneyManagement.InboundTransfer.To.credited, V2.MoneyManagement.OutboundPayment.To.credited, V2.MoneyManagement.OutboundPaymentQuote.To.credited, and V2.MoneyManagement.OutboundTransfer.To.credited from amount to an object
    • Add support for transfer on V2.MoneyManagement.ReceivedCredit.BalanceTransfer
    • Add support for new value transfer on enum V2.MoneyManagement.ReceivedCredit.BalanceTransfer.type
    • Change v2.core.AccountTokenCreateParams.identity to be optional
    • Change type of v2.core.AccountListParams.applied_configurations from string to enum('customer'|'merchant'|'recipient'|'storer')
    • Add support for event notification V2MoneyManagementPayoutMethodCreatedEvent with related object v2.money_management.PayoutMethod
    • Add support for error type ControlledByAlternateResourceError
    • Remove support for error type RateLimitError
    • Add support for error code account_token_required_for_v2_account on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

This release changes the pinned API version to 2025-12-15.clover.

  • #1696 Update generated code
    • Add support for new resources v2.core.AccountLink, v2.core.AccountPersonToken, v2.core.AccountPerson, v2.core.AccountToken, and v2.core.Account
    • Add support for create and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountToken
    • Add support for create method on resource v2.core.AccountLink
    • Add support for close, create, list, modify, and retrieve methods on resource v2.core.Account
    • Add support for create, delete, list, modify, and retrieve methods on resource v2.core.AccountPerson
    • Add support for customer_account on Billing.CreditBalanceSummary, Billing.CreditGrant, BillingPortal.Session, CashBalance, Checkout.Session, ConfirmationToken.PaymentMethodPreview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSessionCreateParams, CustomerSession, Customer, Discount, FinancialConnections.Account.AccountHolder, FinancialConnections.Session.AccountHolder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentModifyParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethodListParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuoteModifyParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentModifyParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.Owner, TaxIdCreateParamsOwner, TaxIdListParamsOwner, TaxId, billing.CreditBalanceSummaryRetrieveParams, billing.CreditBalanceTransactionListParams, billing.CreditGrantCreateParams, billing.CreditGrantListParams, billing_portal.SessionCreateParams, checkout.SessionCreateParams, checkout.SessionListParams, financial_connections.AccountListParamsAccountHolder, and financial_connections.SessionCreateParamsAccountHolder
    • Add support for metadata on LineItem and checkout.SessionCreateParamsLineItem
    • Add support for payto_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
    • Add support for signer on AccountCreateParamsDocumentProofOfRegistration, AccountCreateParamsDocumentProofOfUltimateBeneficialOwnership, AccountModifyParamsDocumentProofOfRegistration, and AccountModifyParamsDocumentProofOfUltimateBeneficialOwnership
    • Change CustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, SubscriptionCreateParams.customer, billing.CreditBalanceSummaryRetrieveParams.customer, billing.CreditBalanceTransactionListParams.customer, billing.CreditGrantCreateParams.customer, and billing_portal.SessionCreateParams.customer to be optional
    • Add support for billing_cycle_anchor on BillingPortal.Configuration.Feature.SubscriptionUpdate, billing_portal.ConfigurationCreateParamsFeatureSubscriptionUpdate, and billing_portal.ConfigurationModifyParamsFeatureSubscriptionUpdate
    • Add support for payto on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Mandate.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethodModifyParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, SubscriptionModifyParamsPaymentSettingPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOption
    • Add support for expected_debit_date on Charge.PaymentMethodDetail.AcssDebit, Charge.PaymentMethodDetail.AuBecsDebit, Charge.PaymentMethodDetail.BacsDebit, Charge.PaymentMethodDetail.NzBankAccount, Charge.PaymentMethodDetail.SepaDebit, Charge.PaymentMethodDetail.UsBankAccount, PaymentAttemptRecord.PaymentMethodDetail.AcssDebit, PaymentAttemptRecord.PaymentMethodDetail.AuBecsDebit, PaymentAttemptRecord.PaymentMethodDetail.BacsDebit, PaymentAttemptRecord.PaymentMethodDetail.NzBankAccount, PaymentAttemptRecord.PaymentMethodDetail.SepaDebit, PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount, PaymentRecord.PaymentMethodDetail.AcssDebit, PaymentRecord.PaymentMethodDetail.AuBecsDebit, PaymentRecord.PaymentMethodDetail.BacsDebit, PaymentRecord.PaymentMethodDetail.NzBankAccount, PaymentRecord.PaymentMethodDetail.SepaDebit, and PaymentRecord.PaymentMethodDetail.UsBankAccount
    • Add support for new value mollie on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bank
    • Add support for new value MLLENL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
    • Add support for new value payto on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, SetupIntentModifyParams.excluded_payment_method_types, and checkout.SessionCreateParams.excluded_payment_method_types
    • Add support for new value payto on enum checkout.SessionCreateParams.payment_method_types
    • Add support for line_items on checkout.SessionModifyParams
    • Add support for new value payto on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
    • Add support for new value payto on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
    • Add support for new value payto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
    • Add support for invoice on CustomerListCustomerBalanceTransactionParams
    • Add support for related_customer_account on Identity.VerificationSession, identity.VerificationSessionCreateParams, and identity.VerificationSessionListParams
    • Change type of InvoiceItem.Pricing.PriceDetail.price and InvoiceLineItem.Pricing.PriceDetail.price from string to expandable($Price)
    • Add support for new value payto on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
    • Add support for subtotal on InvoiceLineItem
    • Add support for authorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.PaymentMethodDetail.Card and PaymentRecord.PaymentMethodDetail.Card
    • Change PaymentIntent.transfer_data to be optional
    • Add support for new value payto on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_types
    • Add support for allow_redisplay on PaymentMethodListParams
    • Add support for reported_by on PaymentRecord
    • Change Product.tax_code to be optional
    • Add support for new values 2025-12-15.clover and 2026-01-28.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for changes on V2.Core.Event
    • Add support for error code account_token_required_for_v2_account on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
  • #1692 Updated bundled CA certificates
  • #1676 Add create_async method to EphemeralKey

See the changelog for more details.

Dec 14, 2025
  • #1693 Update generated code for private-preview
    • Add support for new resources shared_payment.GrantedToken, v2.iam.ApiKey, v2.payments.SettlementAllocationIntentSplit, v2.payments.SettlementAllocationIntent, and v2.tax.ManualRule
    • Add support for retrieve method on resource shared_payment.GrantedToken
    • Add support for create and modify test helper methods on resource shared_payment.GrantedToken
    • Add support for create, deactivate, list, modify, and retrieve methods on resource v2.tax.ManualRule
    • Add support for cancel, create, modify, retrieve, and submit methods on resource v2.payments.SettlementAllocationIntent
    • Add support for cancel, create, and retrieve methods on resource v2.payments.SettlementAllocationIntentSplit
    • Add support for create, expire, list, modify, retrieve, and rotate methods on resource v2.iam.ApiKey
    • Add support for check_scanning on AccountSessionCreateParamsComponent
    • Add support for tax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatum
    • Add support for payment_method_data on delegated_checkout.RequestedSessionConfirmParams
    • Add support for product_details on DelegatedCheckout.RequestedSession.LineItemDetail
    • Add support for wallets on issuing.CardListParams
    • Add support for primary_account_identifier on Issuing.Card.Wallet.ApplePay and Issuing.Card.Wallet.GooglePay
    • Add support for shared_payment_granted_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntent
    • Change ProductCatalog.TrialOffer.Duration.relative to be optional
    • Add support for new values al_bank_account, am_bank_account, bn_bank_account, bw_bank_account, dz_bank_account, gy_bank_account, jm_bank_account, jo_bank_account, kw_bank_account, lk_bank_account, ma_bank_account, om_bank_account, and tz_bank_account on enum V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type
    • Add support for instant on V2.Account.Configuration.RecipientDatum.Feature.BankAccount, V2.Core.Account.Configuration.Recipient.Capability.BankAccount, v2.AccountCreateParamsConfigurationRecipientDatumFeatureBankAccount, v2.AccountModifyParamsConfigurationRecipientDatumFeatureBankAccount, v2.core.AccountCreateParamsConfigurationRecipientCapabilityBankAccount, and v2.core.AccountModifyParamsConfigurationRecipientCapabilityBankAccount
    • Add support for new value bank_accounts.instant on enum V2.Account.Requirement.Impact.required_for_features
    • Add support for collect_at on V2.Billing.IntentAction.Deactivate, V2.Billing.IntentAction.Modify, V2.Billing.IntentAction.Subscribe, v2.billing.IntentCreateParamsActionDeactivate, v2.billing.IntentCreateParamsActionModify, and v2.billing.IntentCreateParamsActionSubscribe
    • Remove support for billing_details on V2.Billing.IntentAction.Deactivate, V2.Billing.IntentAction.Modify, V2.Billing.IntentAction.Subscribe, v2.billing.IntentCreateParamsActionDeactivate, v2.billing.IntentCreateParamsActionModify, and v2.billing.IntentCreateParamsActionSubscribe
    • Add support for overrides on V2.Billing.IntentAction.Deactivate.PricingPlanSubscriptionDetail, V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail, v2.billing.IntentCreateParamsActionDeactivatePricingPlanSubscriptionDetail, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetail, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetail
    • Remove support for requested on V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Celtic.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Celtic.SpendCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank.SpendCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Lead.PrepaidCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Stripe.ChargeCard, V2.Core.Account.Configuration.CardCreator.Capability.Commercial.Stripe.PrepaidCard, V2.Core.Account.Configuration.Recipient.Capability.CryptoWallet, V2.Core.Account.Configuration.Storer.Capability.FinancialAddress.CryptoWallet, V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency.Usdc, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment.CryptoWallet, and V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer.CryptoWallet
    • Add support for new value bank_accounts.instant on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for alternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod
    • Add support for managed_by and payments on V2.MoneyManagement.FinancialAccount
    • Add support for new value payments on enum V2.MoneyManagement.FinancialAccount.type
    • Add support for speed on V2.MoneyManagement.OutboundPayment.DeliveryOption, V2.MoneyManagement.OutboundPaymentQuote.DeliveryOption, v2.money_management.OutboundPaymentCreateParamsDeliveryOption, and v2.money_management.OutboundPaymentQuoteCreateParamsDeliveryOption
    • Add support for new value real_time_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.type
    • Add support for types on v2.money_management.FinancialAccountListParams
    • Change type of v2.core.AccountListParams.applied_configurations from string to enum
    • Add support for new value bank_accounts.instant on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
    • Add support for top_impacted_accounts on EventsV2CoreHealthApiErrorFiringEvent.Impact, EventsV2CoreHealthApiErrorResolvedEvent.Impact, EventsV2CoreHealthApiLatencyFiringEvent.Impact, EventsV2CoreHealthApiLatencyResolvedEvent.Impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.Impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.Impact
    • Add support for event notifications V2CoreHealthSepaDebitDelayedFiringEvent, V2CoreHealthSepaDebitDelayedResolvedEvent, and V2PaymentsSettlementAllocationIntentNotFoundEvent
    • Add support for event notifications V2PaymentsSettlementAllocationIntentCanceledEvent, V2PaymentsSettlementAllocationIntentCreatedEvent, V2PaymentsSettlementAllocationIntentErroredEvent, V2PaymentsSettlementAllocationIntentFundsNotReceivedEvent, V2PaymentsSettlementAllocationIntentMatchedEvent, V2PaymentsSettlementAllocationIntentSettledEvent, and V2PaymentsSettlementAllocationIntentSubmittedEvent with related object v2.payments.SettlementAllocationIntent
    • Add support for event notifications V2PaymentsSettlementAllocationIntentSplitCanceledEvent, V2PaymentsSettlementAllocationIntentSplitCreatedEvent, and V2PaymentsSettlementAllocationIntentSplitSettledEvent with related object v2.payments.SettlementAllocationIntentSplit
    • Remove support for error code account_rate_limit_exceeded on RateLimitError

See the changelog for more details.

Dec 4, 2025
  • #1691 Update generated code for private-preview
    • Add support for event notifications V2IamApiKeyCreatedEvent, V2IamApiKeyDefaultSecretRevealedEvent, V2IamApiKeyExpiredEvent, V2IamApiKeyPermissionsUpdatedEvent, V2IamApiKeyRotatedEvent, and V2IamApiKeyUpdatedEvent
  • #1686 Update generated code for private-preview
    • Add support for check_scanning on AccountSession.Component
    • Add support for client on V2.Core.Event.Reason.Request
    • Add support for stripe_balance_payment on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
    • Add support for new value stripe_balance_payment on enum V2.MoneyManagement.ReceivedCredit.type
    • Add support for balance_transfer on V2.MoneyManagement.ReceivedDebit
    • Add support for new values balance_transfer and stripe_balance_payment on enum V2.MoneyManagement.ReceivedDebit.type
    • Add support for include on v2.core.EventListParams and v2.core.EventRetrieveParams

See the changelog for more details.

Nov 24, 2025
  • #1685 Update generated code for private-preview
    • Add support for new resource product_catalog.TrialOffer
    • Add support for create method on resource product_catalog.TrialOffer
    • Remove support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.LineItemDetail and DelegatedCheckout.RequestedSession.TotalDetail
    • Remove support for amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.LineItemDetail
    • Add support for amount_cart_discount and amount_items_discount on DelegatedCheckout.RequestedSession.TotalDetail
    • Remove support for amount_discount on DelegatedCheckout.RequestedSession.TotalDetail
    • Add support for payments_orchestration on PaymentIntentCreateParams and PaymentIntent

See the changelog for more details.

Nov 22, 2025
  • #1684 Update generated code
    • stripe.error module is now accessible globally. Fixes #1682
  • #1681 Throw a specific error when accessing payment_intent property on Invoice object to ease debugging.

See the changelog for more details.

Nov 20, 2025

This release changes the pinned API version to 2025-11-17.preview.

  • #1679 Update generated code for private-preview
    • Add support for new resources v2.core.AccountPersonToken, v2.core.AccountToken, and v2.money_management.CurrencyConversion
    • Add support for create, list, and retrieve methods on resource v2.money_management.CurrencyConversion
    • Add support for create and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountToken
    • Add support for effective_at on InvoiceCreatePreviewParamsScheduleDetailAmendment, InvoiceCreatePreviewParamsScheduleDetailPhase, QuoteCreateParamsLine, QuoteLine, QuoteModifyParamsLine, QuotePreviewSubscriptionSchedule.Phase, SubscriptionSchedule.Phase, SubscriptionScheduleAmendParamsAmendment, SubscriptionScheduleCreateParamsPhase, and SubscriptionScheduleModifyParamsPhase
    • Add support for trial_offer on InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSet, InvoiceCreatePreviewParamsScheduleDetailPhaseItem, QuoteCreateParamsLineActionAddItem, QuoteCreateParamsLineActionSetItem, QuoteLine.Action.AddItem, QuoteLine.Action.SetItem, QuoteModifyParamsLineActionAddItem, QuoteModifyParamsLineActionSetItem, QuotePreviewSubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase.Item, SubscriptionScheduleAmendParamsAmendmentItemActionAdd, SubscriptionScheduleAmendParamsAmendmentItemActionSet, SubscriptionScheduleCreateParamsPhaseItem, and SubscriptionScheduleModifyParamsPhaseItem
    • Change type of DelegatedCheckout.RequestedSession.amount_subtotal from longInteger to nullable(longInteger)
    • Change type of DelegatedCheckout.RequestedSession.amount_total from longInteger to nullable(longInteger)
    • Add support for amount_discount, amount_subtotal, amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.LineItemDetail
    • Add support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.LineItemDetail and DelegatedCheckout.RequestedSession.TotalDetail
    • Change type of InvoiceCreatePreviewParamsScheduleDetail.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
    • Remove support for values amendment_end, line_ends_at, schedule_end, and upcoming_invoice from enums InvoiceCreatePreviewParamsSubscriptionDetailBillingScheduleBillUntil.type, Subscription.BillingSchedule.BillUntil.type, SubscriptionCreateParamsBillingScheduleBillUntil.type, SubscriptionModifyParamsBillingScheduleBillUntil.type, SubscriptionScheduleCreateParamsBillingScheduleBillUntil.type, and SubscriptionScheduleModifyParamsBillingScheduleBillUntil.type
    • Add support for current_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItem
    • Change type of QuoteCreateParamsSubscriptionDataOverride.billing_schedules and QuoteCreateParamsSubscriptionDatum.billing_schedules from emptyable(array(billing_schedules_create_specs)) to array(billing_schedules_create_specs)
    • Add support for new value line_start on enums QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_at
    • Remove support for value phase_start from enums QuoteCreateParamsSubscriptionDataOverride.phase_effective_at, QuoteCreateParamsSubscriptionDatum.phase_effective_at, QuoteModifyParamsSubscriptionDataOverride.phase_effective_at, and QuoteModifyParamsSubscriptionDatum.phase_effective_at
    • Change type of Quote.SubscriptionDataOverride.billing_schedules and Quote.SubscriptionDatum.billing_schedules from nullable(array(SubscriptionsResourceBillingSchedules)) to array(QuotesResourceSubscriptionDataBillingSchedules)
    • Change type of Quote.SubscriptionDataOverride.phase_effective_at and Quote.SubscriptionDatum.phase_effective_at from nullable(enum('billing_period_start'|'phase_start')) to enum('billing_period_start'|'line_start')
    • Change type of QuotePreviewSubscriptionSchedule.DefaultSetting.phase_effective_at and SubscriptionSchedule.DefaultSetting.phase_effective_at from nullable(enum('billing_period_start'|'phase_start')) to enum('billing_period_start'|'phase_start')
    • Change type of QuotePreviewSubscriptionSchedule.billing_schedules and SubscriptionSchedule.billing_schedules from nullable(array(SubscriptionsResourceBillingSchedules)) to array(SubscriptionsResourceBillingSchedules)
    • Remove support for amendment_start, line_starts_at, and relative on Subscription.BillingSchedule.BillFrom
    • Change type of Subscription.BillingSchedule.BillFrom.computed_timestamp from nullable(DateTime) to DateTime
    • Change type of Subscription.BillingSchedule.BillFrom.type from enum to literal('timestamp')
    • Remove support for amendment_end and line_ends_at on Subscription.BillingSchedule.BillUntil
    • Change type of V2.Billing.ServiceAction.CreditGrant.Amount.monetary, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.monetary, v2.billing.ServiceActionCreateParamsCreditGrantAmount.monetary, and v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmount.monetary from amount to an object
    • Add support for future_requirements on V2.Core.Account
    • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
    • Add support for eur on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrency
    • Add support for requirements_collector on V2.Core.Account.Default.Responsibility
    • Add support for new value ar_cuit on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type
    • Add support for new value ar_dni on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, and v2.core.AccountPersonModifyParamsIdNumber.type
    • Remove support for collector on V2.Core.Account.Requirement
    • Add support for new value holds_currencies.eur on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for new values payment_method and person on enum V2.Core.Account.Requirement.Entry.Reference.type
    • Remove support for value resource from enum V2.Core.Account.Requirement.Entry.Reference.type
    • Remove support for value future_requirements from enum V2.Core.Account.Requirement.Entry.RequestedReason.code
    • Remove support for v1_event_id on V2.Core.Event
    • Remove support for amount_details and capture_method on V2.Payments.OffSessionPayment and v2.payments.OffSessionPaymentCreateParams
    • Change type of V2.Payments.OffSessionPayment.amount_capturable from amount to an object
    • Change type of V2.Payments.OffSessionPayment.amount_requested from amount to an object
    • Change type of v2.payments.OffSessionPaymentCreateParams.amount from amount to an object
    • Add support for new value best_available on enum v2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategy
    • Remove support for values heuristic, scheduled, and smart from enum v2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategy
    • Change v2.payments.OffSessionPaymentCreateParamsRetryDetail.retry_strategy to be optional
    • Remove support for destination on v2.payments.OffSessionPaymentCaptureParamsTransferDatum
    • Change v2.payments.OffSessionPaymentCaptureParams.amount_to_capture to be optional
    • Add support for created on v2.core.EventListParams
    • Remove support for gt, gte, lt, and lte on v2.core.EventListParams
    • Add support for account_token on v2.core.AccountCreateParams and v2.core.AccountModifyParams
    • Add support for new value future_requirements on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.include
    • Add support for person_token on v2.core.AccountPersonCreateParams and v2.core.AccountPersonModifyParams
    • Add support for impacted_requests_percentage on EventsV2CoreHealthApiErrorFiringEvent.Impact, EventsV2CoreHealthApiErrorResolvedEvent.Impact, EventsV2CoreHealthApiLatencyFiringEvent.Impact, EventsV2CoreHealthApiLatencyResolvedEvent.Impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.Impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.Impact
    • Add support for context and related_object on EventsV2CoreHealthEventGenerationFailureResolvedEvent.Impact
    • Remove support for account, livemode, missing_delivery_attempts, and related_object_id on EventsV2CoreHealthEventGenerationFailureResolvedEvent.Impact
    • Change type of EventsV2CoreHealthFraudRateIncreasedEvent.Impact.realized_fraud_amount from amount to an object
    • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.approved_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.approved_amount from amount to an object
    • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.declined_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.declined_amount from amount to an object
    • Add support for thin events V2PaymentsOffSessionPaymentAttemptFailedEvent and V2PaymentsOffSessionPaymentAttemptStartedEvent with related object v2.payments.OffSessionPayment
    • Remove support for thin event V1AccountUpdatedEvent with related object Account
    • Remove support for thin events V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee
    • Remove support for thin events V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object billing_portal.Configuration
    • Remove support for thin event V1CapabilityUpdatedEvent with related object Capability
    • Remove support for thin events V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge
    • Remove support for thin events V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute
    • Remove support for thin events V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund
    • Remove support for thin events V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object checkout.Session
    • Remove support for thin events V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object climate.Order
    • Remove support for thin events V1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object climate.Product
    • Remove support for thin events V1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object Coupon
    • Remove support for thin events V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNote
    • Remove support for thin events V1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object Customer
    • Remove support for thin events V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object Subscription
    • Remove support for thin events V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxId
    • Remove support for thin event V1FileCreatedEvent with related object File
    • Remove support for thin events V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object financial_connections.Account
    • Remove support for thin events V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object identity.VerificationSession
    • Remove support for thin events V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object Invoice
    • Remove support for thin event V1InvoicePaymentPaidEvent with related object InvoicePayment
    • Remove support for thin events V1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItem
    • Remove support for thin events V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object issuing.Authorization
    • Remove support for thin events V1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object issuing.Card
    • Remove support for thin events V1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object issuing.Cardholder
    • Remove support for thin events V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object issuing.Dispute
    • Remove support for thin events V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object issuing.PersonalizationDesign
    • Remove support for thin events V1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object issuing.Token
    • Remove support for thin events V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object issuing.Transaction
    • Remove support for thin event V1MandateUpdatedEvent with related object Mandate
    • Remove support for thin events V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntent
    • Remove support for thin events V1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLink
    • Remove support for thin events V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethod
    • Remove support for thin events V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object Payout
    • Remove support for thin events V1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object Person
    • Remove support for thin events V1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object Plan
    • Remove support for thin events V1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object Price
    • Remove support for thin events V1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object Product
    • Remove support for thin events V1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCode
    • Remove support for thin events V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object Quote
    • Remove support for thin events V1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object radar.EarlyFraudWarning
    • Remove support for thin events V1ReviewClosedEvent and V1ReviewOpenedEvent with related object Review
    • Remove support for thin events V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntent
    • Remove support for thin event V1SigmaScheduledQueryRunCreatedEvent with related object sigma.ScheduledQueryRun
    • Remove support for thin events V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object Source
    • Remove support for thin events V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionSchedule
    • Remove support for thin events V1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRate
    • Remove support for thin events V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object terminal.Reader
    • Remove support for thin events V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object test_helpers.TestClock
    • Remove support for thin events V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object Topup
    • Remove support for thin events V1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transfer

See the changelog for more details.

Nov 18, 2025

This release changes the pinned API version to 2025-11-17.preview.

  • #1675 Update generated code for private-preview
    • Add support for billing_schedules_actions on InvoiceCreatePreviewParamsScheduleDetailAmendment and SubscriptionScheduleAmendParamsAmendment
  • #1674 Update generated code for private-preview
    • Add support for new resources BalanceTransfer and radar.AccountEvaluation
    • Add support for create method on resource BalanceTransfer
    • Add support for create, modify, and retrieve methods on resource radar.AccountEvaluation
    • Change Tax.Association.tax_transaction_attempts to be required
    • Add support for specified_commercial_transactions_act_url on Account.BusinessProfile, AccountCreateParamsBusinessProfile, and AccountModifyParamsBusinessProfile
    • Add support for paypay_payments on Account.Setting, AccountCreateParamsSetting, and AccountModifyParamsSetting
    • Change type of billing.analytics.MeterUsageRetrieveParamsMeter.dimension_filters from string to array(string)
    • Change type of billing.analytics.MeterUsageRetrieveParamsMeter.tenant_filters from string to array(string)
    • Add support for payment_method_configuration on BillingPortal.Configuration.Feature.PaymentMethodUpdate
    • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetail
    • Add support for transaction_id on Charge.PaymentMethodDetail.Ideal, PaymentAttemptRecord.PaymentMethodDetail.Ideal, and PaymentRecord.PaymentMethodDetail.Ideal
    • Add support for new value finom on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bank
    • Add support for new value FNOMNL22 on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
    • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reason and PaymentMethod.UsBankAccount.StatusDetail.Blocked.reason
    • Add support for created on CustomerListCustomerBalanceTransactionParams and InvoicePaymentListParams
    • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enum Event.type
    • Add support for account_numbers on FinancialConnections.Account
    • Change type of FinancialConnections.Session.client_secret from string to nullable(string)
    • Add support for fraud_risk on issuing.AuthorizationCreateParamsRiskAssessment
    • Add support for latest_fraud_warning on Issuing.Card
    • Add support for supplementary_purchase_data on OrderCreateParamsPaymentSettingPaymentMethodOptionKlarna, OrderModifyParamsPaymentSettingPaymentMethodOptionKlarna, PaymentIntentConfirmParamsPaymentMethodOptionKlarna, PaymentIntentCreateParamsPaymentMethodOptionKlarna, and PaymentIntentModifyParamsPaymentMethodOptionKlarna
    • Add support for capture_method on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardPresent
    • Add support for allow_redisplay and customer_account on PaymentMethodListParams
    • Add support for mb_way and twint on Refund.DestinationDetail
    • Change type of SubscriptionScheduleModifyParams.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
    • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events
    • Add support for new value 2025-11-17.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for snapshot events financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financial_connections.Account

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.preview.

  • #1663 Update generated code for beta
    • Add support for new resources v2.core.AccountPersonToken and v2.core.AccountToken
    • Remove support for resource v2.payments.OffSessionPayment
    • Add support for create and retrieve methods on resources v2.core.AccountPersonToken and v2.core.AccountToken
    • Remove support for cancel, capture, create, list, and retrieve methods on resource v2.payments.OffSessionPayment
    • Change Tax.Association.tax_transaction_attempts to be required
    • Add support for specified_commercial_transactions_act_url on Account.BusinessProfile, AccountCreateParamsBusinessProfile, and AccountModifyParamsBusinessProfile
    • Add support for paypay_payments on Account.Setting, AccountCreateParamsSetting, and AccountModifyParamsSetting
    • Change type of billing.analytics.MeterUsageRetrieveParamsMeter.dimension_filters from string to array(string)
    • Change type of billing.analytics.MeterUsageRetrieveParamsMeter.tenant_filters from string to array(string)
    • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetail
    • Add support for supplementary_purchase_data on OrderCreateParamsPaymentSettingPaymentMethodOptionKlarna, OrderModifyParamsPaymentSettingPaymentMethodOptionKlarna, PaymentIntentConfirmParamsPaymentMethodOptionKlarna, PaymentIntentCreateParamsPaymentMethodOptionKlarna, and PaymentIntentModifyParamsPaymentMethodOptionKlarna
    • Add support for allow_redisplay and customer_account on PaymentMethodListParams
    • Add support for future_requirements on V2.Core.Account
    • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
    • Add support for eur on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrency
    • Add support for requirements_collector on V2.Core.Account.Default.Responsibility
    • Add support for new value ar_cuit on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type
    • Add support for new value ar_dni on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, and v2.core.AccountPersonModifyParamsIdNumber.type
    • Remove support for collector on V2.Core.Account.Requirement
    • Add support for new value holds_currencies.eur on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for new values payment_method and person on enum V2.Core.Account.Requirement.Entry.Reference.type
    • Remove support for value resource from enum V2.Core.Account.Requirement.Entry.Reference.type
    • Remove support for value future_requirements from enum V2.Core.Account.Requirement.Entry.RequestedReason.code
    • Add support for changes on V2.Core.Event
    • Remove support for value sepa_bank_account from enums V2.MoneyManagement.FinancialAddress.Credential.type and v2.money_management.FinancialAddressCreateParams.type
    • Add support for account_token on v2.core.AccountCreateParams and v2.core.AccountModifyParams
    • Add support for new value future_requirements on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.include
    • Add support for person_token on v2.core.AccountPersonCreateParams and v2.core.AccountPersonModifyParams
    • Add support for thin event V2CoreHealthEventGenerationFailureResolvedEvent
    • Remove support for thin events V2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent, V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent, V2PaymentsOffSessionPaymentCanceledEvent, V2PaymentsOffSessionPaymentCreatedEvent, V2PaymentsOffSessionPaymentFailedEvent, V2PaymentsOffSessionPaymentRequiresCaptureEvent, and V2PaymentsOffSessionPaymentSucceededEvent with related object v2.payments.OffSessionPayment
  • #1670 Ramya/merge python beta

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.clover.

  • #1673 Update generated code
    • ⚠️ Remove support for gt, gte, lt, and lte on v2.core.EventListParams in favor of created.
  • #1669 Update v2 array parameter serialization to use indexed format
    • Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
  • #1667 Update generated code
    • Add support for new resources tax.Association and terminal.OnboardingLink
    • Add support for find method on resource tax.Association
    • Add support for create method on resource terminal.OnboardingLink
    • Add support for payment_method_configuration on BillingPortal.Configuration.Feature.PaymentMethodUpdate
    • Add support for transaction_id on Charge.PaymentMethodDetail.Ideal, PaymentAttemptRecord.PaymentMethodDetail.Ideal, and PaymentRecord.PaymentMethodDetail.Ideal
    • Add support for new value finom on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank, PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank, PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.Ideal.bank, PaymentMethodCreateParamsIdeal.bank, PaymentRecord.PaymentMethodDetail.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntentCreateParamsPaymentMethodDatumIdeal.bank, and SetupIntentModifyParamsPaymentMethodDatumIdeal.bank
    • Add support for new value FNOMNL22 on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic, PaymentMethod.Ideal.bic, PaymentRecord.PaymentMethodDetail.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
    • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reason and PaymentMethod.UsBankAccount.StatusDetail.Blocked.reason
    • Add support for created on CustomerListCustomerBalanceTransactionParams and InvoicePaymentListParams
    • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.type
    • Add support for account_numbers on FinancialConnections.Account
    • Change type of FinancialConnections.Session.client_secret from string to nullable(string)
    • Add support for fraud_risk on issuing.AuthorizationCreateParamsRiskAssessment
    • Add support for latest_fraud_warning on Issuing.Card
    • Add support for hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentModifyParams, and PaymentIntent
    • Add support for mb_way and twint on Refund.DestinationDetail
    • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events
    • Add support for snapshot events financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financial_connections.Account

See the changelog for more details.

Nov 13, 2025

This release changes the pinned API version to 2025-10-29.preview.

  • #1672 Update generated code for private-preview
    • Add support for new resource issuing.Program
    • Add support for create, list, modify, and retrieve methods on resource issuing.Program
    • Add support for schedule on Discount
    • Add support for applicable_fees on DelegatedCheckout.RequestedSession.TotalDetail
    • Add support for schedule_details on Invoice.Parent, InvoiceItem.Parent, InvoiceLineItem.Parent, and QuotePreviewInvoice.Parent
    • Add support for new value schedule_details on enum InvoiceItem.Parent.type
    • Add support for billing_schedules on InvoiceCreatePreviewParamsScheduleDetail, QuotePreviewSubscriptionSchedule, SubscriptionScheduleCreateParams, SubscriptionScheduleModifyParams, and SubscriptionSchedule
    • Add support for new value schedule_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.type
    • Add support for new value schedule_details on enum InvoiceLineItem.Parent.type
    • Add support for latest_invoice on QuotePreviewSubscriptionSchedule and SubscriptionSchedule
    • Add support for phase_effective_at on QuotePreviewSubscriptionSchedule.DefaultSetting, SubscriptionSchedule.DefaultSetting, SubscriptionScheduleCreateParamsDefaultSetting, and SubscriptionScheduleModifyParamsDefaultSetting
  • #1666 Update generated code for private-preview
    • Remove support for resource v2.tax.AutomaticRule
    • Remove support for create, deactivate, find, modify, and retrieve methods on resource v2.tax.AutomaticRule
    • Add support for self_reported_income and self_reported_monthly_housing_payment on AccountCreateParamsIndividual, AccountCreatePersonParams, AccountModifyParamsIndividual, AccountModifyPersonParams, Person, TokenCreateParamsAccountIndividual, and TokenCreateParamsPerson
    • Add support for new values amendment_end, line_ends_at, schedule_end, and upcoming_invoice on enums InvoiceCreatePreviewParamsSubscriptionDetailBillingScheduleBillUntil.type, Subscription.BillingSchedule.BillUntil.type, SubscriptionCreateParamsBillingScheduleBillUntil.type, and SubscriptionModifyParamsBillingScheduleBillUntil.type
    • Add support for billing_schedules and phase_effective_at on Quote.SubscriptionDataOverride, Quote.SubscriptionDatum, QuoteCreateParamsSubscriptionDataOverride, QuoteCreateParamsSubscriptionDatum, QuoteModifyParamsSubscriptionDataOverride, and QuoteModifyParamsSubscriptionDatum
    • Add support for bill_from on Subscription.BillingSchedule
    • Add support for amendment_end and line_ends_at on Subscription.BillingSchedule.BillUntil
    • Remove support for data and related_object on V2.Core.Event
  • #1671 Ramya/merge python private preview

See the changelog for more details.

Nov 6, 2025
  • #1664 Update generated code for private-preview
    • Add support for new resources TransitBalance, v2.reporting.ReportRun, v2.reporting.Report
    • Add support for create and retrieve methods on resource v2.reporting.ReportRun
    • Add support for retrieve method on resource v2.reporting.Report
    • Add support for create and refill test helper methods on resource capital.FinancingOffer
    • Add support for allocated_funds on Charge, PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentModifyParams
    • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRun

See the changelog for more details.

Nov 5, 2025
  • #1662 Update generated code
    • Add support for capture_method on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardPresent

See the changelog for more details.

Nov 4, 2025
  • #1661 Add support for value payment_record to enum InvoicePayment.payment.type

See the changelog for more details.

Oct 31, 2025
  • #1660 Fix stripe-context header not being included in paged list requests

See the changelog for more details.

Latest
v15.1.0a4
Tracking Since
Sep 21, 2023
Last fetched Apr 19, 2026