v32.2.0-beta.2

• #2210 Update generated code for beta
  • Add support for new resources v2.commerce.ProductCatalogImport, v2.data.reporting.QueryRun, v2.extend.WorkflowRun, v2.extend.Workflow, v2.iam.ActivityLog, v2.network.BusinessProfile, and v2.orchestratedcommerce.Agreement
  • Add support for confirm, create, list, retrieve, and terminate methods on resource v2.orchestratedcommerce.Agreement
  • Add support for me and retrieve methods on resource v2.network.BusinessProfile
  • Add support for list method on resource v2.iam.ActivityLog
  • Add support for list and retrieve methods on resource v2.extend.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource v2.extend.Workflow
  • Add support for create and retrieve methods on resources v2.commerce.ProductCatalogImport and v2.data.reporting.QueryRun
  • ⚠️ Change type of v2.billing.Cadence.settings_data.collection.payment_method_options.konbini, v2.billing.CollectionSetting.payment_method_options.konbini, v2.billing.CollectionSettingCreateParams.payment_method_options.konbini, v2.billing.CollectionSettingUpdateParams.payment_method_options.konbini, and v2.billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of v2.billing.Cadence.settings_data.collection.payment_method_options.sepaDebit, v2.billing.CollectionSetting.payment_method_options.sepaDebit, v2.billing.CollectionSettingCreateParams.payment_method_options.sepaDebit, v2.billing.CollectionSettingUpdateParams.payment_method_options.sepaDebit, and v2.billing.CollectionSettingVersion.payment_method_options.sepaDebit from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitProcessing from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitQueued from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitSucceeded from map(string: dynamic) to an object
  • Add support for new values futsu and toza on enums v2.core.vault.GbBankAccountCreateParams.bankAccountType, v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bankAccountType, and v2.moneymanagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bankAccountType
  • Change type of v2.core.BatchJobCreateParams.endpoint.httpMethod from literal('post') to enum('delete'|'post')
  • Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for treasuryTransaction on EventsV2MoneyManagementTransactionCreatedEvent
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object v2.commerce.ProductCatalogImport
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object v2.data.reporting.QueryRun
  • Add support for event notifications V2ExtendWorkflowRunFailedEvent, V2ExtendWorkflowRunStartedEvent, and V2ExtendWorkflowRunSucceededEvent with related object v2.extend.WorkflowRun
  • Add support for event notifications V2OrchestratedCommerceAgreementConfirmedEvent, V2OrchestratedCommerceAgreementCreatedEvent, V2OrchestratedCommerceAgreementPartiallyConfirmedEvent, and V2OrchestratedCommerceAgreementTerminatedEvent with related object v2.orchestratedcommerce.Agreement
  • Add support for error type CannotProceedException

See the changelog for more details.

v32.2.0-beta.1

This release changes the pinned API version to 2026-04-22.private.

• #2198 Update generated code for beta
  • Add support for new resources sharedpayment.GrantedToken and sharedpayment.IssuedToken
  • Add support for retrieve method on resource sharedpayment.GrantedToken
  • Add support for create and revoke test helper methods on resource sharedpayment.GrantedToken
  • Add support for create, retrieve, and revoke methods on resource sharedpayment.IssuedToken
  • Add support for blik 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, SubscriptionUpdateParams.payment_settings.payment_method_options, and checkout.SessionCreateParams.payment_method_options
  • Add support for sharedPaymentGrantedToken on ConfirmationTokenCreateParams.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
  • Add support for validationErrors on privacy.RedactionJob
  • Add support for taxDetails on Product
  • ⚠️ Change type of QuotePreviewInvoice.total_taxes[].tax_rate_details.taxRate from string to expandable($TaxRate)
  • Add support for admissionsTax, attendanceTax, entertainmentTax, grossReceiptsTax, hospitalityTax, luxuryTax, resortTax, and tourismTax on tax.RegistrationCreateParams.country_options.us
  • Add support for purpose on treasury.OutboundPaymentCreateParams and treasury.OutboundPayment

See the changelog for more details.

v32.2.0-alpha.1

This release changes the pinned API version to 2026-04-22.private.

