v12.5.0b2

• #1545 Bring back invoice payments APIs that were missing in the public preview SDKs
  • Add support for new resource InvoicePayment
  • Add support for list and retrieve methods on resource InvoicePayment

See the changelog for more details.

v12.5.0b1

This release changes the pinned API version to 2025-07-30.preview.

• #1535 Update generated code for beta
  • Add support for new resources billing.MeterUsageRow, billing.MeterUsage, and terminal.OnboardingLink
  • Add support for retrieve method on resource billing.MeterUsage
  • Add support for create method on resource terminal.OnboardingLink
  • Add support for monthly_payout_days and weekly_payout_days on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Schedule
  • Remove support for monthly_anchor and weekly_anchor on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Schedule
  • Add support for delay_days_override on BalanceSettings.ModifyParamsSettlementTiming
  • Remove support for delay_days on BalanceSettings.ModifyParamsSettlementTiming
  • Add support for update_discounts on checkout.Session.CreateParamsPermission
  • Add support for discounts and subscription_data on checkout.Session.ModifyParams
  • Add support for smart_disputes on Dispute
  • Add support for upi on Invoice.CreateParamsPaymentSettingPaymentMethodOption, Invoice.ModifyParamsPaymentSettingPaymentMethodOption, Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.CreateParamsPaymentSettingPaymentMethodOption, Subscription.ModifyParamsPaymentSettingPaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOption
  • Add support for new value upi on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_types
  • Add support for transaction_id on PaymentAttemptRecord.PaymentMethodDetail.Cashapp and PaymentRecord.PaymentMethodDetail.Cashapp
  • Add support for amount_details on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.IncrementAuthorizationParams, and PaymentIntent.ModifyParams
  • Add support for payment_details on PaymentIntent.IncrementAuthorizationParams
  • Add support for storer on V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.Account.CreateParamsIdentityAttestationTermsOfService, and v2.core.Account.ModifyParamsIdentityAttestationTermsOfService
  • Add support for collection_options on V2.Core.AccountLink.UseCase.AccountOnboarding, V2.Core.AccountLink.UseCase.AccountUpdate, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdate
  • Change type of V2.Core.AccountLink.UseCase.AccountOnboarding.configurations, V2.Core.AccountLink.UseCase.AccountUpdate.configurations, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding.configurations, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdate.configurations from literal('recipient') to enum('customer'|'merchant'|'recipient'|'storer')
  • Add support for bank_account_type on V2.MoneyManagement.PayoutMethod.BankAccount
  • Add support for thin event V2CoreAccountLinkReturnedEvent
  • Add support for thin event V2MoneyManagementPayoutMethodUpdatedEvent with related object v2.money_management.PayoutMethod
  • Remove support for thin event V2CoreAccountLinkCompletedEvent
  • Remove support for thin event V2OffSessionPaymentRequiresCaptureEvent with related object v2.payments.OffSessionPayment

See the changelog for more details.

v12.4.0

This release changes the pinned API version to 2025-07-30.basil.

