This release changes the pinned API version to 2025-08-27.preview.

• #2381 Update generated code for beta
  • Add support for list and retrieve methods on resource InvoicePayment
  • Add support for list method on resource Mandate
  • Add support for applied on V2.Core.Account.configuration.customer, V2.Core.Account.configuration.merchant, V2.Core.Account.configuration.recipient, V2.Core.Account.configuration.storer, V2.Core.AccountUpdateParams.configuration.customer, V2.Core.AccountUpdateParams.configuration.merchant, V2.Core.AccountUpdateParams.configuration.recipient, and V2.Core.AccountUpdateParams.configuration.storer
  • Add support for new values ao_nif, az_tin, bd_etin, cr_cpj, cr_nite, do_rcn, gt_nit, kz_bin, mz_nuit, pe_ruc, pk_ntn, sa_crn, and sa_tin on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values ao_nif, az_tin, bd_brc, bd_etin, bd_nid, cr_cpf, cr_dimex, cr_nite, do_rcn, gt_nit, kz_iin, mz_nuit, pe_dni, pk_cnic, pk_snic, and sa_tin on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type, V2.Core.Person.id_numbers[].type, V2.Core.PersonCreateParams.id_numbers[].type, and V2.Core.PersonUpdateParams.id_numbers[].type
  • Change type of Billing.AlertTriggered.value from longInteger to decimal_string
  • Add support for display_name on V2.MoneyManagement.FinancialAccountCreateParams and V2.MoneyManagement.FinancialAccount
  • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for currency_conversion on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for payments on BalanceSettingUpdateParams and BalanceSettings
  • Remove support for debit_negative_balances, payouts, and settlement_timing on BalanceSettingUpdateParams and BalanceSettings
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for coupon_data on Checkout.SessionCreateParams.discounts[]
  • Add support for mandate_options on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pix
  • Change type of Checkout.Session.payment_method_options.pix.setup_future_usage, Checkout.SessionCreateParams.payment_method_options.pix.setup_future_usage, PaymentIntent.payment_method_options.pix.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage, PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for amount on Mandate.multi_use, PaymentAttemptRecord, and PaymentRecord
  • Add support for currency on Mandate.multi_use
  • Add support for pix on Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for limit on PaymentAttemptRecordListParams
  • Add support for amount_authorized, amount_refunded, and application on PaymentAttemptRecord and PaymentRecord
  • Add support for processor_details on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecord
  • Remove support for payment_reference on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecord
  • Add support for installments on PaymentAttemptRecord.payment_method_details.alma and PaymentRecord.payment_method_details.alma
  • Add support for transaction_id on PaymentAttemptRecord.payment_method_details.alma, PaymentAttemptRecord.payment_method_details.amazon_pay, PaymentAttemptRecord.payment_method_details.billie, PaymentAttemptRecord.payment_method_details.kakao_pay, PaymentAttemptRecord.payment_method_details.kr_card, PaymentAttemptRecord.payment_method_details.naver_pay, PaymentAttemptRecord.payment_method_details.payco, PaymentAttemptRecord.payment_method_details.revolut_pay, PaymentAttemptRecord.payment_method_details.samsung_pay, PaymentAttemptRecord.payment_method_details.satispay, PaymentRecord.payment_method_details.alma, PaymentRecord.payment_method_details.amazon_pay, PaymentRecord.payment_method_details.billie, PaymentRecord.payment_method_details.kakao_pay, PaymentRecord.payment_method_details.kr_card, PaymentRecord.payment_method_details.naver_pay, PaymentRecord.payment_method_details.payco, PaymentRecord.payment_method_details.revolut_pay, PaymentRecord.payment_method_details.samsung_pay, and PaymentRecord.payment_method_details.satispay
  • Add support for location and reader on PaymentAttemptRecord.payment_method_details.paynow and PaymentRecord.payment_method_details.paynow
  • Add support for latest_active_mandate on PaymentMethod
  • Change Payout.payout_method to be required
  • Add support for metadata and period on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]
  • Add support for pix_display_qr_code on SetupIntent.next_action
  • Add support for reader_security on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configuration
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