• #2206 Update generated code for private-preview
  • Add support for new resources v2.commerce.ProductCatalogImport, v2.core.ApprovalRequest, v2.extend.WorkflowRun, v2.extend.Workflow, v2.iam.ActivityLog, v2.network.BusinessProfile, and v2.orchestratedcommerce.Agreement
  • ⚠️ Remove support for resources v2.core.WorkflowRun and v2.core.Workflow
  • Add support for confirm, create, list, retrieve, and terminate methods on resource v2.orchestratedcommerce.Agreement
  • Add support for me and retrieve methods on resource v2.network.BusinessProfile
  • Add support for list method on resource v2.iam.ActivityLog
  • Add support for list and retrieve methods on resource v2.extend.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource v2.extend.Workflow
  • Add support for cancel, execute, list, retrieve, and submit methods on resource v2.core.ApprovalRequest
  • Add support for create and retrieve methods on resource v2.commerce.ProductCatalogImport
  • ⚠️ Remove support for list and retrieve methods on resource v2.core.WorkflowRun
  • ⚠️ Remove support for invoke, list, and retrieve methods on resource v2.core.Workflow
  • Add support for renew_onboarding_link method on resource v2.core.ClaimableSandbox
  • ⚠️ Remove support for customer on sharedpayment.IssuedToken
  • Add support for billManagement and sendMoney on AccountSession.components.bills.features
  • Add support for giftCard on Charge.payment_method_details, PaymentAttemptRecord.payment_method_details, and PaymentRecord.payment_method_details
  • Add support for customPaymentMethodTypes on checkout.SessionCreateParams and checkout.Session
  • Add support for paymentRecord on checkout.Session
  • ⚠️ Remove support for sharedPaymentGrantedToken on ConfirmationTokenCreateParams.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentIntent, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for paymentMethod on ConfirmationToken.payment_method_preview.sepa_debit.generated_from, PaymentMethod.sepa_debit.generated_from, and sharedpayment.GrantedToken.payment_method_details.sepa_debit.generated_from
  • ⚠️ Change type of delegatedcheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option.type and delegatedcheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option_overrides[].type from string to enum('digital'|'shipping')
  • Add support for returnUrl on delegatedcheckout.RequestedSessionConfirmParams
  • Add support for buyerConsents on delegatedcheckout.RequestedSession
  • Add support for cryptoTransactions on issuing.Authorization, issuing.Dispute, and issuing.Transaction
  • Add support for paymentFacilitatorId and subMerchantId on issuing.Authorization.merchant_data and issuing.Transaction.merchant_data
  • Add support for identifiers on OrderCreateParams.line_items[].product_data, OrderUpdateParams.line_items[].product_data, ProductCreateParams, ProductUpdateParams, and Product
  • Add support for agentDetails on PaymentIntent
  • Add support for externalReference on PriceCreateParams and PriceUpdateParams
  • Add support for loginSucceeded and registrationSucceeded on radar.AccountEvaluation.events[] and radar.AccountEvaluationUpdateParams
  • Add support for printContent on terminal.Reader.action
  • Add support for appChannel on v2.core.ClaimableSandboxCreateParams and v2.core.ClaimableSandbox
  • Add support for onboardingLinkDetails and ownerDetails on v2.core.ClaimableSandbox
  • ⚠️ Remove support for claimUrl on v2.core.ClaimableSandbox
  • ⚠️ Remove support for ownerAccount on v2.core.ClaimableSandbox.sandbox_details
  • Add support for snapshotEvent on v2.core.Event
  • Add support for multiprocessorSettlement on v2.moneymanagement.FinancialAccount
  • Add support for caBankAccount on v2.moneymanagement.FinancialAddress.credentials and v2.moneymanagement.ReceivedCredit.bank_transfer
  • Add support for amountDetails and paymentDetails on v2.payments.OffSessionPaymentCaptureParams, v2.payments.OffSessionPaymentCreateParams, and v2.payments.OffSessionPayment
  • Add support for description on v2.payments.OffSessionPaymentCreateParams and v2.payments.OffSessionPayment
  • Add support for new value acss on enum v2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for mcc on v2.payments.OffSessionPaymentCreateParams.payment_method_options.card
  • Change v2.payments.OffSessionPaymentCreateParams.payment_method_options.card.networkTransactionId to be optional
  • Add support for new values futsu and toza on enums v2.core.vault.GbBankAccountCreateParams.bankAccountType, v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account.bankAccountType, and v2.moneymanagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account.bankAccountType
  • Add support for new value tempo on enum v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.crypto_wallet.network
  • Add support for new value credentials.ca_bank_account.account_number on enums v2.moneymanagement.FinancialAddressListParams.include and v2.moneymanagement.FinancialAddressRetrieveParams.include
  • Add support for new value ca_bank_account on enum v2.moneymanagement.FinancialAddressCreateParams.type
  • Add support for new value multiprocessor_settlement on enum v2.moneymanagement.FinancialAccountListParams.types
  • Add support for storage on v2.moneymanagement.FinancialAccountUpdateParams
  • Add support for fxQuote on v2.moneymanagement.CurrencyConversionCreateParams
  • Change v2.moneymanagement.CurrencyConversionCreateParams.financialAccount to be optional
  • ⚠️ Add support for onboardingLinkDetails on v2.core.ClaimableSandboxCreateParams
  • Change type of v2.core.BatchJobCreateParams.endpoint.httpMethod from literal('post') to enum('delete'|'post')
  • Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums v2.core.AccountCreateParams.identity.business_details.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums v2.core.AccountCreateParams.identity.individual.id_numbers[].type, v2.core.AccountPersonCreateParams.id_numbers[].type, v2.core.AccountPersonTokenCreateParams.id_numbers[].type, v2.core.AccountPersonUpdateParams.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and v2.core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for treasuryTransaction on EventsV2MoneyManagementTransactionCreatedEvent
  • Add support for event notifications V1AccountApplicationAuthorizedEvent, V1AccountApplicationDeauthorizedEvent, V1AccountExternalAccountCreatedEvent, V1AccountExternalAccountDeletedEvent, V1AccountExternalAccountUpdatedEvent, V1BillingPortalSessionCreatedEvent, V1EntitlementsActiveEntitlementSummaryUpdatedEvent, V2CoreHealthMeterEventSummariesDelayedFiringEvent, and V2CoreHealthMeterEventSummariesDelayedResolvedEvent
  • Add support for event notification V1AccountUpdatedEvent with related object Account
  • Add support for event notifications V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee
  • Add support for event notification V1ApplicationFeeRefundUpdatedEvent with related object FeeRefund
  • Add support for event notification V1BalanceAvailableEvent with related object Balance
  • Add support for event notification V1BillingAlertTriggeredEvent with related object billing.Alert
  • Add support for event notifications V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object billingportal.Configuration
  • Add support for event notification V1CapabilityUpdatedEvent with related object Capability
  • Add support for event notification V1CashBalanceFundsAvailableEvent with related object CashBalance
  • Add support for event notifications V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge
  • Add support for event notifications V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute
  • Add support for event notifications V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund
  • Add...