• #1541 Update generated code
  • Add support for instant_payouts_promotion on AccountSession.Component and AccountSession.CreateParamsComponent
  • Add support for adjustable_quantity on BillingPortal.Configuration.Feature.SubscriptionUpdate.Product, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProduct
  • Remove support for value disabled from enum Capability.status
  • Add support for transaction_id on Charge.PaymentMethodDetail.Cashapp
  • Add support for origin_context on Checkout.Session and checkout.Session.CreateParams
  • Add support for template on Checkout.Session.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.CreateParamsInvoiceCreationInvoiceDatumRenderingOption, PaymentLink.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.ModifyParamsInvoiceCreationInvoiceDatumRenderingOption, and checkout.Session.CreateParamsInvoiceCreationInvoiceDatumRenderingOption
  • Add support for setup_future_usage on Checkout.Session.PaymentMethodOption.Pix and checkout.Session.CreateParamsPaymentMethodOptionPix
  • Add support for new value nz_bank_account on enum checkout.Session.CreateParams.payment_method_types
  • Change Identity.VerificationSession.RelatedPerson.account to be required
  • Change Identity.VerificationSession.RelatedPerson.person to be required
  • Add support for duration on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhase
  • Change type of Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at, Subscription.CreateParams.cancel_at, and Subscription.ModifyParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Add support for price_data on PaymentLink.CreateParamsLineItem
  • Change PaymentLink.CreateParamsLineItem.price to be optional
  • Add support for new value America/Coyhaique on enum reporting.ReportRun.CreateParamsParameter.timezone
  • Add support for standard on Tax.Registration.CountryOption.Ae, Tax.Registration.CountryOption.Au, Tax.Registration.CountryOption.Ch, Tax.Registration.CountryOption.Gb, Tax.Registration.CountryOption.Jp, Tax.Registration.CountryOption.No, Tax.Registration.CountryOption.Nz, Tax.Registration.CountryOption.Sg, tax.Registration.CreateParamsCountryOptionAe, tax.Registration.CreateParamsCountryOptionAl, tax.Registration.CreateParamsCountryOptionAo, tax.Registration.CreateParamsCountryOptionAu, tax.Registration.CreateParamsCountryOptionAw, tax.Registration.CreateParamsCountryOptionB, tax.Registration.CreateParamsCountryOptionBa, tax.Registration.CreateParamsCountryOptionBb, tax.Registration.CreateParamsCountryOptionBd, tax.Registration.CreateParamsCountryOptionBf, tax.Registration.CreateParamsCountryOptionBh, tax.Registration.CreateParamsCountryOptionCd, tax.Registration.CreateParamsCountryOptionCh, tax.Registration.CreateParamsCountryOptionEt, tax.Registration.CreateParamsCountryOptionGb, tax.Registration.CreateParamsCountryOptionGn, tax.Registration.CreateParamsCountryOptionIs, tax.Registration.CreateParamsCountryOptionJp, tax.Registration.CreateParamsCountryOptionMe, tax.Registration.CreateParamsCountryOptionMk, tax.Registration.CreateParamsCountryOptionMr, tax.Registration.CreateParamsCountryOptionNo, tax.Registration.CreateParamsCountryOptionNz, tax.Registration.CreateParamsCountryOptionOm, tax.Registration.CreateParamsCountryOptionR, tax.Registration.CreateParamsCountryOptionSg, tax.Registration.CreateParamsCountryOptionSr, tax.Registration.CreateParamsCountryOptionUy, tax.Registration.CreateParamsCountryOptionZa, and tax.Registration.CreateParamsCountryOptionZw
  • Add support for new value inbound_goods on enums Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme, and tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_scheme
  • Add support for aed, bgn, huf, and ron on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTipping
  • Add support for new value 2025-07-30.basil on enum WebhookEndpoint.CreateParams.api_version
• #1537 Fix timeout type hint in RequestsClient

See the changelog for more details.

v12.4.0b2

• #1536 Pull in V2 FinancialAccount changes for June release
  • Add support for close and create methods on resource v2.money_management.FinancialAccount
  • Add support for new value storer on enums V2.Core.Account.applied_configurations and v2.core.Account.CloseParams.applied_configurations
  • Add support for storer on V2.Core.Account.Configuration, v2.core.Account.CreateParamsConfiguration, and v2.core.Account.ModifyParamsConfiguration
  • Add support for new values financial_addresses.bank_accounts, holds_currencies.gbp, inbound_transfers.financial_accounts, outbound_payments.bank_accounts, outbound_payments.cards, outbound_payments.financial_accounts, outbound_transfers.bank_accounts, and outbound_transfers.financial_accounts on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for new value storer on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.configuration
  • Add support for status_details on V2.MoneyManagement.FinancialAccount
  • Add support for status on v2.money_management.FinancialAccount.ListParams
  • Add support for new value configuration.storer on enums v2.core.Account.CreateParams.include, v2.core.Account.ModifyParams.include, and v2.core.Account.RetrieveParams.include
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object v2.core.Account
  • Add support for error types AlreadyExistsError and NonZeroBalanceError

See the changelog for more details.

v12.4.0b1