• #2393 Use the right API version 2025-08-27.preview
• #2390 Update generated code for private-preview
  • Add support for attach_cadence method on resource Subscription
  • Add support for currency and external_customer_id on Billing.AlertTriggered
  • Add support for custom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.balances[].available_balance, Billing.CreditBalanceSummary.balances[].ledger_balance, Billing.CreditBalanceTransaction.credit.amount, Billing.CreditBalanceTransaction.debit.amount, Billing.CreditGrant.amount, and Billing.CreditGrantCreateParams.amount
  • Add support for customer on Billing.AlertListParams
  • Change type of Billing.Alert.alert_type, Billing.AlertCreateParams.alert_type, and Billing.AlertListParams.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')
  • Add support for credit_balance_threshold on Billing.AlertCreateParams and Billing.Alert
  • Add support for billable_items on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scope
  • Change type of Billing.CreditBalanceSummary.balances[].available_balance.type, Billing.CreditBalanceSummary.balances[].ledger_balance.type, Billing.CreditBalanceTransaction.credit.amount.type, Billing.CreditBalanceTransaction.debit.amount.type, Billing.CreditGrant.amount.type, and Billing.CreditGrantCreateParams.amount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')
  • Add support for license_fee_subscription_details and rate_card_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • Change type of InvoiceItem.parent.type from literal('subscription_details') to enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')
  • Add support for license_fee_details and rate_card_rate_details on InvoiceItem.pricing and InvoiceLineItem.pricing
  • Change type of InvoiceItem.pricing.type and InvoiceLineItem.pricing.type from literal('price_details') to enum('license_fee_details'|'price_details'|'rate_card_rate_details')
  • Add support for billing_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, and Subscription
  • Add support for billing_cadence_details on Invoice.parent and QuotePreviewInvoice.parent
  • Add support for new value billing_cadence_details on enums Invoice.parent.type and QuotePreviewInvoice.parent.type
  • Add support for new values license_fee_subscription_details and rate_card_subscription_details on enum InvoiceLineItem.parent.type
  • Add support for new resources V2.Billing.BillSettingVersion, V2.Billing.BillSetting, V2.Billing.Cadence, V2.Billing.CollectionSettingVersion, V2.Billing.CollectionSetting, V2.Billing.CustomPricingUnit, V2.Billing.IntentAction, V2.Billing.Intent, V2.Billing.LicenseFeeSubscription, V2.Billing.LicenseFeeVersion, V2.Billing.LicenseFee, V2.Billing.LicensedItem, V2.Billing.MeteredItem, V2.Billing.PricingPlanComponent, V2.Billing.PricingPlanSubscription, V2.Billing.PricingPlanVersion, V2.Billing.PricingPlan, V2.Billing.Profile, V2.Billing.RateCardRate, V2.Billing.RateCardSubscription, V2.Billing.RateCardVersion, V2.Billing.RateCard, V2.Billing.ServiceAction, V2.Core.ClaimableSandbox, V2.Reporting.ReportRun, V2.Reporting.Report, and V2.Tax.AutomaticRule
  • Add support for create, deactivate, find, retrieve, and update methods on resource V2.Tax.AutomaticRule
  • Add support for create and retrieve methods on resources V2.Billing.ServiceAction and V2.Reporting.ReportRun
  • Add support for retrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Reporting.Report
  • Add support for create method on resources V2.Core.ClaimableSandbox
  • Add support for cancel, create, list, retrieve, and update methods on resources V2.Billing.Cadence and V2.Billing.RateCardSubscription
  • Add support for create, list, retrieve, and update methods on resources V2.Billing.BillSetting, V2.Billing.CollectionSetting, V2.Billing.CustomPricingUnit, V2.Billing.LicenseFee, V2.Billing.LicensedItem, V2.Billing.MeteredItem, V2.Billing.PricingPlan, V2.Billing.Profile, and V2.Billing.RateCard
  • Add support for list and retrieve methods on resources V2.Billing.BillSettingVersion, V2.Billing.CollectionSettingVersion, V2.Billing.IntentAction, V2.Billing.LicenseFeeVersion, V2.Billing.PricingPlanSubscription, V2.Billing.PricingPlanVersion, and V2.Billing.RateCardVersion
  • Add support for create, del, list, and retrieve methods on resource V2.Billing.RateCardRate
  • Add support for create, del, list, retrieve, and update methods on resource V2.Billing.PricingPlanComponent
  • Add support for cancel, commit, create, list, release_reservation, reserve, and retrieve methods on resource V2.Billing.Intent
  • Add support for changes on V2.Event
  • Add support for thin events V2BillingCadenceBilledEvent, V2BillingCadenceCanceledEvent, V2BillingCadenceCreatedEvent, and V2BillingCadenceErroredEvent with related object V2.Billing.Cadence
  • Add support for thin events V2BillingLicenseFeeCreatedEvent and V2BillingLicenseFeeUpdatedEvent with related object V2.Billing.LicenseFee
  • Add support for thin event V2BillingLicenseFeeVersionCreatedEvent with related object V2.Billing.LicenseFeeVersion
  • Add support for thin events V2BillingLicensedItemCreatedEvent and V2BillingLicensedItemUpdatedEvent with related object V2.Billing.LicensedItem
  • Add support for thin events V2BillingMeteredItemCreatedEvent and V2BillingMeteredItemUpdatedEvent with related object V2.Billing.MeteredItem
  • Add support for thin events V2BillingPricingPlanCreatedEvent and V2BillingPricingPlanUpdatedEvent with related object V2.Billing.PricingPlan
  • Add support for thin events V2BillingPricingPlanComponentCreatedEvent and V2BillingPricingPlanComponentUpdatedEvent with related object V2.Billing.PricingPlanComponent
  • Add support for thin events V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingPricingPlanSubscriptionCollectionCurrentEvent, V2BillingPricingPlanSubscriptionCollectionPastDueEvent, V2BillingPricingPlanSubscriptionCollectionPausedEvent, V2BillingPricingPlanSubscriptionCollectionUnpaidEvent, V2BillingPricingPlanSubscriptionServicingActivatedEvent, V2BillingPricingPlanSubscriptionServicingCanceledEvent, and V2BillingPricingPlanSubscriptionServicingPausedEvent with related object V2.Billing.PricingPlanSubscription
  • Add support for thin event V2BillingPricingPlanVersionCreatedEvent with related object V2.Billing.PricingPlanVersion
  • Add support for thin events V2BillingRateCardCreatedEvent and V2BillingRateCardUpdatedEvent with related object V2.Billing.RateCard
  • Add support for thin event V2BillingRateCardRateCreatedEvent with related object V2.Billing.RateCardRate
  • Add support for thin events V2BillingRateCardSubscriptionActivatedEvent, V2BillingRateCardSubscriptionCanceledEvent, V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingRateCardSubscriptionCollectionCurrentEvent, V2BillingRateCardSubscriptionCollectionPastDueEvent, V2BillingRateCardSubscriptionCollectionPausedEvent, V2BillingRateCardSubscriptionCollectionUnpaidEvent, V2BillingRateCardSubscriptionServicingActivatedEvent, V2BillingRateCardSubscriptionServicingCanceledEvent, and V2BillingRateCardSubscriptionServicingPausedEvent with related object V2.Billing.RateCardSubscription
  • Add support for thin event V2BillingRateCardVersionCreatedEvent with related object V2.Billing.RateCardVersion
  • Add support for thin events V2CoreHealthApiErrorFiringEvent, V2CoreHealthApiErrorResolvedEvent, V2CoreHealthApiLatencyFiringEvent, V2CoreHealthApiLatencyResolvedEvent, V2CoreHealthAuthorizationRateDropFiringEvent, V2CoreHealthAuthorizationRateDropResolvedEvent, V2CoreHealthEventGenerationFailureResolvedEvent, V2CoreHealthFraudRateIncreasedEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, V2CoreHealthPaymentMethodErrorFiringEvent, V2CoreHealthPaymentMethodErrorResolvedEvent, V2CoreHealthTrafficVolumeDropFiringEvent, V2CoreHealthTrafficVolumeDropResolvedEvent, V2CoreHealthWebhookLatencyFiringEvent, and V2CoreHealthWebhookLatencyResolvedEvent
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object V2.Reporting.ReportRun
  • Add support for error type RateLimitError