v32.1.0

This release changes the pinned API version to 2026-04-22.dahlia.

• #2203 Update generated code
  • Add support for balanceReport and payoutReconciliationReport on AccountSession.components and AccountSessionCreateParams.components
  • Add support for appDistribution and sunbitPayments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for sunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for location and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarna
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for managedPayments on PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, Subscription, checkout.SessionCreateParams, and checkout.Session
  • Add support for new value sunbit on enums PaymentIntentConfirmParams.excludedPaymentMethodTypes, PaymentIntentCreateParams.excludedPaymentMethodTypes, PaymentIntentUpdateParams.excludedPaymentMethodTypes, SetupIntentCreateParams.excludedPaymentMethodTypes, SetupIntentUpdateParams.excludedPaymentMethodTypes, and checkout.SessionCreateParams.excludedPaymentMethodTypes
  • Add support for mandateOptions on PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, PaymentIntentUpdateParams.payment_method_options.pix, checkout.Session.payment_method_options.pix, and checkout.SessionCreateParams.payment_method_options.pix
  • Change type of PaymentIntentConfirmParams.payment_method_options.pix.setupFutureUsage, PaymentIntentCreateParams.payment_method_options.pix.setupFutureUsage, PaymentIntentUpdateParams.payment_method_options.pix.setupFutureUsage, and checkout.SessionCreateParams.payment_method_options.pix.setupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enum checkout.SessionCreateParams.paymentMethodTypes
  • ⚠️ Change type of PaymentIntent.payment_method_options.pix.setupFutureUsage and checkout.Session.payment_method_options.pix.setupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enums ConfirmationTokenCreateParams.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 values fo_vat, gi_tin, it_cf, and py_ruc on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for new value sunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for pix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.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 upi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.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 values pix and upi on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for cardPresence on issuing.Authorization
  • Add support for allowedCardPresences and blockedCardPresences on issuing.Card.spending_controls, issuing.CardCreateParams.spending_controls, issuing.CardUpdateParams.spending_controls, issuing.Cardholder.spending_controls, issuing.CardholderCreateParams.spending_controls, and issuing.CardholderUpdateParams.spending_controls
  • Add support for amount and currency on Mandate.multi_use
  • Add support for amountToConfirm on PaymentIntentConfirmParams
  • Add support for klarnaDisplayQrCode on PaymentIntent.next_action
  • Add support for new value sunbit on enums PaymentLinkCreateParams.paymentMethodTypes and PaymentLinkUpdateParams.paymentMethodTypes
  • Add support for new value account on enum radar.ValueListCreateParams.itemType
  • Add support for moto on SetupAttempt.payment_method_details.card
  • Add support for pixDisplayQrCode on SetupIntent.next_action
  • Add support for new value 2026-04-22.dahlia on enum WebhookEndpointCreateParams.apiVersion