• #1520 Update generated code for beta
  • Change type of Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, Subscription.CreateParams.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode from enum('classic'|'flexible') to billing_mode
  • Add support for submission_method on Dispute.EvidenceDetail
  • Add support for on_demand and subscriptions on Order.CreateParamsPaymentSettingPaymentMethodOptionKlarna and Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarna
  • Change type of Order.CreateParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, and Order.Payment.Setting.PaymentMethodOption.Klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for crypto on PaymentAttemptRecord.PaymentMethodDetail and PaymentRecord.PaymentMethodDetail
  • Add support for new value buut on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank and PaymentRecord.PaymentMethodDetail.Ideal.bank
  • Add support for new value BUUTNL2A on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic and PaymentRecord.PaymentMethodDetail.Ideal.bic
  • Change type of PaymentIntent.ConfirmParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionGopay.setup_future_usage, and PaymentIntent.PaymentMethodOption.Gopay.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Change Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be required
  • Add support for new value crypto on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
  • Change type of QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingMode
  • Change type of Subscription.MigrateParams.billing_mode from literal('flexible') to billing_mode_migrate
  • Remove support for billing_mode_details on Subscription
  • Add support for new value xx on enums V2.Core.Account.Configuration.Customer.AutomaticIndirectTax.Location.country, V2.Core.Account.Configuration.Customer.Shipping.Address.country, V2.Core.Account.Configuration.Merchant.Support.Address.country, V2.Core.Account.Identity.BusinessDetail.Address.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kana.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kanji.country, V2.Core.Account.Identity.Individual.AdditionalAddress.country, V2.Core.Account.Identity.Individual.Address.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kana.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kanji.country, V2.Core.Account.Identity.country, V2.Core.Person.AdditionalAddress.country, V2.Core.Person.Address.country, V2.Core.Person.ScriptAddress.Kana.country, V2.Core.Person.ScriptAddress.Kanji.country, V2.MoneyManagement.FinancialAccount.country, v2.core.Account.CreateParamsConfigurationCustomerShippingAddress.country, v2.core.Account.CreateParamsConfigurationMerchantSupportAddress.country, v2.core.Account.CreateParamsIdentity.country, v2.core.Account.CreateParamsIdentityBusinessDetailAddress.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.CreateParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.CreateParamsIdentityIndividualAddress.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKanji.country, v2.core.Account.ModifyParamsConfigurationCustomerShippingAddress.country, v2.core.Account.ModifyParamsConfigurationMerchantSupportAddress.country, v2.core.Account.ModifyParamsIdentity.country, v2.core.Account.ModifyParamsIdentityBusinessDetailAddress.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.ModifyParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.ModifyParamsIdentityIndividualAddress.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKanji.country, v2.core.Person.CreateParamsAdditionalAddress.country, v2.core.Person.CreateParamsAddress.country, v2.core.Person.CreateParamsScriptAddressKana.country, v2.core.Person.CreateParamsScriptAddressKanji.country, v2.core.Person.ModifyParamsAdditionalAddress.country, v2.core.Person.ModifyParamsAddress.country, v2.core.Person.ModifyParamsScriptAddressKana.country, and v2.core.Person.ModifyParamsScriptAddressKanji.country
  • Add support for new value unsupported_entity_type on enums V2.Core.Account.Configuration.Customer.Capability.AutomaticIndirectTax.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AchDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AcssDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AffirmPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AfterpayClearpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AlmaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AmazonPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AuBecsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BacsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BancontactPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BlikPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BoletoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CartesBancairesPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CashappPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.EpsPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.FpxPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GbBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GrabpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.IdealPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JcbPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JpBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KakaoPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KlarnaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KonbiniPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KrCardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.LinkPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MobilepayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MultibancoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MxBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.NaverPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.OxxoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.P24Payment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PayByBankPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaycoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaynowPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PromptpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.RevolutPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SamsungPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.StripeBalance.Payout.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SwishPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.TwintPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.UsBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.ZipPayment.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Local.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Wire.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.Card.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.Payout.StatusDetail.code, and V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.StripeTransfer.StatusDetail.code
  • Add support for proof_of_address on `V2.Core.Account.Identity.BusinessDetail.Doc...

v12.3.0

• #1526 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource terminal.Reader
  • Add support for crypto_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapability
  • Add support for proof_of_address on Account.CreateParamsDocument and Account.ModifyParamsDocument
  • Add support for monthly_payout_days and weekly_payout_days on Account.CreateParamsSettingPayoutSchedule, Account.ModifyParamsSettingPayoutSchedule, and Account.Setting.Payout.Schedule
  • Change Account.Setting.Invoice.hosted_payment_method_save to be required
  • Add support for crypto on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodDatum, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.ModifyParamsPaymentMethodDatum
  • Change type of Charge.PaymentMethodDetail.Card.Installment.Plan.type, ConfirmationToken.CreateParamsPaymentMethodOptionCardInstallmentPlan.type, ConfirmationToken.PaymentMethodOption.Card.Installment.Plan.type, Invoice.CreateParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type, Invoice.ModifyParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.ConfirmParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.CreateParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.ModifyParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.PaymentMethodOption.Card.Installment.AvailablePlan.type, and PaymentIntent.PaymentMethodOption.Card.Installment.Plan.type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')
  • Add support for new value buut on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.CreateParamsPaymentMethodDatumIdeal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, PaymentIntent.ConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntent.CreateParamsPaymentMethodDatumIdeal.bank, PaymentIntent.ModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.CreateParamsIdeal.bank, PaymentMethod.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntent.ConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntent.CreateParamsPaymentMethodDatumIdeal.bank, and SetupIntent.ModifyParamsPaymentMethodDatumIdeal.bank
  • Add support for new value BUUTNL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentMethod.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
  • Add support for subscriptions on PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna, PaymentIntent.CreateParamsPaymentMethodOptionKlarna, PaymentIntent.ModifyParamsPaymentMethodOptionKlarna, and checkout.Session.CreateParamsPaymentMethodOptionKlarna
  • Add support for new value crypto on enum checkout.Session.CreateParams.payment_method_types
  • Add support for billing_mode on Invoice.CreatePreviewParamsScheduleDetail, Invoice.CreatePreviewParamsSubscriptionDetail, Quote.CreateParamsSubscriptionDatum, Quote.SubscriptionDatum, Subscription.CreateParams, SubscriptionSchedule.CreateParams, SubscriptionSchedule, Subscription, and checkout.Session.CreateParamsSubscriptionDatum
  • Add support for new value crypto on enums ConfirmationToken.CreateParamsPaymentMethodDatum.type, PaymentIntent.ConfirmParamsPaymentMethodDatum.type, PaymentIntent.CreateParamsPaymentMethodDatum.type, PaymentIntent.ModifyParamsPaymentMethodDatum.type, SetupIntent.ConfirmParamsPaymentMethodDatum.type, SetupIntent.CreateParamsPaymentMethodDatum.type, and SetupIntent.ModifyParamsPaymentMethodDatum.type
  • Add support for new value crypto on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for new value crypto on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value compliance on enum Dispute.PaymentMethodDetail.Card.case_type
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSession and identity.VerificationSession.CreateParams
  • Add support for matching on Identity.VerificationSession.Option
  • Add support for new value crypto on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_types
  • Add support for klarna on Mandate.PaymentMethodDetail, SetupIntent.ConfirmParamsPaymentMethodOption, SetupIntent.CreateParamsPaymentMethodOption, SetupIntent.ModifyParamsPaymentMethodOption, and SetupIntent.PaymentMethodOption
  • Add support for on_demand on PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna, PaymentIntent.CreateParamsPaymentMethodOptionKlarna, and PaymentIntent.ModifyParamsPaymentMethodOptionKlarna
  • Change type of PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionKlarna.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionKlarna.setup_future_usage, and PaymentIntent.PaymentMethodOption.Klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for ua on Tax.Registration.CountryOption and tax.Registration.CreateParamsCountryOption
  • Change type of terminal.Location.ModifyParams.display_name from string to emptyable(string)
  • Add support for collect_payment_method and confirm_payment_intent on Terminal.Reader.Action
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.Action.type
  • Add support for status on treasury.FinancialAccount.ListParams
  • Add support for new value terminal.reader.action_updated on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.ModifyParams.enabled_events
  • Add support for new value 2025-06-30.basil on enum WebhookEndpoint.CreateParams.api_version
  • Add support for snapshot event terminal.reader.action_updated with resource terminal.Reader
• #1534 Fix the link to releases page from readme
• #1532 Added lint ignore instruction for deprecated import
• #1524 Added import for the new deprecated services in stripe_client
• #1522 Add a new deprecated v1 services section

See the changelog for more details.

v12.3.0b2

• #1531 Pull in OffSessionPayment changes for the May release

See the changelog for more details.

v12.3.0b1

This release changes the pinned API version to 2025-05-28.preview.

• #1509 Update generated code for beta

  Breaking changes

  • Remove support for deprecated previews
    • Remove support for resources billing.MeterErrorReport, gift_cards.Card, gift_cards.Transaction, and privacy.RedactionJobRootObjects
    • Remove support for create, list, modify, retrieve, and validate methods on resource gift_cards.Card
    • Remove support for cancel, confirm, create, list, modify, and retrieve methods on resource gift_cards.Transaction
    • Remove support for provisioning on Product.CreateParams and Product
    • Remove support for snapshot event billing.meter_error_report.triggered with resource billing.MeterErrorReport
    • Remove support for error codes gift_card_balance_insufficient, gift_card_code_exists, and gift_card_inactive on QuotePreviewInvoice.LastFinalizationError and StripeError
  • Remove support for values credits_attributed_to_debits and legacy_prorations from enums Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.CreateParams.billing_mode, Subscription.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, SubscriptionSchedule.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode
  • Change type of checkout.Session.ModifyParamsLineItem.quantity from emptyable(longInteger) to longInteger
  • Change CreditNote.post_payment_amount to be required
  • Change CreditNote.pre_payment_amount to be required
  • Remove support for credits on Order.CreateParams, Order.ModifyParams, and Order
  • Remove support for amount_remaining on Order
  • Remove support for amount_credit on Order.TotalDetail
  • Change type of PaymentAttemptRecord.metadata and PaymentRecord.metadata from nullable(map(string: string)) to map(string: string)
  • Remove support for async_workflows on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.DecrementAuthorizationParams, PaymentIntent.IncrementAuthorizationParams, PaymentIntent.ModifyParams, and PaymentIntent
  • Change type of PaymentRecord.ReportPaymentAttemptCanceledParams.metadata, PaymentRecord.ReportPaymentAttemptFailedParams.metadata, PaymentRecord.ReportPaymentAttemptGuaranteedParams.metadata, PaymentRecord.ReportPaymentAttemptParams.metadata, and PaymentRecord.ReportPaymentParams.metadata from map(string: string) to emptyable(map(string: string))
  • Change type of Privacy.RedactionJob.objects from $Privacy.RedactionJobRootObjects to RedactionResourceRootObjects
  • Change type of Privacy.RedactionJob.status from string to enum
  • Change type of Privacy.RedactionJob.validation_behavior from string to enum('error'|'fix')
  • Change type of Privacy.RedactionJobValidationError.code from string to enum
  • Change type of Privacy.RedactionJobValidationError.erroring_object from map(string: string) to RedactionResourceErroringObject
  • Remove support for status_details and status on Tax.Association

  Other changes

  • Add support for migrate method on resource Subscription
  • Add support for distance, pickup_location_name, return_location_name, and vehicle_identification_number on Charge.CaptureParamsPaymentDetailCarRental, Charge.ModifyParamsPaymentDetailCarRental, PaymentIntent.CaptureParamsPaymentDetailCarRental, PaymentIntent.ConfirmParamsPaymentDetailCarRental, PaymentIntent.CreateParamsPaymentDetailCarRental, PaymentIntent.ModifyParamsPaymentDetailCarRental, and PaymentIntent.PaymentDetail.CarRental
  • Add support for driver_identification_number and driver_tax_number on Charge.CaptureParamsPaymentDetailCarRentalDriver, Charge.ModifyParamsPaymentDetailCarRentalDriver, PaymentIntent.CaptureParamsPaymentDetailCarRentalDriver, PaymentIntent.ConfirmParamsPaymentDetailCarRentalDriver, PaymentIntent.CreateParamsPaymentDetailCarRentalDriver, PaymentIntent.ModifyParamsPaymentDetailCarRentalDriver, and PaymentIntent.PaymentDetail.CarRental.Driver
  • Add support for new values classic and flexible on enums Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.CreateParams.billing_mode, Subscription.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, SubscriptionSchedule.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode
  • Add support for institution on FinancialConnections.Account
  • Add support for countries on FinancialConnections.Institution
  • Change type of Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at, Subscription.CreateParams.cancel_at, and Subscription.ModifyParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Add support for location and reader on PaymentAttemptRecord.PaymentMethodDetail.Affirm, PaymentAttemptRecord.PaymentMethodDetail.WechatPay, PaymentRecord.PaymentMethodDetail.Affirm, and PaymentRecord.PaymentMethodDetail.WechatPay
  • Add support for hooks on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.DecrementAuthorizationParams, PaymentIntent.IncrementAuthorizationParams, PaymentIntent.ModifyParams, and PaymentIntent
  • Add support for card_present on PaymentIntentAmountDetailsLineItem.PaymentMethodOption
  • Add support for livemode on Privacy.RedactionJob
  • Add support for billing_thresholds on QuotePreviewSubscriptionSchedule.DefaultSetting, QuotePreviewSubscriptionSchedule.Phase.Item, and QuotePreviewSubscriptionSchedule.Phase
  • Add support for billing_mode_details on Subscription
  • Add support for tax_transaction_attempts on Tax.Association
  • Add support for confirm_config on Terminal.Reader.Action.ConfirmPaymentIntent and terminal.Reader.ConfirmPaymentIntentParams
  • Add support for error code forwarding_api_upstream_error on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

v12.2.0

This release changes the pinned API version to 2025-05-28.basil.

• #1517 Update generated code
  • Add support for attach_payment method on resource Invoice
  • Add support for collect_inputs method on resource terminal.Reader
  • Add support for succeed_input_collection and timeout_input_collection test helper methods on resource terminal.Reader
  • Add support for pix_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapability
  • Add support for disputes_list and payment_disputes on AccountSession.Component and AccountSession.CreateParamsComponent
  • Add support for refund_and_dispute_prefunding on Balance
  • Add support for balance_type on BalanceTransaction
  • Change billing.Alert.CreateParamsUsageThreshold.meter to be required
  • Add support for location and reader on Charge.PaymentMethodDetail.Affirm and Charge.PaymentMethodDetail.WechatPay
  • Add support for payment_method_remove on checkout.Session.CreateParamsSavedPaymentMethodOption
  • Add support for setup_future_usage on Checkout.Session.PaymentMethodOption.NaverPay
  • Change ConfirmationToken.PaymentMethodPreview.NaverPay.buyer_id and PaymentMethod.NaverPay.buyer_id to be required
  • Add support for post_payment_amount and pre_payment_amount on CreditNote
  • Add support for new value mixed on enum CreditNote.type
  • Add support for new value invoice_payment.paid on enum Event.type
  • Add support for sex, unparsed_place_of_birth, and unparsed_sex on Identity.VerificationReport.Document and Identity.VerificationSession.VerifiedOutput
  • Add support for billing_thresholds on Invoice.CreatePreviewParamsScheduleDetailPhaseItem, Invoice.CreatePreviewParamsScheduleDetailPhase, Invoice.CreatePreviewParamsSubscriptionDetailItem, Subscription.CreateParamsItem, Subscription.CreateParams, Subscription.ModifyParamsItem, Subscription.ModifyParams, SubscriptionItem.CreateParams, SubscriptionItem.ModifyParams, SubscriptionItem, SubscriptionSchedule.CreateParamsDefaultSetting, SubscriptionSchedule.CreateParamsPhaseItem, SubscriptionSchedule.CreateParamsPhase, SubscriptionSchedule.DefaultSetting, SubscriptionSchedule.ModifyParamsDefaultSetting, SubscriptionSchedule.ModifyParamsPhaseItem, SubscriptionSchedule.ModifyParamsPhase, SubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase, and Subscription
  • Add support for satispay on PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodOption, and PaymentIntent.PaymentMethodOption
  • Add support for capture_method on PaymentIntent.PaymentMethodOption.Billie
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.ModifyParams, and PaymentMethodConfiguration
  • Add support for network_decline_code on Refund.DestinationDetail.Paypal
  • Add support for metadata on Tax.CalculationLineItem and tax.Calculation.CreateParamsLineItem
  • Add support for new value simulated_stripe_s700 on enums Terminal.Reader.device_type and terminal.Reader.ListParams.device_type
  • Add support for return_url on Terminal.Reader.Action.ProcessPaymentIntent.ProcessConfig and terminal.Reader.ProcessPaymentIntentParamsProcessConfig
  • Add support for collect_inputs on Terminal.Reader.Action
  • Add support for new value collect_inputs on enum Terminal.Reader.Action.type
  • Add support for new value invoice_payment.paid on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.ModifyParams.enabled_events
  • Add support for new value 2025-05-28.basil on enum WebhookEndpoint.CreateParams.api_version
  • Add support for snapshot event invoice_payment.paid with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
• #1511 Adds CONTRIBUTING.md

See the changelog for more details.

v12.2.0b1

This release changes the pinned API version to 2025-04-30.preview.

• #1501 Update generated code for beta
  • Add support for billing_mode on Invoice.CreatePreviewParamsScheduleDetail, Invoice.CreatePreviewParamsSubscriptionDetail, InvoiceService.CreatePreviewParamsScheduleDetail, InvoiceService.CreatePreviewParamsSubscriptionDetail, Quote.SubscriptionDatum, QuotePreviewSubscriptionSchedule, SubscriptionSchedule, Subscription, checkout.Session.CreateParamsSubscriptionDatum, and checkout.SessionService.CreateParamsSubscriptionDatum
  • Add support for new value balance_settings.updated on enum Event.type
  • Add support for new value balance_settings.updated on enums WebhookEndpoint.ModifyParams.enabled_events and WebhookEndpointService.UpdateParams.enabled_events
• #1498 Update generated code for beta
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Checkout.Session.CollectedInformation.TaxId.type, Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Order.TaxDetail.TaxId.type, QuotePreviewInvoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Change Checkout.Session.AutomaticTax.provider, Invoice.AutomaticTax.provider, Quote.AutomaticTax.provider, and QuotePreviewInvoice.AutomaticTax.provider to be required
  • Add support for account_number on ConfirmationToken.PaymentMethodPreview.AcssDebit and PaymentMethod.AcssDebit
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Customer.CreateParams.type, Customer.CreateParamsTaxIdDatum.type, CustomerService.CreateParamsTaxIdDatum.type, CustomerTaxIdService.CreateParams.type, Invoice.CreatePreviewParamsCustomerDetailTaxId.type, InvoiceService.CreatePreviewParamsCustomerDetailTaxId.type, Order.CreateParamsTaxDetailTaxId.type, Order.ModifyParamsTaxDetailTaxId.type, OrderService.CreateParamsTaxDetailTaxId.type, OrderService.UpdateParamsTaxDetailTaxId.type, TaxId.CreateParams.type, TaxIdService.CreateParams.type, tax.Calculation.CreateParamsCustomerDetailTaxId.type, and tax.CalculationService.CreateParamsCustomerDetailTaxId.type
  • Change type of InvoiceLineItem.Parent.SubscriptionItemDetail.subscription from string to nullable(string)
  • Add support for billing_mode on Quote.CreateParamsSubscriptionDatum, QuoteService.CreateParamsSubscriptionDatum, Subscription.CreateParams, SubscriptionSchedule.CreateParams, SubscriptionScheduleService.CreateParams, and SubscriptionService.CreateParams
  • Add support for bf, cm, and cv on Tax.Registration.CountryOption, tax.Registration.CreateParamsCountryOption, and tax.RegistrationService.CreateParamsCountryOption
  • Add support for new value 2025-04-30.basil on enums WebhookEndpoint.CreateParams.api_version and WebhookEndpointService.CreateParams.api_version

See the changelog for more details.