See the changelog for more details.

• #2392 Add section on private preview SDKs in readme
• #2384 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • Add support for name on BillingPortal.ConfigurationCreateParams, BillingPortal.ConfigurationUpdateParams, and BillingPortal.Configuration
  • Add support for installments on Charge.payment_method_details.alma
  • Add support for transaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
  • Add support for location and reader on Charge.payment_method_details.paynow
  • Add support for amount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pix
  • Add support for new values block and resolution on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal_android_apk on enums File.purpose and FileListParams.purpose
  • Add support for new value terminal_android_apk on enum FileCreateParams.purpose
  • Add support for metadata and period on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for exp_month and exp_year on Issuing.CardCreateParams
  • Add support for excluded_payment_method_types on PaymentIntentCreateParams and PaymentIntent
  • Add support for payout_method on PayoutCreateParams and Payout
  • Add support for mxn on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for card on Terminal.ReaderPresentPaymentMethodParams.testHelpers
  • Add support for new value card on enum Terminal.ReaderPresentPaymentMethodParams.testHelpers.type
  • Add support for new value 2025-08-27.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2389 fix(example): expires_at is in milliseconds

See the changelog for more details.

• #2383 Bring back GA 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.

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

• #2363 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 BalanceSettingUpdateParams.payouts.schedule and BalanceSettings.payouts.schedule
  • Remove support for monthly_anchor and weekly_anchor on BalanceSettingUpdateParams.payouts.schedule and BalanceSettings.payouts.schedule
  • Add support for delay_days_override on BalanceSettingUpdateParams.settlement_timing
  • Remove support for delay_days on BalanceSettingUpdateParams.settlement_timing
  • Add support for update_discounts on Checkout.SessionCreateParams.permissions
  • Add support for discounts and subscription_data on Checkout.SessionUpdateParams
  • Add support for smart_disputes on Dispute
  • Add support for upi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for new value upi on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for transaction_id on PaymentAttemptRecord.payment_method_details.cashapp and PaymentRecord.payment_method_details.cashapp
  • Add support for amount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentUpdateParams
  • Add support for payment_details on PaymentIntentIncrementAuthorizationParams
  • Add support for storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for collection_options on V2.Core.AccountLink.use_case.account_onboarding, V2.Core.AccountLink.use_case.account_update, V2.Core.AccountLinkCreateParams.use_case.account_onboarding, and V2.Core.AccountLinkCreateParams.use_case.account_update
  • Change type of V2.Core.AccountLink.use_case.account_onboarding.configurations, V2.Core.AccountLink.use_case.account_update.configurations, V2.Core.AccountLinkCreateParams.use_case.account_onboarding.configurations, and V2.Core.AccountLinkCreateParams.use_case.account_update.configurations from literal('recipient') to enum('customer'|'merchant'|'recipient'|'storer')
  • Add support for bank_account_type on V2.MoneyManagement.PayoutMethod.bank_account
  • Add support for thin event V2CoreAccountLinkReturnedEvent
  • Add support for thin event V2MoneyManagementPayoutMethodUpdatedEvent with related object V2.MoneyManagement.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.

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