• #2208 Fix missing stripeContext in RequestOptions.toBuilderFullCopy()
  • Fixes a bug where an existing stripeContext was being reset to null when calling RequestOptions#toBuilderFullCopy()

See the changelog for more details.

v32.1.0-alpha.4

• #2204 Update generated code for private-preview
  • Add support for latestVersion on v2.billing.LicenseFee, v2.billing.PricingPlan, and v2.billing.RateCard
  • Add support for serviceIntervalCount and serviceInterval on v2.billing.LicenseFee and v2.billing.RateCard
• #2202 Update generated code for private-preview
  • Add support for new resources v2.core.WorkflowRun and v2.core.Workflow
  • Add support for report_authorized method on resource PaymentAttemptRecord
  • Add support for list and retrieve methods on resource v2.core.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource v2.core.Workflow
  • Add support for nextAction and status on sharedpayment.IssuedToken
  • ⚠️ Remove support for networkId on sharedpayment.IssuedToken.seller_details
  • Add support for bills on AccountSession.components
  • Add support for settlementCurrencies on BalanceSettings.payments and BalanceSettingsUpdateParams.payments
  • Add support for defaultSettlementCurrency on BalanceSettings.payments
  • Add support for accountFunding on Charge.payment_method_details.card
  • Add support for automaticSurcharge on PaymentLinkCreateParams, PaymentLink, checkout.SessionCreateParams, and checkout.Session
  • Add support for bizum on checkout.Session.payment_method_options and checkout.SessionCreateParams.payment_method_options
  • Add support for surchargeCost on checkout.Session
  • Add support for amountSurcharge on checkout.Session.total_details
  • Add support for sharedPaymentGrantedToken on ConfirmationTokenCreateParams.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new value email on enums identity.VerificationReportListParams.type, identity.VerificationSessionCreateParams.type, and identity.VerificationSessionUpdateParams.type
  • Add support for details on identity.VerificationReport.email
  • Add support for confirm on identity.VerificationSessionCreateParams and identity.VerificationSessionUpdateParams
  • Add support for subscription on InvoiceItem.parent.schedule_details
  • ⚠️ Remove support for sharedPaymentGrantedToken on PaymentIntentConfirmParams and PaymentIntentCreateParams
  • Add support for moneyServices on PaymentIntent.payment_details
  • ⚠️ Remove support for externalReference on Plan

See the changelog for more details.

v32.1.0-alpha.3

• #2199 Update generated code for private-preview
  • Add support for paymentRecord on ApplicationFee.fee_source
  • Add support for fleetData on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentAmountDetailsLineItem.payment_method_options.card, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.card, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCreateParams.payment_details, PaymentIntentDecrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.card, and PaymentIntentUpdateParams.payment_details
  • Add support for beneficiaryAccount, beneficiaryDetails, senderAccount, and senderDetails on ChargeCaptureParams.payment_details.money_services.account_funding, ChargeUpdateParams.payment_details.money_services.account_funding, PaymentIntentCaptureParams.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • Change type of ChargeCaptureParams.payment_details.money_services.transactionType, ChargeUpdateParams.payment_details.money_services.transactionType, PaymentIntentCaptureParams.payment_details.money_services.transactionType, PaymentIntentConfirmParams.payment_details.money_services.transactionType, PaymentIntentCreateParams.payment_details.money_services.transactionType, and PaymentIntentUpdateParams.payment_details.money_services.transactionType from literal('account_funding') to emptyable(literal('account_funding'))
  • Add support for bizum 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 bizum on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for quantityPrecision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParams.amount_details.line_items[], PaymentIntentConfirmParams.amount_details.line_items[], PaymentIntentCreateParams.amount_details.line_items[], PaymentIntentDecrementAuthorizationParams.amount_details.line_items[], PaymentIntentIncrementAuthorizationParams.amount_details.line_items[], and PaymentIntentUpdateParams.amount_details.line_items[]
  • Add support for liquidAsset and wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for sharedPaymentGrantedToken on PaymentMethod
  • Add support for data on radar.PaymentEvaluation.client_device_metadata_details and radar.PaymentEvaluationCreateParams.client_device_metadata_details
  • Add support for sunbit on sharedpayment.GrantedToken.payment_method_details
  • ⚠️ Remove support for values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin from enums v2.core.AccountCreateParams.identity.business_details.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • ⚠️ Remove support for values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp from enums v2.core.AccountCreateParams.identity.individual.id_numbers[].type, v2.core.AccountPersonCreateParams.id_numbers[].type, v2.core.AccountPersonTokenCreateParams.id_numbers[].type, v2.core.AccountPersonUpdateParams.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and v2.core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Add support for error type CannotProceedException

