• #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.

• #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...

• #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.

• #1531 Pull in OffSessionPayment changes for the May release

See the changelog for more details.

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.

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.

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.

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

• #1496 Update generated code
  • Add support for minority_owned_business_designation on Account.BusinessProfile, Account.CreateParamsBusinessProfile, Account.ModifyParamsBusinessProfile, AccountService.CreateParamsBusinessProfile, and AccountService.UpdateParamsBusinessProfile
  • Add support for registration_date on Account.Company, Account.CreateParamsCompany, Account.ModifyParamsCompany, AccountService.CreateParamsCompany, AccountService.UpdateParamsCompany, Token.CreateParamsAccountCompany, and TokenService.CreateParamsAccountCompany
  • Add support for us_cfpb_data on Account.CreateParams, Account.ModifyParams, AccountPersonService.CreateParams, AccountPersonService.UpdateParams, Person, Token.CreateParamsPerson, and TokenService.CreateParamsPerson
  • Add support for new value verification_legal_entity_structure_mismatch on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
  • Add support for new value tax_id_prohibited on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, SetupAttempt.SetupError.code, SetupIntent.LastSetupError.code, and StripeError.code
  • Add support for tax_id on Charge.BillingDetail, ConfirmationToken.CreateParamsPaymentMethodDatumBillingDetail, ConfirmationToken.PaymentMethodPreview.BillingDetail, PaymentIntent.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntent.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntent.ModifyParamsPaymentMethodDatumBillingDetail, PaymentIntentService.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntentService.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntentService.UpdateParamsPaymentMethodDatumBillingDetail, PaymentMethod.BillingDetail, PaymentMethod.CreateParamsBillingDetail, PaymentMethod.ModifyParamsBillingDetail, PaymentMethodService.CreateParamsBillingDetail, PaymentMethodService.UpdateParamsBillingDetail, SetupIntent.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntent.CreateParamsPaymentMethodDatumBillingDetail, SetupIntent.ModifyParamsPaymentMethodDatumBillingDetail, SetupIntentService.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntentService.CreateParamsPaymentMethodDatumBillingDetail, SetupIntentService.UpdateParamsPaymentMethodDatumBillingDetail, test_helpers.ConfirmationTokenService.CreateParamsPaymentMethodDatumBillingDetail, treasury.OutboundPayment.CreateParamsDestinationPaymentMethodDatumBillingDetail, and treasury.OutboundPaymentService.CreateParamsDestinationPaymentMethodDatumBillingDetail
  • Add support for wallet_options on Checkout.Session, checkout.Session.CreateParams, and checkout.SessionService.CreateParams
  • Add support for provider on Checkout.Session.AutomaticTax, Invoice.AutomaticTax, and Quote.AutomaticTax
  • 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.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Add support for payment_method_options on ConfirmationToken.CreateParams and test_helpers.ConfirmationTokenService.CreateParams
  • Add support for installments on ConfirmationToken.PaymentMethodOption.Card
  • 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, TaxId.CreateParams.type, TaxIdService.CreateParams.type, tax.Calculation.CreateParamsCustomerDetailTaxId.type, and tax.CalculationService.CreateParamsCustomerDetailTaxId.type
  • Add support for context on Event
  • Add support for new value affirm on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, InvoiceService.CreateParamsPaymentSetting.payment_method_types, InvoiceService.UpdateParamsPaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionService.CreateParamsPaymentSetting.payment_method_types, and SubscriptionService.UpdateParamsPaymentSetting.payment_method_types
  • Change type of InvoiceLineItem.Parent.SubscriptionItemDetail.subscription from string to nullable(string)
  • Add support for billie on PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentIntentService.ConfirmParamsPaymentMethodOption, PaymentIntentService.CreateParamsPaymentMethodOption, and PaymentIntentService.UpdateParamsPaymentMethodOption
  • Add support for pix on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.ModifyParams, PaymentMethodConfigurationService.CreateParams, PaymentMethodConfigurationService.UpdateParams, and PaymentMethodConfiguration
  • Add support for klarna on PaymentMethodDomain
  • Add support for pending_reason on Refund
  • Change type of Tax.CalculationLineItem.reference from nullable(string) to string
  • Add support for aw, az, bd, bf, bj, cm, cv, et, in, kg, la, and ph 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.

• #1499 Encode bools with lower case
  • Serializes boolean query parameter values to true/false (lower case) before sending to the Stripe API for compatibility with Stripe V2 endpoints
• #1401 Fix type hint for SearchResultObject.data
• #1493 Update readme with clarification on resource based call patterns

See the changelog for more details.

• #1495 Update generated code for beta
  • Add support for new resources FxQuote and PaymentIntentAmountDetailsLineItem
  • Add support for create, list, and retrieve methods on resource FxQuote
  • Remove support for attach_payment_intent method on resource Invoice
  • Add support for registration_date on Account.Company, Account.CreateParamsCompany, Account.UpdateParamsCompany, and Token.CreateParamsAccountCompany
  • Add support for customer_reference and order_reference on Charge.CaptureParamsPaymentDetail, Charge.UpdateParamsPaymentDetail, PaymentIntent.CaptureParamsPaymentDetail, PaymentIntent.ConfirmParamsPaymentDetail, PaymentIntent.CreateParamsPaymentDetail, PaymentIntent.PaymentDetail, and PaymentIntent.UpdateParamsPaymentDetail
  • Add support for tax_id on Charge.BillingDetail, ConfirmationToken.CreateParamsPaymentMethodDatumBillingDetail, ConfirmationToken.PaymentMethodPreview.BillingDetail, PaymentIntent.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntent.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntent.UpdateParamsPaymentMethodDatumBillingDetail, PaymentMethod.BillingDetail, PaymentMethod.CreateParamsBillingDetail, PaymentMethod.UpdateParamsBillingDetail, SetupIntent.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntent.CreateParamsPaymentMethodDatumBillingDetail, SetupIntent.UpdateParamsPaymentMethodDatumBillingDetail, and treasury.OutboundPayment.CreateParamsDestinationPaymentMethodDatumBillingDetail
  • Add support for price_data on checkout.Session.UpdateParamsLineItem
  • Change type of checkout.Session.UpdateParamsLineItem.quantity from longInteger to emptyable(longInteger)
  • Add support for script on Coupon.CreateParams and Coupon
  • Add support for type on Coupon
  • Add support for new value fx_quote.expired on enum Event.type
  • Add support for new value affirm on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, Invoice.UpdateParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, and Subscription.UpdateParamsPaymentSetting.payment_method_types
  • Add support for fx_quote on PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.UpdateParams, PaymentIntent, Transfer.CreateParams, and Transfer
  • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.AmountDetail
  • Add support for pix on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.UpdateParams, and PaymentMethodConfiguration
  • Add support for us_cfpb_data on Person and Token.CreateParamsPerson
  • Add support for pending_reason on Refund
  • Add support for aw, az, bd, bj, et, kg, la, and ph on TaxRegistration.CountryOption and tax.Registration.CreateParamsCountryOption
  • Add support for new value fx_quote.expired on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.UpdateParams.enabled_events
  • Add support for snapshot event fx_quote.expired with resource FxQuote

See the changelog for more details.