• #2379 Update generated code
  • Add support for instant_payouts_promotion on AccountSession.components and AccountSessionCreateParams.components
  • Add support for adjustable_quantity on BillingPortal.Configuration.features.subscription_update.products[], BillingPortal.ConfigurationCreateParams.features.subscription_update.products[], and BillingPortal.ConfigurationUpdateParams.features.subscription_update.products[]
  • Remove support for value disabled from enum Capability.status
  • Add support for transaction_id on Charge.payment_method_details.cashapp
  • Add support for origin_context on Checkout.SessionCreateParams and Checkout.Session
  • Add support for template on Checkout.Session.invoice_creation.invoice_data.rendering_options, Checkout.SessionCreateParams.invoice_creation.invoice_data.rendering_options, PaymentLink.invoice_creation.invoice_data.rendering_options, PaymentLinkCreateParams.invoice_creation.invoice_data.rendering_options, and PaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_options
  • Add support for setup_future_usage on Checkout.Session.payment_method_options.pix and Checkout.SessionCreateParams.payment_method_options.pix
  • Add support for new value nz_bank_account on enum Checkout.SessionCreateParams.payment_method_types
  • Change Identity.VerificationSession.related_person.account to be required
  • Change Identity.VerificationSession.related_person.person to be required
  • Add support for duration on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
  • Change type of InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Add support for price_data on PaymentLinkCreateParams.line_items[]
  • Change PaymentLinkCreateParams.line_items[].price to be optional
  • Add support for new value America/Coyhaique on enum Reporting.ReportRunCreateParams.parameters.timezone
  • Add support for standard on Tax.Registration.country_options.ae, Tax.Registration.country_options.au, Tax.Registration.country_options.ch, Tax.Registration.country_options.gb, Tax.Registration.country_options.jp, Tax.Registration.country_options.no, Tax.Registration.country_options.nz, Tax.Registration.country_options.sg, Tax.RegistrationCreateParams.country_options.ae, Tax.RegistrationCreateParams.country_options.al, Tax.RegistrationCreateParams.country_options.ao, Tax.RegistrationCreateParams.country_options.au, Tax.RegistrationCreateParams.country_options.aw, Tax.RegistrationCreateParams.country_options.ba, Tax.RegistrationCreateParams.country_options.bb, Tax.RegistrationCreateParams.country_options.bd, Tax.RegistrationCreateParams.country_options.bf, Tax.RegistrationCreateParams.country_options.bh, Tax.RegistrationCreateParams.country_options.bs, Tax.RegistrationCreateParams.country_options.cd, Tax.RegistrationCreateParams.country_options.ch, Tax.RegistrationCreateParams.country_options.et, Tax.RegistrationCreateParams.country_options.gb, Tax.RegistrationCreateParams.country_options.gn, Tax.RegistrationCreateParams.country_options.is, Tax.RegistrationCreateParams.country_options.jp, Tax.RegistrationCreateParams.country_options.me, Tax.RegistrationCreateParams.country_options.mk, Tax.RegistrationCreateParams.country_options.mr, Tax.RegistrationCreateParams.country_options.no, Tax.RegistrationCreateParams.country_options.nz, Tax.RegistrationCreateParams.country_options.om, Tax.RegistrationCreateParams.country_options.rs, Tax.RegistrationCreateParams.country_options.sg, Tax.RegistrationCreateParams.country_options.sr, Tax.RegistrationCreateParams.country_options.uy, Tax.RegistrationCreateParams.country_options.za, and Tax.RegistrationCreateParams.country_options.zw
  • Add support for new value inbound_goods on enums Tax.Registration.country_options.at.standard.place_of_supply_scheme, Tax.Registration.country_options.be.standard.place_of_supply_scheme, Tax.Registration.country_options.bg.standard.place_of_supply_scheme, Tax.Registration.country_options.cy.standard.place_of_supply_scheme, Tax.Registration.country_options.cz.standard.place_of_supply_scheme, Tax.Registration.country_options.de.standard.place_of_supply_scheme, Tax.Registration.country_options.dk.standard.place_of_supply_scheme, Tax.Registration.country_options.ee.standard.place_of_supply_scheme, Tax.Registration.country_options.es.standard.place_of_supply_scheme, Tax.Registration.country_options.fi.standard.place_of_supply_scheme, Tax.Registration.country_options.fr.standard.place_of_supply_scheme, Tax.Registration.country_options.gr.standard.place_of_supply_scheme, Tax.Registration.country_options.hr.standard.place_of_supply_scheme, Tax.Registration.country_options.hu.standard.place_of_supply_scheme, Tax.Registration.country_options.ie.standard.place_of_supply_scheme, Tax.Registration.country_options.it.standard.place_of_supply_scheme, Tax.Registration.country_options.lt.standard.place_of_supply_scheme, Tax.Registration.country_options.lu.standard.place_of_supply_scheme, Tax.Registration.country_options.lv.standard.place_of_supply_scheme, Tax.Registration.country_options.mt.standard.place_of_supply_scheme, Tax.Registration.country_options.nl.standard.place_of_supply_scheme, Tax.Registration.country_options.pl.standard.place_of_supply_scheme, Tax.Registration.country_options.pt.standard.place_of_supply_scheme, Tax.Registration.country_options.ro.standard.place_of_supply_scheme, Tax.Registration.country_options.se.standard.place_of_supply_scheme, Tax.Registration.country_options.si.standard.place_of_supply_scheme, Tax.Registration.country_options.sk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.at.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.be.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.bg.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cy.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.cz.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.de.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.dk.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ee.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.es.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fi.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.fr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.gr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hr.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.hu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ie.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.it.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lu.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.lv.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.mt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.nl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pl.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.pt.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.ro.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.se.standard.place_of_supply_scheme, Tax.RegistrationCreateParams.country_options.si.standard.place_of_supply_scheme, and Tax.RegistrationCreateParams.country_options.sk.standard.place_of_supply_scheme
  • Add support for aed, bgn, huf, and ron on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for new value 2025-07-30.basil on enum WebhookEndpointCreateParams.api_version