See the changelog for more details.

v32.1.0-alpha.2

• #2197 Update generated code for private-preview
  • Add support for new resources sharedpayment.IssuedToken and v2.data.reporting.QueryRun
  • Add support for create and retrieve methods on resource v2.data.reporting.QueryRun
  • Add support for pause and resume methods on resource v2.payments.OffSessionPayment
  • Add support for tenantKeys, tenantOperator, and tenantValues on billing.MeterEventSummaryListParams
  • Add support for moneyServices on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for paymentMethodOptions on delegatedcheckout.RequestedSessionCreateParams, delegatedcheckout.RequestedSessionUpdateParams, and delegatedcheckout.RequestedSession
  • ⚠️ Remove support for paymentMethodData on delegatedcheckout.RequestedSessionConfirmParams, delegatedcheckout.RequestedSessionCreateParams, and delegatedcheckout.RequestedSessionUpdateParams
  • Add support for cardBrands and paymentMethodTypes on delegatedcheckout.RequestedSession.seller_details
  • ⚠️ Change type of delegatedcheckout.RequestedSession.sharedPaymentIssuedToken from string to expandable($SharedPayment.IssuedToken)
  • Add support for checkScan 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 check_scan on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for processorDetails on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.failed, PaymentRecordReportPaymentAttemptParams.guaranteed, PaymentRecordReportPaymentParams.failed, and PaymentRecordReportPaymentParams.guaranteed
  • Add support for paymentDetails on PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card
  • ⚠️ Remove support for billFrom on QuotePreviewSubscriptionSchedule.billing_schedules[], Subscription.billing_schedules[], and SubscriptionSchedule.billing_schedules[]
  • Add support for agentDetails, paymentMethodDetails, and riskDetails on sharedpayment.GrantedToken
  • Add support for paperChecks on v2.Account.configuration.recipient_data.features, v2.AccountCreateParams.configuration.recipient_data.features, v2.AccountUpdateParams.configuration.recipient_data.features, v2.core.Account.configuration.recipient.capabilities, v2.core.Account.configuration.storer.capabilities.outbound_payments, v2.core.AccountCreateParams.configuration.recipient.capabilities, v2.core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, v2.core.AccountUpdateParams.configuration.recipient.capabilities, and v2.core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments
  • ⚠️ Change type of v2.billing.Cadence.settings_data.collection.payment_method_options.konbini, v2.billing.CollectionSetting.payment_method_options.konbini, v2.billing.CollectionSettingCreateParams.payment_method_options.konbini, v2.billing.CollectionSettingUpdateParams.payment_method_options.konbini, and v2.billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of v2.billing.Cadence.settings_data.collection.payment_method_options.sepaDebit, v2.billing.CollectionSetting.payment_method_options.sepaDebit, v2.billing.CollectionSettingCreateParams.payment_method_options.sepaDebit, v2.billing.CollectionSettingUpdateParams.payment_method_options.sepaDebit, and v2.billing.CollectionSettingVersion.payment_method_options.sepaDebit from map(string: dynamic) to an object
  • Add support for id on v2.billing.CadenceSpendModifier.max_billing_period_spend.amount.custom_pricing_unit, v2.billing.IntentAction.apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit, and v2.billing.IntentCreateParams.actions[].apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit
  • ⚠️ Change type of v2.core.Event.reason.request.client.stripeAction from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitProcessing from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitQueued from map(string: dynamic) to an object
  • ⚠️ Change type of v2.moneymanagement.InboundTransfer.transfer_history[].bankDebitSucceeded from map(string: dynamic) to an object
  • ⚠️ Remove support for town on v2.moneymanagement.OutboundPayment.tracking_details.paper_check.mailing_address
  • Add support for applicationFeeAmountRequested on v2.payments.OffSessionPayment
  • ⚠️ Remove support for compartmentId on v2.payments.OffSessionPayment
  • Add support for retryUntil on v2.payments.OffSessionPayment.retry_details
  • Add support for applicationFeeAmount on v2.payments.OffSessionPaymentCaptureParams and v2.payments.OffSessionPaymentCreateParams
  • Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums v2.core.AccountCreateParams.identity.business_details.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums v2.core.AccountCreateParams.identity.individual.id_numbers[].type, v2.core.AccountPersonCreateParams.id_numbers[].type, v2.core.AccountPersonTokenCreateParams.id_numbers[].type, v2.core.AccountPersonUpdateParams.id_numbers[].type, v2.core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and v2.core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Add support for new value paper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updatedCapability
  • Add support for new value outbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updatedCapability
  • Add support for alertId on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for apiKey on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEvent
  • Add support for stripeAccessGrant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEvent
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object v2.data.reporting.QueryRun
  • Add support for event notifications V2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object v2.payments.OffSessionPayment

