github stripe/stripe-python v14.2.0b1
on GitHub

pre-release16 hours ago

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.

Check out latest releases or
releases around stripe/stripe-python v14.2.0b1

Don't miss a new stripe-python release

NewReleases is sending notifications on new releases.

Get notifications