• #2365 Expose the API version pinned in the SDK via Stripe.API_VERSION

See the changelog for more details.

• #2367 Pull in V2 FinancialAccount changes for June release
  • Add support for close and create methods on resource V2.MoneyManagement.FinancialAccount
  • Add support for new value storer on enums V2.Core.Account.applied_configurations and V2.Core.AccountCloseParams.applied_configurations
  • Add support for storer on V2.Core.Account.configuration, V2.Core.AccountCreateParams.configuration, and V2.Core.AccountUpdateParams.configuration
  • 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.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new value storer on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configuration
  • Add support for status_details on V2.MoneyManagement.FinancialAccount
  • Add support for status on V2.MoneyManagement.FinancialAccountListParams
  • Add support for new value configuration.storer on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.Account
  • Add support for error types AlreadyExistsError and NonZeroBalanceError
• #2362 Prathmesh/merge node beta

See the changelog for more details.

• #2344 Update generated code for beta
  • Change type of Checkout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, SubscriptionCreateParams.billing_mode, and SubscriptionScheduleCreateParams.billing_mode from enum('classic'|'flexible') to billing_mode
  • Add support for submission_method on Dispute.evidence_details
  • Add support for on_demand and subscriptions on OrderCreateParams.payment.settings.payment_method_options.klarna and OrderUpdateParams.payment.settings.payment_method_options.klarna
  • Change type of Order.payment.settings.payment_method_options.klarna.setup_future_usage, OrderCreateParams.payment.settings.payment_method_options.klarna.setup_future_usage, and OrderUpdateParams.payment.settings.payment_method_options.klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for crypto on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details
  • Add support for new value buut on enums PaymentAttemptRecord.payment_method_details.ideal.bank and PaymentRecord.payment_method_details.ideal.bank
  • Add support for new value BUUTNL2A on enums PaymentAttemptRecord.payment_method_details.ideal.bic and PaymentRecord.payment_method_details.ideal.bic
  • Change type of PaymentIntent.payment_method_options.gopay.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.gopay.setup_future_usage, PaymentIntentCreateParams.payment_method_options.gopay.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.gopay.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Change Quote.subscription_data.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be required
  • Add support for new value crypto on enum QuotePreviewInvoice.payment_settings.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 SubscriptionMigrateParams.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.automatic_indirect_tax.location.country, V2.Core.Account.configuration.customer.shipping.address.country, V2.Core.Account.configuration.merchant.support.address.country, V2.Core.Account.identity.business_details.address.country, V2.Core.Account.identity.business_details.script_addresses.kana.country, V2.Core.Account.identity.business_details.script_addresses.kanji.country, V2.Core.Account.identity.country, V2.Core.Account.identity.individual.additional_addresses[].country, V2.Core.Account.identity.individual.address.country, V2.Core.Account.identity.individual.script_addresses.kana.country, V2.Core.Account.identity.individual.script_addresses.kanji.country, V2.Core.AccountCreateParams.configuration.customer.shipping.address.country, V2.Core.AccountCreateParams.configuration.merchant.support.address.country, V2.Core.AccountCreateParams.identity.business_details.address.country, V2.Core.AccountCreateParams.identity.business_details.script_addresses.kana.country, V2.Core.AccountCreateParams.identity.business_details.script_addresses.kanji.country, V2.Core.AccountCreateParams.identity.country, V2.Core.AccountCreateParams.identity.individual.additional_addresses[].country, V2.Core.AccountCreateParams.identity.individual.address.country, V2.Core.AccountCreateParams.identity.individual.script_addresses.kana.country, V2.Core.AccountCreateParams.identity.individual.script_addresses.kanji.country, V2.Core.AccountUpdateParams.configuration.customer.shipping.address.country, V2.Core.AccountUpdateParams.configuration.merchant.support.address.country, V2.Core.AccountUpdateParams.identity.business_details.address.country, V2.Core.AccountUpdateParams.identity.business_details.script_addresses.kana.country, V2.Core.AccountUpdateParams.identity.business_details.script_addresses.kanji.country, V2.Core.AccountUpdateParams.identity.country, V2.Core.AccountUpdateParams.identity.individual.additional_addresses[].country, V2.Core.AccountUpdateParams.identity.individual.address.country, V2.Core.AccountUpdateParams.identity.individual.script_addresses.kana.country, V2.Core.AccountUpdateParams.identity.individual.script_addresses.kanji.country, V2.Core.Person.additional_addresses[].country, V2.Core.Person.address.country, V2.Core.Person.script_addresses.kana.country, V2.Core.Person.script_addresses.kanji.country, V2.Core.PersonCreateParams.additional_addresses[].country, V2.Core.PersonCreateParams.address.country, V2.Core.PersonCreateParams.script_addresses.kana.country, V2.Core.PersonCreateParams.script_addresses.kanji.country, V2.Core.PersonUpdateParams.additional_addresses[].country, V2.Core.PersonUpdateParams.address.country, V2.Core.PersonUpdateParams.script_addresses.kana.country, V2.Core.PersonUpdateParams.script_addresses.kanji.country, and V2.MoneyManagement.FinancialAccount.country
  • Add support for new value unsupported_entity_type on enums V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.alma_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.blik_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.boleto_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.card_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.eps_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.fpx_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.ideal_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.jcb_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.klarna_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.konbini_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.link_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.p24_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.payco_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.paynow_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.swish_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.twint_payments.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status_details[].code, `V2.Core.Ac...

• #2348 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.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for proof_of_address on AccountCreateParams.documents and AccountUpdateParams.documents
  • Add support for monthly_payout_days and weekly_payout_days on Account.settings.payouts.schedule, AccountCreateParams.settings.payouts.schedule, and AccountUpdateParams.settings.payouts.schedule
  • Change Account.settings.invoices.hosted_payment_method_save to be required
  • Add support for crypto on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Change type of Charge.payment_method_details.card.installments.plan.type, ConfirmationToken.payment_method_options.card.installments.plan.type, ConfirmationTokenCreateParams.testHelpers.payment_method_options.card.installments.plan.type, InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.type, InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.type, PaymentIntent.payment_method_options.card.installments.available_plans[].type, PaymentIntent.payment_method_options.card.installments.plan.type, PaymentIntentConfirmParams.payment_method_options.card.installments.plan.type, PaymentIntentCreateParams.payment_method_options.card.installments.plan.type, and PaymentIntentUpdateParams.payment_method_options.card.installments.plan.type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')
  • Add support for new value buut on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value BUUTNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentMethod.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for subscriptions on Checkout.SessionCreateParams.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for new value crypto on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for billing_mode on Checkout.SessionCreateParams.subscription_data, InvoiceCreatePreviewParams.schedule_details, InvoiceCreatePreviewParams.subscription_details, Quote.subscription_data, QuoteCreateParams.subscription_data, SubscriptionCreateParams, SubscriptionScheduleCreateParams, SubscriptionSchedule, and Subscription
  • Add support for new value crypto on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value crypto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.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.payment_method_details.card.case_type
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSessionCreateParams and Identity.VerificationSession
  • Add support for matching on Identity.VerificationSession.options
  • Add support for new value crypto on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for klarna on Mandate.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for on_demand on PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Change type of PaymentIntent.payment_method_options.klarna.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.klarna.setup_future_usage, PaymentIntentCreateParams.payment_method_options.klarna.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for ua on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Change type of Terminal.LocationUpdateParams.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.FinancialAccountListParams
  • Add support for new value terminal.reader.action_updated on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-06-30.basil on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot event TerminalReaderActionUpdatedEvent with resource Terminal.Reader
• #2356 Add mise config for node version
• #2354 Add stripeContext to theRequestOptions and StripeConfig interfaces.

See the changelog for more details.

• #2358 Pull in OffSessionPayment changes for the May release

See the changelog for more details.