See the changelog for more details.

v32.1.0-beta.1

This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 32.0.0 which contains breaking changes. Please review the changelog for 32.0.0 if upgrading from older SDK versions.

• #2194 Update generated code for beta
• #2192 Update generated code for beta
  • Release specs are identical.
• #2164 Update generated code for beta
  • Add support for new resources productcatalog.TrialOffer, tax.Location, and v2.core.BatchJob
  • Add support for create method on resource productcatalog.TrialOffer
  • Add support for create, list, and retrieve methods on resource tax.Location
  • Add support for cancel, create, and retrieve methods on resource v2.core.BatchJob
  • Add support for performanceLocation on tax.CalculationCreateParams.line_items[] and tax.CalculationLineItem
  • Add support for trialOffer on InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set, InvoiceCreatePreviewParams.schedule_details.phases[].items[], QuoteCreateParams.lines[].actions[].add_item, QuoteCreateParams.lines[].actions[].set_items[], QuoteLine.actions[].add_item, QuoteLine.actions[].set_items[], QuotePreviewSubscriptionSchedule.phases[].items[], QuoteUpdateParams.lines[].actions[].add_item, QuoteUpdateParams.lines[].actions[].set_items[], SubscriptionSchedule.phases[].items[], SubscriptionScheduleAmendParams.amendments[].item_actions[].add, SubscriptionScheduleAmendParams.amendments[].item_actions[].set, SubscriptionScheduleCreateParams.phases[].items[], and SubscriptionScheduleUpdateParams.phases[].items[]
  • Add support for riskReserved on Balance
  • ⚠️ Remove support for sourceType on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for taxDetails on InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, PlanCreateParams.product[0], PriceCreateParams.product_data, ProductCreateParams, ProductUpdateParams, checkout.SessionCreateParams.line_items[].price_data.product_data, and checkout.SessionUpdateParams.line_items[].price_data.product_data
  • Add support for pendingInvoiceItemInterval on checkout.SessionUpdateParams.subscription_data
  • Add support for hosted and uiMode on financialconnections.SessionCreateParams and financialconnections.Session
  • Add support for url on financialconnections.Session
  • Add support for expiresAfterSeconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
  • Add support for currentTrial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]
  • Add support for surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • Add support for amountDetails and paymentDetails on PaymentIntentDecrementAuthorizationParams
  • Add support for mandateOptions on PaymentIntent.payment_method_options.stripe_balance
  • Add support for managedPayments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripeBalance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for billingCycleAnchor on Subscription.trial_settings.end_behavior, SubscriptionCreateParams.trial_settings.end_behavior, and SubscriptionUpdateParams.trial_settings.end_behavior
  • Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enum tax.RegistrationCreateParams.country_options.us.type
  • Add support for admissionsTax, attendanceTax, entertainmentTax, grossReceiptsTax, hospitalityTax, luxuryTax, resortTax, and tourismTax on tax.Registration.country_options.us
  • Add support for requirements on TaxCode
  • ⚠️ Change type of v2.billing.Cadence.settings_data.collection.payment_method_options.card.mandate_options.amount, v2.billing.CollectionSetting.payment_method_options.card.mandate_options.amount, v2.billing.CollectionSettingCreateParams.payment_method_options.card.mandate_options.amount, v2.billing.CollectionSettingUpdateParams.payment_method_options.card.mandate_options.amount, and v2.billing.CollectionSettingVersion.payment_method_options.card.mandate_options.amount from longInteger to int64_string
  • Add support for timezone on v2.core.Account.defaults, v2.core.AccountCreateParams.defaults, and v2.core.AccountUpdateParams.defaults
  • Add support for azureEventGrid on v2.core.EventDestinationCreateParams and v2.core.EventDestination
  • Add support for supportedCurrencies on v2.core.vault.GbBankAccount, v2.core.vault.UsBankAccount, and v2.moneymanagement.PayoutMethod.card
  • Add support for restricted on v2.moneymanagement.PayoutMethod
  • Add support for currencies on v2.moneymanagement.PayoutMethodsBankAccountSpec.countries.value.fields[]
  • Add support for counterparty and description on v2.moneymanagement.Transaction
  • ⚠️ Add support for currency on v2.core.vault.GbBankAccountCreateParams, v2.core.vault.UsBankAccountCreateParams, v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account, v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.card, v2.moneymanagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account, and v2.moneymanagement.OutboundSetupIntentUpdateParams.payout_method_data.card
  • Add support for iban on v2.core.vault.GbBankAccountCreateParams
  • Change v2.core.vault.GbBankAccountCreateParams.accountNumber to be optional
  • Change v2.core.vault.GbBankAccountCreateParams.sortCode to be optional
  • Add support for new value azure_event_grid on enum v2.core.EventDestinationCreateParams.type
  • Add support for new value currency on enum InvalidPaymentMethodException.invalidParam
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object v2.core.BatchJob
• #2189 Merge to beta
• #2175 Merge to beta

See the changelog for more details.

v32.1.0-alpha.1

This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.

• #2196 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for financialAccountRewards and nestingDemo on AccountSession.components
  • Add support for upiPayments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for riskSignals on Account
  • Add support for fraudIntent on AccountSignals
  • Add support for riskReserved on Balance
  • ⚠️ Remove support for billableItems on billing.Alert.spend_threshold.filters
  • Add support for upi on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, 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, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, SetupIntentUpdateParams.payment_method_options, checkout.Session.payment_method_options, and checkout.SessionCreateParams.payment_method_options
  • ⚠️ Remove support for sourceType on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.payment_method_data.stripe_balance, PaymentAttemptRecord.payment_method_details.stripe_balance, PaymentIntentConfirmParams.payment_method_data.stripe_balance, PaymentIntentCreateParams.payment_method_data.stripe_balance, PaymentIntentUpdateParams.payment_method_data.stripe_balance, PaymentMethod.stripe_balance, PaymentMethodCreateParams.stripe_balance, PaymentRecord.payment_method_details.stripe_balance, SetupIntentConfirmParams.payment_method_data.stripe_balance, SetupIntentCreateParams.payment_method_data.stripe_balance, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for integrationIdentifier on checkout.SessionCreateParams and checkout.Session
  • Add support for new value application on enums InvoiceCreateParams.automatic_tax.liability.type, InvoiceCreateParams.issuer.type, InvoiceCreatePreviewParams.automatic_tax.liability.type, InvoiceCreatePreviewParams.issuer.type, InvoiceCreatePreviewParams.schedule_details.phases[].automatic_tax.liability.type, InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings.issuer.type, InvoiceUpdateParams.automatic_tax.liability.type, InvoiceUpdateParams.issuer.type, PaymentLinkCreateParams.automatic_tax.liability.type, PaymentLinkCreateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkCreateParams.subscription_data.invoice_settings.issuer.type, PaymentLinkUpdateParams.automatic_tax.liability.type, PaymentLinkUpdateParams.invoice_creation.invoice_data.issuer.type, PaymentLinkUpdateParams.subscription_data.invoice_settings.issuer.type, QuoteCreateParams.automatic_tax.liability.type, QuoteCreateParams.invoice_settings.issuer.type, QuoteUpdateParams.automatic_tax.liability.type, QuoteUpdateParams.invoice_settings.issuer.type, SubscriptionCreateParams.automatic_tax.liability.type, SubscriptionCreateParams.invoice_settings.issuer.type, SubscriptionScheduleCreateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleCreateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleCreateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleCreateParams.phases[].invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.default_settings.automatic_tax.liability.type, SubscriptionScheduleUpdateParams.default_settings.invoice_settings.issuer.type, SubscriptionScheduleUpdateParams.phases[].automatic_tax.liability.type, SubscriptionScheduleUpdateParams.phases[].invoice_settings.issuer.type, SubscriptionUpdateParams.automatic_tax.liability.type, SubscriptionUpdateParams.invoice_settings.issuer.type, checkout.SessionCreateParams.automatic_tax.liability.type, checkout.SessionCreateParams.invoice_creation.invoice_data.issuer.type, checkout.SessionCreateParams.subscription_data.invoice_settings.issuer.type, checkout.SessionUpdateParams.automatic_tax.liability.type, checkout.SessionUpdateParams.invoice_creation.invoice_data.issuer.type, and checkout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type
  • Add support for new value upi on enum checkout.SessionCreateParams.excludedPaymentMethodTypes
  • Change type of InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.taxCode, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.taxCode, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.taxCode, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.taxCode, PlanCreateParams.product[0].tax_details.taxCode, PriceCreateParams.product_data.tax_details.taxCode, ProductCreateParams.tax_details.taxCode, ProductUpdateParams.tax_details.taxCode, checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.taxCode, and checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.taxCode from string to emptyable(string)
  • Add support for crypto on checkout.SessionCreateParams.payment_method_options
  • Add support for new value upi on enum checkout.SessionCreateParams.paymentMethodTypes
  • Add support for pendingInvoiceItemInterval on checkout.SessionCreateParams.subscription_data and checkout.SessionUpdateParams.subscription_data
  • Add support for new values elements, embedded_page, form, and hosted_page on enum checkout.SessionCreateParams.uiMode
  • ⚠️ Remove support for values custom, embedded, and hosted from enum checkout.SessionCreateParams.uiMode
  • Change InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.taxCode, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.taxCode, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.taxCode, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.taxCode, PlanCreateParams.product[0].tax_details.taxCode, PriceCreateParams.product_data.tax_details.taxCode, ProductCreateParams.tax_details.taxCode, ProductUpdateParams.tax_details.taxCode, checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.taxCode, and checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.taxCode to be optional
  • Add support for auBecsDebit, bacsDebit, boleto, link, sepaDebit, and usBankAccount on checkout.Session.current_attempt.payment_method_details
  • Add support for new value upi on enums ConfirmationTokenCreateParams.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 metadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]
  • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for selectedFulfillmentOptionOverrides on delegatedcheckout.RequestedSession.fulfillment_details
  • Add support for lineItemKeys on delegatedcheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[] and delegatedcheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[]
  • Add support for quantityDecimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]
  • Add support for expiresAfterSeconds on Invoice.payment_settings.payment_method_options.pix, InvoiceCreateParams.payment_settings.payment_method_options.pix, InvoiceUpdateParams.payment_settings.payment_method_options.pix, QuotePreviewInvoice.payment_settings.payment_method_options.pix, Subscription.payment_settings.payment_method_options.pix, SubscriptionCreateParams.payment_settings.payment_method_options.pix, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
  • ⚠️ Add support for level on issuing.AuthorizationCreateParams.risk_assessment.card_testing_risk and issuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk
  • ⚠️ Remove support for riskLevel on issuing.AuthorizationCreateParams.risk_assessment.card_testing_risk and issuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk
  • Add support for new values da, `...

v32.0.0

This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

• ⚠️ Breaking change: #2182 Add setHttpClient to StripeClientBuilder; clean up apiKey/authenticator coupling
  • ⚠️ Removed RequestOptions.getApiKey(), RequestOptions.RequestOptionsBuilder.getApiKey(), and StripeClient.StripeClientBuilder.getApiKey(). Use getAuthenticator() instead.
  • Added StripeClient.StripeClientBuilder.setHttpClient(HttpClient) to allow injecting a custom HTTP client.
• ⚠️ Breaking change: #2187 Regenerate with decimal_string enabled for v2 APIs
  • V2 API decimal fields changed type from String to BigDecimal. Code that reads or writes these fields as String will need to use BigDecimal instead. Affected fields:
    • V2.Core.Account / V2.Core.AccountPerson: percentOwnership
    • PaymentEvaluation.Signals.FraudulentPayment: score
    • Params: AccountCreateParams, PersonCreateParams, AccountTokenCreateParams, PersonTokenCreateParams (all: percentOwnership)
    • Params: InvoiceItemCreateParams, InvoiceAddLinesParams, InvoiceUpdateLinesParams, InvoiceCreatePreviewParams (all: quantityDecimal)
• ⚠️ Breaking change: #2131 Use HTTP status code in V2 errors
  • RateLimitException now extends StripeException rather than ApiException
  • Non-200 status codes from V2 endpoints will throw a StripeException (e.g. RateLimitException, InvalidRequestException, etc.) like in V1 instead of a generic ApiException
• ⚠️ Breaking change: #2190 Throw an error when using the wrong webhook parsing method
• ⚠️ Breaking change: #2172 Make RequestOptions & RawRequestOptions constructors private and add Stripe-Request-Trigger header
• ⚠️ Breaking change: #2181 Change Automatic-Module-Name to com.stripe
  • Changes Automatic-Module-Name from stripe.java to com.stripe. Users with requires stripe.java; in their module-info.java will need to update to requires com.stripe;.
• #2179 Add runtime support for V2 int64 string-encoded fields

See the changelog for more details.