NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #219 most downloaded on Packagist
Stripe PHP Library
Latest stable
v23.1.0
Last release 3 days ago
19 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 54 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
721 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
See the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-11-18.preview.
V2.Billing.Cadencecreate and refill test helper methods on resource Capital.FinancingOfferall, cancel, create, retrieve, and update methods on resource V2.Billing.Cadenceexport_tax_transactions, product_tax_code_selector, and tax_threshold_monitoring on AccountSession.componentscustom on Coupon.create().$params and Coupontype on Coupon.create().$params and CustomerBalanceTransaction.create().$paramscustom on enum Coupon.typeapplied_to_invoice on CustomerBalanceTransaction.create().$paramscustomer_balance on Invoice and QuotePreviewInvoicePaymentIntent.next_action.verify_with_microdeposits.arrival_date and SetupIntent.next_action.verify_with_microdeposits.arrival_date from DateTime to nullable(DateTime)connect, data_export, event_destination, radar, and user_access on V2.Iam.ActivityLog.detailsapp, connect, data_export, event_destination, radar, and user_access on enum V2.Iam.ActivityLog.details.typeapps.install, v2.core.event_destination, and webhook_endpoint on enum V2.Iam.ActivityLog.related_object.typeapp_installed, app_uninstalled, application_authorized, application_created, application_deauthorized, connect_express_branding_updated, connect_oauth_disabled, connect_oauth_enabled, connect_settings_updated, connect_site_link_updated, data_export_requested, event_destination_added, event_destination_removed, event_destination_updated, payout_schedule_updated, radar_adaptive_3ds_disabled, radar_dynamic_risk_thresholds_disabled, radar_early_fraud_warning_disabled, radar_for_setup_intents_disabled, radar_fraud_dispute_protection_disabled, radar_rule_added, radar_rule_disabled, radar_rule_enabled, radar_rule_removed, radar_rule_updated, and user_access_started on enum V2.Iam.ActivityLog.typeapple_pay on V2.MoneyManagement.PayoutMethod and V2\MoneyManagement\OutboundSetupIntent.create().$params.payout_method_datumapple_pay on enum V2.MoneyManagement.PayoutMethod.typenetwork and originating_bank_account on V2.MoneyManagement.ReceivedDebit.bank_transfercreated on V2\MoneyManagement\ReceivedDebit.all().$paramslogs_from on V2\Iam\ActivityLog.all().$paramsseverity on EventsV2CoreHealthEventGenerationFailureResolvedEventinactive_api_operation_confirmation_required on QuotePreviewInvoice.last_finalization_errorYour coding agent can read these notes before it upgrades. Set up the MCP server →
See the changelog for the full release notes.
See the changelog for the full release notes.
See the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-11-18.endive.
Preserve custom api_base configuration across paginated requests
Ensure nextPage(), previousPage(), and autoPagingIterator() continue using the api_base configured on StripeClient.
Keep API keys out of serialized and dumped clients and event notifications
serialize(), print_r(), and var_dump() of an EventNotification or StripeClient no longer include the API key. print_r() and var_dump() show the client's key redacted. An unserialized notification keeps its fields but has no client, so fetchEvent() and fetchRelatedObject() throw \Stripe\Exception\AuthenticationException. Parse the original payload with StripeClient::parseEventNotification() to make requests. An unserialized client has no API key, including clients serialized by earlier SDK versions.
#2204 Update generated code
V2.Core.ClaimableSandboxcreate, renew_onboarding_link, and retrieve methods on resource V2.Core.ClaimableSandboxfunding_sources on Charge.payment_method_details.card.wallet.link and Charge.payment_method_details.linktron on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.networkfingerprint on Charge.payment_method_details.paypay, PaymentAttemptRecord.payment_method_details.paypay, and PaymentRecord.payment_method_details.paypayaddress_collection_precision on Checkout.Session.automatic_tax and Checkout\Session.create().$params.automatic_taxDispute.evidence.appeal to be requiredIssuing.Card.shipping.delivered_at to be requiredIssuing.Card.shipping.shipped_at to be requiredPaymentAttemptRecord.payment_method_details.card.stored_credential_usage and PaymentRecord.payment_method_details.card.stored_credential_usage to be requiredcar_rental_data and lodging_data on PaymentIntent.capture().$params.payment_detail, PaymentIntent.confirm().$params.payment_detail, PaymentIntent.create().$params.payment_detail, PaymentIntent.payment_details, and PaymentIntent.update().$params.payment_detailPaymentLink.create().$params.payment_intent_datum.capture_method from enum('automatic'|'automatic_async'|'manual') to emptyable(enum('automatic'|'automatic_async'|'manual'))capture_method on PaymentLink.update().$params.payment_intent_datumloss_message on Product.create().$params.marketing_feature, Product.marketing_features[], and Product.update().$params.marketing_featureapplication on Refundbizum and upi on Refund.destination_detailstax_invoice_month on Reporting.ReportRun.parameters and Reporting\ReportRun.create().$params.parameterigic on Tax.Registration.country_options.es and Tax\Registration.create().$params.country_option.eigic on enum Tax.Registration.country_options.es.typestripe_s700_devkit, stripe_s710_devkit, stripe_t600_devkit, verifone_ux700_devkit, and verifone_v660p_devkit on enum Terminal.Reader.device_typenetwork_details on Treasury.InboundTransfer.failure_details, Treasury.OutboundPayment.returned_details, Treasury.OutboundTransfer.returned_details, and Treasury\InboundTransfer.fail().$params.failure_detailfailure_details on Treasury\InboundTransfer.return_inbound_transfer().$paramsaccount_dashboard on V2.Core.AccountLink.use_case and V2\Core\AccountLink.create().$params.use_caseaccount_dashboard on enum V2.Core.AccountLink.use_case.typepaypay_payments on V2.Core.Account.configuration.merchant.capabilities, V2.Core.Account.configuration.merchant, V2\Core\Account.create().$params.configuration.merchant.capability, V2\Core\Account.create().$params.configuration.merchant, V2\Core\Account.update().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchantbillie_payments, mb_way_payments, nz_bank_account_becs_debit_payments, and pix_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilityadditional_material on V2.Core.Account.configuration.merchant.konbini_payments, V2\Core\Account.create().$params.configuration.merchant.konbini_payment, and V2\Core\Account.update().$params.configuration.merchant.konbini_paymentbillie_payments, mb_way_payments, nz_bank_account_becs_debit_payments, paypay_payments, and pix_payments on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitybillie_payments, mb_way_payments, nz_bank_account_becs_debit_payments, paypay_payments, and pix_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityV2CoreClaimableSandboxClaimedEvent, V2CoreClaimableSandboxCreatedEvent, V2CoreClaimableSandboxExpiredEvent, V2CoreClaimableSandboxExpiringEvent, and V2CoreClaimableSandboxUpdatedEvent with related object V2.Core.ClaimableSandboxinactive_api_operation_confirmation_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_errorSee the changelog for the full release notes.
See the changelog for the full release notes.
Improve webhook signature verification error messages
Stripe-Signature header, error messages help identify an incorrect signing secret or altered request body.⚠️ Omit API keys from native PHP serialization
Native PHP serialization of SDK resources no longer preserves API keys. Deserialization also discards keys embedded by earlier SDK versions. Before making requests through a restored resource, call reattachApiKey($apiKey). This also reattaches API keys to nested objects.
See the v23 migration guide for details.
#2187 Fix issue where v2 search requests can send multiple API requests
Preserve event context when fetching related objects from a directly retrieved Event
⚠️ StripeClient no longer inherits the legacy global Stripe::$accountId
⚠️ StripeClient no longer inherits the global account set by Stripe::setAccountId(). Previously, a client without a configured stripe_account could send requests under an unrelated account set elsewhere in the process.
If you relied on this behavior, pass ['stripe_account' => $accountId] when constructing the client or making a request.
An explicit ['stripe_account' => null] now clears the account for a request, overriding both the client's configured account and the global account. Legacy static API calls still inherit the global account when stripe_account is omitted.
See the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-10-28.preview.
PaymentPlan, V2.Data.QueryRun, V2.Data.ReportRun, V2.Data.Report, and V2.Data.Schemaall, create, retrieve, and update methods on resource PaymentPlanall and retrieve methods on resources V2.Data.Report and V2.Data.Schemacreate and retrieve methods on resources V2.Data.QueryRun and V2.Data.ReportRunacknowledge_confirmation_of_payee and initiate_confirmation_of_payee methods on resource V2.Core.Vault.GbBankAccountissuing.application_rejected_because_prohibited_business on enum AccountNotice.reasonsettlement_currencies on BalanceSettings.payments and BalanceSettings.update().$params.paymentdefault_settlement_currency on BalanceSettings.paymentswero on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datummandiri on enums Charge.payment_method_details.id_bank_transfer.bank, ConfirmationToken.payment_method_preview.id_bank_transfer.bank, PaymentAttemptRecord.payment_method_details.id_bank_transfer.bank, PaymentMethod.id_bank_transfer.bank, PaymentRecord.payment_method_details.id_bank_transfer.bank, and SetupAttempt.payment_method_details.id_bank_transfer.bankau_acn, au_wpn, bw_vat, ci_vat, cz_dic, fr_siren, fr_siret, fr_spi, gh_tin, is_kt, md_cf, mu_vat, mz_nuit, nz_bn, pt_nif, sm_coe, tt_bir, and tt_vat on enums Checkout.Session.collected_information.tax_id.type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].typeexternal_token on ConfirmationToken.create().$params.payment_method_datum.us_bank_account, PaymentIntent.confirm().$params.payment_method_datum.us_bank_account, PaymentIntent.create().$params.payment_method_datum.us_bank_account, PaymentIntent.update().$params.payment_method_datum.us_bank_account, PaymentMethod.create().$params.us_bank_account, SetupIntent.confirm().$params.payment_method_datum.us_bank_account, SetupIntent.create().$params.payment_method_datum.us_bank_account, SetupIntent.update().$params.payment_method_datum.us_bank_account, and Treasury\OutboundPayment.create().$params.destination_payment_method_datum.us_bank_accountwero on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeDispute.evidence.appeal from DisputeAppeal to nullable(DisputeAppeal)Dispute.evidence_details.submission_method to be requiredDispute.intended_submission_method to be requiredpayment_plan on Invoicewero on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typessequra on enum QuotePreviewInvoice.payment_settings.payment_method_typesQuotePreviewSubscriptionSchedule.pause_schedules to be requireddefault_outbound_destination on V2.Core.Account.configuration.recipient and V2\Core\Account.update().$params.configuration.recipientcrypto_wallets on V2.Core.Account.configuration.recipient.capabilities, V2\Core\Account.create().$params.configuration.recipient.capability, and V2\Core\Account.update().$params.configuration.recipient.capabilityach, fedwire, fps, rtp, sepa, and swift on V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2\Core\Account.create().$params.configuration.recipient.capability.bank_account, and V2\Core\Account.update().$params.configuration.recipient.capability.bank_accountwire on V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2\Core\Account.create().$params.configuration.recipient.capability.bank_account, and V2\Core\Account.update().$params.configuration.recipient.capability.bank_accountphysical on enum V2.Core.Account.identity.business_details.additional_addresses[].purposeproof_of_business_presence on V2.Core.Account.identity.business_details.documents, V2\Core\Account.create().$params.identity.business_detail.document, V2\Core\Account.update().$params.identity.business_detail.document, and V2\Core\AccountToken.create().$params.identity.business_detail.documentpartial_output_file on V2.Core.BatchJob.status_details.batch_failedfingerprint on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.bank_accountfutsu and toza from enum V2.Core.Vault.GbBankAccount.bank_account_typefedwire_fingerprint on V2.Core.Vault.UsBankAccountbalance_exchange and inbound_payment from enum V2.MoneyManagement.Adjustment.adjusted_flow.typeaddress on V2.MoneyManagement.FinancialAddress.bank_account.abaaccount_holder_address on V2.MoneyManagement.FinancialAddress.bank_account.abalast4 on V2.MoneyManagement.FinancialAddress.bank_account.aba, V2.MoneyManagement.FinancialAddress.bank_account.iban, and V2.MoneyManagement.FinancialAddress.bank_account.sort_codecountry on V2.MoneyManagement.FinancialAddress.bank_account.ibanV2.MoneyManagement.FinancialAddress.bank_account.aba.account_number and V2.MoneyManagement.FinancialAddress.bank_account.sort_code.account_number to be requiredV2.MoneyManagement.FinancialAddress.bank_account.iban.iban to be requiredV2.MoneyManagement.FinancialAddress.settlement_currency to be requiredtax_amount on V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[]becs, eft, npp, and sepa_instant from enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].network_fee_details.networknext_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].typepayout_method_options on V2.MoneyManagement.OutboundPayment.to, V2.MoneyManagement.OutboundPaymentQuote.to, V2.MoneyManagement.OutboundTransfer.to, V2\MoneyManagement\OutboundPayment.create().$params.to, V2\MoneyManagement\OutboundPaymentQuote.create().$params.to, and V2\MoneyManagement\OutboundTransfer.create().$params.topayout_intent and tracking_details on V2.MoneyManagement.OutboundPaymentrecipient_verification on V2.MoneyManagement.OutboundPayment and V2\MoneyManagement\OutboundPayment.create().$paramsV2.MoneyManagement.OutboundPayment.to.payout_method and V2.MoneyManagement.OutboundSetupIntent.payout_method to be optionalcrypto_wallet on V2.MoneyManagement.PayoutMethod and V2\MoneyManagement\OutboundSetupIntent.create().$params.payout_method_datumnetwork on V2.MoneyManagement.ReceivedCredit.bank_transfergb_bank_account, sepa_bank_account, and us_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transfernetwork on V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.aba, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.iban, and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.sort_codefee_batch on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowfee_transaction on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowfee_batch on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typefee_transaction from enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typemetadata and regulatory_receipt on V2.MoneyManagement.Transactioncontact_email on V2.Signals.AccountActivity.account_details.data, V2.Signals.AccountEvaluation.account_details.data, V2\Signals\AccountActivity.create().$params.account_detail.datum, and V2\Signals\AccountEvaluation.create().$params.account_detail.datumstatement_descriptor on V2\MoneyManagement\OutboundPayment.create().$params and V2\MoneyManagement\OutboundTransfer.create().$paramscreated_gt, created_gte, created_lt, and created_lte on V2\MoneyManagement\OutboundPayment.all().$paramsV2\MoneyManagement\OutboundPayment.all().$params.created from DateTime to an objectsettlement_currency on V2\MoneyManagement\FinancialAddress.create().$paramsdeposit_insurance_eligibility on V2\MoneyManagement\FinancialAccount.create().$params.storagePAYMENT_PLAN_CREATED, PAYMENT_PLAN_INSTALLMENT_DUE, PAYMENT_PLAN_INSTALLMENT_PAID, PAYMENT_PLAN_INSTALLMENT_WILL_BE_DUE, and PAYMENT_PLAN_UPDATED with resource PaymentPlanV2DataQueryRunCreatedEvent, V2DataQueryRunFailedEvent, V2DataQueryRunSucceededEvent, and V2DataQueryRunUpdatedEvent with related object V2.Data.QueryRunV2DataReportRunCreatedEvent, V2DataReportRunFailedEvent, V2DataReportRunSucceededEvent, and V2DataReportRunUpdatedEvent with related object V2.Data.ReportRunsmart_disputes_not_available, subscription_update_trial_after_billing_cycle_anchor, three_d_secure_authentication_not_supported, and three_d_secure_authentication_upstream_error on QuotePreviewInvoice.last_finalization_errorSee the changelog for the full release notes.
See the changelog for the full release notes.
V2.MoneyManagement.SpendingMandateall, cancel, and retrieve methods on resource V2.MoneyManagement.SpendingMandatecardholder_message on Charge.payment_method_details.card_present.receipt, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present.receipt, PaymentAttemptRecord.payment_method_details.card_present.receipt, PaymentMethod.card.generated_from.payment_method_details.card_present.receipt, and PaymentRecord.payment_method_details.card_present.receiptpricing_token on Checkout\Session.create().$paramsmarketing_attributions on Customer.update().$paramsfraudulent_selfie on Identity.VerificationReport.signalstoss_pay on Mandate.payment_method_details, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, and SetupAttempt.payment_method_detailspayment_evaluations on PaymentAttemptRecord.report_authenticated().$paramsthree_d_secure on PaymentAttemptRecord.report_authorized().$params.payment_method_detail.card, PaymentAttemptRecord.report_guaranteed().$params.payment_method_detail.card, PaymentRecord.report_payment().$params.payment_method_detail.card, PaymentRecord.report_payment_attempt().$params.payment_method_detail.card, and PaymentRecord.report_payment_attempt_guaranteed().$params.payment_method_detail.cardwechat_pay_redirect_to_mini_program on PaymentIntent.next_actioncustomer_presence and payment_type on Radar.PaymentEvaluation.payment_details.money_movement_details.sepa_debit and Radar\PaymentEvaluation.create().$params.payment_detail.money_movement_detail.sepa_debitfinancial_connections on SetupIntent.confirm().$params.payment_method_option.bacs_debit, SetupIntent.create().$params.payment_method_option.bacs_debit, SetupIntent.payment_method_options.bacs_debit, and SetupIntent.update().$params.payment_method_option.bacs_debitreferral_fee_details on SharedPayment.GrantedToken, SharedPayment.IssuedToken, and SharedPayment\IssuedToken.create().$paramsdevice_health_details and device_health on Terminal.Readercheck_attachment_too_large, check_expired, and check_undeliverable on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reasoncheck_send on V2.MoneyManagement.OutboundPayment.to.payout_method_options, V2.MoneyManagement.OutboundPayment.tracking_details, V2.MoneyManagement.PayoutIntent.to.payout_method_options, V2.MoneyManagement.PayoutMethod, V2\MoneyManagement\OutboundPayment.create().$params.to.payout_method_option, V2\MoneyManagement\OutboundSetupIntent.create().$params.payout_method_datum, V2\MoneyManagement\PayoutIntent.create().$params.to.payout_method_option, and V2\MoneyManagement\PayoutIntent.update().$params.to.payout_method_optioncheck_attachment_too_large, check_expired, and check_undeliverable on enum V2.MoneyManagement.PayoutIntent.next_action.handle_failure.failure_reasoncheck_send on enum V2.MoneyManagement.PayoutMethod.typespending_mandate on V2.MoneyManagement.ReceivedDebit.bank_transfer and V2\MoneyManagement\ReceivedDebit.all().$paramsV2MoneyManagementSpendingMandateCanceledEvent, V2MoneyManagementSpendingMandateCreatedEvent, V2MoneyManagementSpendingMandateExpiredEvent, V2MoneyManagementSpendingMandatePendingCancellationEvent, and V2MoneyManagementSpendingMandateUpdatedEvent with related object V2.MoneyManagement.SpendingMandateMerchantNotGatedException on V2.Core.Vault.NetworkToken#create_from_credentialSee the changelog for the full release notes.
See the changelog for the full release notes.
Tax.Certificate, Tax.FormCorrection, V2.Extend.ObjectDefinitionVersion, and V2.Extend.ObjectDefinitionall, create, delete, and retrieve methods on resource Tax.Certificatecreate method on resource Tax.Formall and retrieve methods on resources V2.Extend.ObjectDefinitionVersion and V2.Extend.ObjectDefinitionbills, financial_account_rewards, financial_accounts_transactions, financial_accounts, network_cost_passthrough_report, and recipients_list on AccountSession.create().$params.componentbusiness_profile_management on AccountSession.create().$params.component, V2.Core.AccountSession.components, and V2\Core\AccountSession.create().$params.componentexport_tax_transactions, product_tax_code_selector, and tax_threshold_monitoring on AccountSession.componentsaeon_pay, au_pay, dbarai, and merpay on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_datum, PaymentMethod.create().$params, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datumfunding_sources on Charge.payment_method_details.card.wallet.link and Charge.payment_method_details.linkfleet on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_presentfingerprint on Charge.payment_method_details.paypay, PaymentAttemptRecord.payment_method_details.paypay, PaymentRecord.payment_method_details.paypay, and SetupAttempt.payment_method_details.paypaycustom_payment_method_options on Checkout\Session.create().$paramsstripe_balance on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_optionsetup_future_usage on Checkout.Session.payment_method_options.paypay and Checkout\Session.create().$params.payment_method_option.paypaybuyer_choice on enum Checkout.Session.payment_method_options.acss_debit.mandate_options.transaction_typeinstant on enums Checkout.Session.payment_method_options.bacs_debit.verification_method, Invoice.payment_settings.payment_method_options.bacs_debit.verification_method, PaymentIntent.payment_method_options.bacs_debit.verification_method, QuotePreviewInvoice.payment_settings.payment_method_options.bacs_debit.verification_method, SetupIntent.payment_method_options.bacs_debit.verification_method, and Subscription.payment_settings.payment_method_options.bacs_debit.verification_methodaeon_pay, au_pay, dbarai, and merpay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typereason_details and reason on CustomerTaxExemption.create().$params and CustomerTaxExemptiontax_code_group on CustomerTaxExemption.create().$params.me and CustomerTaxExemption.usDispute.evidence.appeal to be requiredtarget_date on Invoice.create().$params.payment_setting.payment_method_option.sepa_debit, Invoice.payment_settings.payment_method_options.sepa_debit, and Invoice.update().$params.payment_setting.payment_method_option.sepa_debitIssuing.Card.shipping.delivered_at to be requiredIssuing.Card.shipping.shipped_at to be requiredpayment_method_details on PaymentAttemptRecord.report_authenticated().$paramsPaymentAttemptRecord.report_guaranteed().$params.payment_method_detail.type and PaymentRecord.report_payment_attempt_guaranteed().$params.payment_method_detail.type from literal('card') to enum('card'|'us_bank_account')dispute_details on PaymentAttemptRecord and PaymentRecordev_charging and fleet_data on PaymentIntent.capture().$params.amount_detail.line_item.payment_method_option.card_present, PaymentIntent.confirm().$params.amount_detail.line_item.payment_method_option.card_present, PaymentIntent.create().$params.amount_detail.line_item.payment_method_option.card_present, PaymentIntent.decrement_authorization().$params.amount_detail.line_item.payment_method_option.card_present, PaymentIntent.increment_authorization().$params.amount_detail.line_item.payment_method_option.card_present, PaymentIntent.update().$params.amount_detail.line_item.payment_method_option.card_present, and PaymentIntentAmountDetailsLineItem.payment_method_options.card_presentfinancial_connections on PaymentIntent.confirm().$params.payment_method_option.bacs_debit, PaymentIntent.create().$params.payment_method_option.bacs_debit, PaymentIntent.payment_method_options.bacs_debit, and PaymentIntent.update().$params.payment_method_option.bacs_debitaeon_pay, au_pay, dbarai, and merpay on enums PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_typesaeon_pay, au_pay, dbarai, and merpay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typespayment_details on PaymentIntent.payment_method_options.card_present and PaymentIntent.payment_method_options.cardon_session from enum PaymentIntent.payment_method_options.paypay.setup_future_usagetamara on enum PaymentLink.payment_method_typesrakuten_pay on PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, and PaymentMethodConfigurationsepa_debit on Radar.PaymentEvaluation.payment_details.money_movement_details and Radar\PaymentEvaluation.create().$params.payment_detail.money_movement_detailsepa_debit on enum Radar.PaymentEvaluation.payment_details.money_movement_details.money_movement_typecontinue_with_manual_review on enum Radar.PaymentEvaluation.recommended_actioncard_testing on Radar.PaymentEvaluation.signalspayment_method on Refund.create().$paramspayment_record on Refundbizum and upi on Refund.destination_detailstax_invoice_month on Reporting.ReportRun.parametersradar_options on SetupIntent.confirm().$params, SetupIntent.create().$params, and SetupIntentbilling_group on Subscription.all().$params, Subscription.create().$params, Subscription.update().$params, and Subscriptionnetwork_details on Treasury.InboundTransfer.failure_details, Treasury.OutboundPayment.returned_details, and Treasury.OutboundTransfer.returned_detailsV2ExtendObjectDefinitionCreatedEvent with related object V2.Extend.ObjectDefinitionV2ExtendObjectDefinitionVersionCreatedEvent with related object V2.Extend.ObjectDefinitionVersionSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-10-28.preview.
V2.Billing.ContractTermQuantityChange, V2.Billing.ContractTerm, V2.Core.AccountSession, V2.MoneyManagement.FundingIntent, V2.MoneyManagement.InboundFunding, V2.MoneyManagement.RewardProgramEnrollment, V2.MoneyManagement.RewardProgramRule, V2.MoneyManagement.RewardProgram, and V2.Risk.FormV2.Risk.Inquiryretrieve and update methods on resource V2.Risk.Formactivate, all, create, deactivate, and retrieve methods on resource V2.MoneyManagement.RewardProgramEnrollmentactivate, all, create, deactivate, retrieve, and update methods on resources V2.MoneyManagement.RewardProgramRule and V2.MoneyManagement.RewardProgramall and retrieve methods on resource V2.MoneyManagement.InboundFundingall, cancel, confirm, create, retrieve, and update methods on resource V2.MoneyManagement.FundingIntentcreate method on resource V2.Core.AccountSessionlist_contract_terms and retrieve_contract_term methods on resource V2.Billing.ContractTermall, retrieve, and update methods on resource V2.Risk.Inquiryfx_quote method on resource V2.MoneyManagement.PayoutIntentreject and unreject methods on resource V2.Core.Accountbilling_group on Billing.Alert.spend_threshold.filters, Billing.AlertNotification, Billing.AlertTriggered.group_by, Billing\Alert.create().$params.spend_threshold.filter, and Billing\AlertNotification.all().$paramstoss_pay on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datummandate on Charge.payment_method_details.paypay, PaymentAttemptRecord.payment_method_details.paypay, PaymentRecord.payment_method_details.paypay, Subscription.create().$params.payment_setting, Subscription.payment_settings, and Subscription.update().$params.payment_settingautomatic_pass_through_fee on Checkout.Session and Checkout\Session.create().$paramspaypay on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_optionCheckout\Session.create().$params.marketing_attribution.ad_conversion to be optionaladjustable_quantity on Checkout.Session.items[].subscription.items[]Checkout.Session.marketing_attributions[].ad_conversion to be optionalmarketing_attributions on Customer.create().$params and Customermerchant_of_record on PaymentIntent.confirm().$params.payment_detail.money_service.account_funding, PaymentIntent.create().$params.payment_detail.money_service.account_funding, PaymentIntent.payment_details.money_services.account_funding, and PaymentIntent.update().$params.payment_detail.money_service.account_fundingRadar.PaymentEvaluation.signals.early_fraud_warning from Payment Evaluation Signal to nullable(Payment Evaluation Signal)Radar.PaymentEvaluation.signals.early_fraud_warning to be requiredpayment_method_data and payment_method_options on Refund.create().$paramsdebit_behavior on Subscription.create().$params.payment_setting.payment_method_option.sepa_debit, Subscription.payment_settings.payment_method_options.sepa_debit, and Subscription.update().$params.payment_setting.payment_method_option.sepa_debitterms on V2.Billing.Contract, V2\Billing\Contract.cancel().$params, and V2\Billing\Contract.create().$paramsuser_affinity on enum V2.Core.AccountEvaluation.evaluations_triggereduser_merchant_fit from enum V2.Core.AccountEvaluation.evaluations_triggeredrejection on V2.Core.Accountalipay_payments, scalapay_payments, and upi_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilityinbound_fundings on V2.Core.Account.configuration.money_manager.capabilities, V2\Core\Account.create().$params.configuration.money_manager.capability, and V2\Core\Account.update().$params.configuration.money_manager.capabilityinstant and sepa_credit on V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2\Core\Account.create().$params.configuration.recipient.capability.bank_account, and V2\Core\Account.update().$params.configuration.recipient.capability.bank_accountcompression on V2.Data.QueryRun.result_options, V2.Data.ReportRun.result_options, V2\Data\QueryRun.create().$params.result_option, and V2\Data\ReportRun.create().$params.result_optioncompress_file on V2.Data.QueryRun.result_options, V2.Data.ReportRun.result_options, V2\Data\QueryRun.create().$params.result_option, and V2\Data\ReportRun.create().$params.result_optionquery_errors on V2.Data.QueryRun.status_details and V2.Data.ReportRun.status_detailsexecution_failed and resource_limit_exceeded on enums V2.Data.QueryRun.status_details.code and V2.Data.ReportRun.status_details.codeformat on V2.Data.ReportRunrefreshed_at on V2.Data.Reportschema_name on V2.Data.Schema.columns[].foreign_keys_from[] and V2.Data.Schema.columns[].foreign_keys_to[]authentication and session_fingerprint on V2.Iam.ActivityLog.details.user_accessuser_agent on V2.Iam.ActivityLog.details.user_access.dashboard_clientbrowser_version, browser, device_type, and os on V2.Iam.ActivityLog.details.user_access.dashboard_clientlevel on V2.Iam.ActivityLog.details.user_access.riskreference on V2.MoneyManagement.FinancialAddress.bank_account.ibansepa on enums V2.MoneyManagement.OutboundPayment.to.payout_method_options.bank_account.preferred_networks, V2.MoneyManagement.OutboundPaymentQuote.to.payout_method_options.bank_account.preferred_networks, V2.MoneyManagement.OutboundTransfer.to.payout_method_options.bank_account.preferred_networks, and V2.MoneyManagement.PayoutIntent.to.payout_method_options.bank_account.preferred_networksV2.MoneyManagement.OutboundPayment.to.payout_method_options.bank_account.preferred_networks, V2.MoneyManagement.OutboundPaymentQuote.to.payout_method_options.bank_account.preferred_networks, and V2.MoneyManagement.PayoutIntent.to.payout_method_options.bank_account.preferred_networks to be optionalbank_account, card, crypto_wallet, status, and type on V2.MoneyManagement.OutboundPayment.tracking_detailsrecipient_verification on V2.MoneyManagement.PayoutIntentfields_to_review on V2.MoneyManagement.PayoutIntent.next_action.confirmpayout_method_invalid and recipient_capability_not_active on enum V2.MoneyManagement.PayoutIntent.next_action.handle_failure.failure_reasoncurrency_required from enum V2.MoneyManagement.PayoutIntent.next_action.handle_failure.failure_reasonV2.MoneyManagement.PayoutIntent.latest_payout to be optionalca_bank_account, eu_bank_account, and mx_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transfernetwork on V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.aba, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.bre_b, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.clabe, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.cpa, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.iban, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.nip, V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.pix, and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.sort_codepayout_method, recipient, and verification_type on V2.MoneyManagement.RecipientVerificationV2.MoneyManagement.RecipientVerification.consumed_by from string to an objectmatched_business_type and provided_business_type on V2.MoneyManagement.RecipientVerification.match_result_detailsV2.MoneyManagement.RecipientVerification.expires_at to be optionalrequires_capture from enum V2.Payments.OffSessionPayment.statusconfiguration on V2.Provisioning.Resourcecustom_marketing_action and triggering_signal on V2.Signals.AccountActivity and V2\Signals\AccountActivity.create().$paramsmfa_challenges on V2.Signals.AccountActivity.login_decision and V2\Signals\AccountActivity.create().$params.login_decisioncustom_marketing_action on enum V2.Signals.AccountActivity.typeuser_affinity on V2.Signals.AccountEvaluation.evaluated_signals and V2.Signals.AccountSignaluser_merchant_fit on V2.Signals.AccountEvaluation.evaluated_signals and V2.Signals.AccountSignaluser_affinity on enum V2.Signals.AccountEvaluation.pending_signalsuser_merchant_fit from enum V2.Signals.AccountEvaluation.pending_signalsuser_affinity on enum V2.Signals.AccountEvaluation.requested_signalsuser_merchant_fit from enum V2.Signals.AccountEvaluation.requested_signalsadditional_details on V2.Signals.AccountSignal.customer_riskuser_affinity on enum V2.Signals.AccountSignal.typeuser_merchant_fit from enum V2.Signals.AccountSignal.typesubscriptions on V2.Tax.IntegrationConfiguration and V2\Tax\IntegrationConfiguration.update().$paramsinclude on V2\Provisioning\Resource.retrieve().$paramsV2\MoneyManagement\OutboundPayment.create().$params.to.payout_method_option.bank_account.preferred_networks, V2\MoneyManagement\OutboundPaymentQuote.create().$params.to.payout_method_option.bank_account.preferred_networks, V2\MoneyManagement\PayoutIntent.create().$params.to.payout_method_option.bank_account.preferred_networks, and V2\MoneyManagement\PayoutIntent.update().$params.to.payout_method_option.bank_account.preferred_networks to be optionalamount and from on V2\MoneyManagement\PayoutIntent.update().$paramsparameters on V2\Data\QueryRun.create().$paramsactions on V2\Billing\Contract.update().$paramsalipay_payments, scalapay_payments, and upi_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityinbound_fundings.paper_checks on enum EventsV2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent.updated_capabilityseverity on EventsV2CoreHealthApiErrorFiringEvent, EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyFiringEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropFiringEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthElementsErrorFiringEvent, EventsV2CoreHealthElementsErrorResolvedEvent, EventsV2CoreHealthFraudRateIncreasedEvent, EventsV2CoreHealthInvoiceCountDroppedFiringEvent, EventsV2CoreHealthInvoiceCountDroppedResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthMeterEventSummariesDelayedFiringEvent, EventsV2CoreHealthMeterEventSummariesDelayedResolvedEvent, EventsV2CoreHealthMetronomeNotificationLatencyFiringEvent, EventsV2CoreHealthMetronomeNotificationLatencyResolvedEvent, EventsV2CoreHealthPaymentMethodErrorFiringEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropFiringEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, EventsV2CoreHealthWebhookLatencyFiringEvent, and EventsV2CoreHealthWebhookLatencyResolvedEventV2BillingContractTermCreatedEvent, V2BillingContractTermDeletedEvent, and V2BillingContractTermUpdatedEvent with related object V2.Billing.ContractTermV2MoneyManagementFundingIntentCanceledEvent, V2MoneyManagementFundingIntentCreatedEvent, V2MoneyManagementFundingIntentProcessingEvent, V2MoneyManagementFundingIntentRequiresActionEvent, V2MoneyManagementFundingIntentRequiresConfirmationEvent, V2MoneyManagementFundingIntentSucceededEvent, V2MoneyManagementFundingIntentUpdatedEvent, and V2MoneyManagementFundingIntentValidatingEvent with related object V2.MoneyManagement.FundingIntentV2MoneyManagementInboundFundingAvailableEvent, V2MoneyManagementInboundFundingCheckFailedEvent, V2MoneyManagementInboundFundingCheckProcessingEvent, V2MoneyManagementInboundFundingCheckQueuedEvent, V2MoneyManagementInboundFundingCheckReturnedEvent, V2MoneyManagementInboundFundingCheckSucceededEvent, V2MoneyManagementInboundFundingCreatedEvent, and V2MoneyManagementInboundFundingUpdatedEvent with related object V2.MoneyManagement.InboundFundingV2MoneyManagementRewardProgramRewardEarnedEvent and V2MoneyManagementRewardProgramRewardReversedEvent with related object V2.MoneyManagement.RewardProgramV2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent and V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent with related object V2.Payments.OffSessionPaymentSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-10-28.endive.
#2172 Reject ASCII-whitespace-only webhook secrets
Ensure idempotency key is set for retries when max_network_retries is configured on StripeClient
Previously, CurlClient would only check Stripe::getMaxNetworkRetries() when determining whether to set the idempotency key.
This also fixes an issue where streaming requests would not receive the configured retry count due to a missing $apiMode argument.
#2171 Add API v2 Search support
Adds Stripe\V2\SearchResult<T> and support for auto pagination of search results.
Replace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The previous bundle contained several certificates not used by Stripe, including emSign ECC Root CA - G3, whose intermediate CAs were compromised.
Preserve event context on fetched related objects
#2182 Update generated code
V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.FinancialAddressCreditSimulation, V2.MoneyManagement.FinancialAddress, V2.MoneyManagement.InboundTransfer, V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundSetupIntent, V2.MoneyManagement.PayoutIntent, V2.MoneyManagement.PayoutMethod, V2.MoneyManagement.PayoutMethodsBankAccountSpec, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.RecipientVerification, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transactionacknowledge, create, recipient_verifications, and retrieve methods on resource V2.MoneyManagement.RecipientVerificationall and retrieve methods on resources V2.MoneyManagement.Adjustment, V2.MoneyManagement.ReceivedCredit, and V2.MoneyManagement.TransactionEntryall, refresh_regulatory_receipt, retrieve, and update methods on resource V2.MoneyManagement.Transactioncredit method on resource V2.MoneyManagement.FinancialAddressCreditSimulationretrieve method on resource V2.MoneyManagement.PayoutMethodsBankAccountSpecall, archive, retrieve, and unarchive methods on resource V2.MoneyManagement.PayoutMethodall, cancel, confirm, create, refresh_fx_quote, refresh_recipient_verification, retrieve, and update methods on resource V2.MoneyManagement.PayoutIntentall, cancel, create, retrieve, and update methods on resource V2.MoneyManagement.OutboundSetupIntentall, cancel, create, and retrieve methods on resource V2.MoneyManagement.OutboundPaymentall, create, and retrieve methods on resources V2.MoneyManagement.FinancialAddress and V2.MoneyManagement.InboundTransferall, retrieve, and update methods on resource V2.MoneyManagement.FinancialAccountall, archive, confirm_microdeposits, create, retrieve, send_microdeposits, unarchive, and update methods on resource V2.Core.Vault.UsBankAccountall, archive, create, retrieve, and unarchive methods on resource V2.Core.Vault.GbBankAccountget_fund and nhil on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typereporting_chart, terminal_hardware_orders, and terminal_hardware_shop on AccountSession.components and AccountSession.create().$params.componentwero_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capabilityphysical_address on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.companyproof_of_business_presence on Account.create().$params.document and Account.update().$params.documentsubscription_pause on BillingPortal.Configuration.features, BillingPortal.Session.flow, BillingPortal\Configuration.create().$params.feature, BillingPortal\Configuration.update().$params.feature, and BillingPortal\Session.create().$params.flow_datumafter_expiration on BillingPortal.Session and BillingPortal\Session.create().$paramssubscription_pause on enum BillingPortal.Session.flow.typesetup_credential_usage on Charge.payment_method_details.card, PaymentIntent.confirm().$params.payment_method_option.card, PaymentIntent.create().$params.payment_method_option.card, PaymentIntent.payment_method_options.card, PaymentIntent.update().$params.payment_method_option.card, SetupIntent.confirm().$params.payment_method_option.card, SetupIntent.create().$params.payment_method_option.card, SetupIntent.payment_method_options.card, and SetupIntent.update().$params.payment_method_option.cardstored_credential_usage on Charge.payment_method_details.card, PaymentAttemptRecord.payment_method_details.card, PaymentIntent.confirm().$params.payment_method_option.card, PaymentIntent.create().$params.payment_method_option.card, PaymentIntent.payment_method_options.card, PaymentIntent.update().$params.payment_method_option.card, and PaymentRecord.payment_method_details.cardousd on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currencyaccount_tax_ids, custom_fields, description, and footer on Checkout\Session.create().$params.subscription_datum.invoice_setting, PaymentLink.create().$params.subscription_datum.invoice_setting, PaymentLink.subscription_data.invoice_settings, and PaymentLink.update().$params.subscription_datum.invoice_settingpayment_intent_data on Checkout\Session.update().$paramsau_acn, au_wpn, bw_vat, ci_vat, cz_dic, fr_siren, fr_siret, fr_spi, gh_tin, is_kt, md_cf, mu_vat, mz_nuit, nz_bn, pt_nif, sm_coe, tt_bir, and tt_vat on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typefednow and rtp on enum CustomerCashBalanceTransaction.funded.bank_transfer.us_bank_transfer.networkintended_submission_method on Dispute.update().$params and Disputeappeal on Dispute.evidence and Dispute.update().$params.evidencesubmission_method on Dispute.evidence_detailsappeal_needs_response and appeal_under_review on enum Dispute.statusthree_d_secure.authentication.canceled, three_d_secure.authentication.challenge_started, three_d_secure.authentication.errored, three_d_secure.authentication.failed, three_d_secure.authentication.requires_challenge, three_d_secure.authentication.requires_submission, and three_d_secure.authentication.succeeded on enum Event.typepause_schedules on Invoice.create_preview().$params.schedule_detailsequra on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typesfinancial_account on Issuing\Card.update().$paramsdelivered_at and shipped_at on Issuing.Card.shippingscalapay on enum PaymentLink.payment_method_typesreference_status and reference on Refund.destination_details.afterpay_clearpay, Refund.destination_details.klarna, and Refund.destination_details.paypalSubscriptionSchedule.pause_schedules to be requiredbw, ci, gh, and mu on Tax.Registration.country_options and Tax\Registration.create().$params.country_optionutility_users_tax on Tax.Registration.country_options.us and Tax\Registration.create().$params.country_option.medigital_excise_tax and utility_users_tax on enum Tax.Registration.country_options.us.typeadmissions_tax, attendance_tax, entertainment_tax, get_fund, gross_receipts_tax, hospitality_tax, luxury_tax, nhil, resort_tax, and tourism_tax on enum TaxRate.tax_typereader_security and stripe_t600 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$paramssimulated_stripe_t600 and stripe_t600 on enum Terminal.Reader.device_typebank_accounts and cards on V2.Core.Account.configuration.recipient.capabilities, V2\Core\Account.create().$params.configuration.recipient.capability, and V2\Core\Account.update().$params.configuration.recipient.capabilitypayout_methods on V2.Core.Account.defaults and V2\Core\Account.update().$params.defaultalternatives on V2.Core.Account.future_requirements and V2.Core.Account.requirementsbank_accounts.ach, bank_accounts.fedwire, bank_accounts.fps, bank_accounts.rtp, bank_accounts.sepa, and bank_accounts.swift on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitycustomer and subscription on EventsV1InvoiceUpcomingEventbank_accounts.ach, bank_accounts.fedwire, bank_accounts.fps, bank_accounts.rtp, bank_accounts.sepa, and bank_accounts.swift on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityTHREE_D_SECURE_AUTHENTICATION_CANCELED, THREE_D_SECURE_AUTHENTICATION_CHALLENGE_STARTED, THREE_D_SECURE_AUTHENTICATION_ERRORED, THREE_D_SECURE_AUTHENTICATION_FAILED, THREE_D_SECURE_AUTHENTICATION_REQUIRES_CHALLENGE, THREE_D_SECURE_AUTHENTICATION_REQUIRES_SUBMISSION, and THREE_D_SECURE_AUTHENTICATION_SUCCEEDED with resource ThreeDSecure.AuthenticationV1CustomerDiscountSourceChangedEvent, V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent, and V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEventV1CustomerSubscriptionActiveEvent, V1CustomerSubscriptionCancelAtChangedEvent, V1CustomerSubscriptionDefaultPaymentMethodChangedEvent, V1CustomerSubscriptionIncompleteEvent, V1CustomerSubscriptionIncompleteExpiredEvent, V1CustomerSubscriptionItemAddedEvent, V1CustomerSubscriptionItemPriceChangedEvent, V1CustomerSubscriptionItemQuantityChangedEvent, V1CustomerSubscriptionItemRemovedEvent, V1CustomerSubscriptionItemTaxRatesChangedEvent, V1CustomerSubscriptionPastDueEvent, V1CustomerSubscriptionTrialingEvent, and V1CustomerSubscriptionUnpaidEvent with related object SubscriptionV1FinancialConnectionsAccountBalanceRefreshFailedEvent, V1FinancialConnectionsAccountBalanceRefreshSucceededEvent, V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent, V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent, V1FinancialConnectionsAccountOwnershipRefreshFailedEvent, V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent, V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent, V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent, V1FinancialConnectionsAccountTransactionsRefreshFailedEvent, and V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent with related object FinancialConnections.AccountV1InvoiceDiscountAddedEvent, V1InvoiceDiscountRemovedEvent, V1InvoiceLineItemAddedEvent, V1InvoiceLineItemPricingChangedEvent, V1InvoiceLineItemQuantityChangedEvent, and V1InvoiceLineItemRemovedEvent with related object InvoiceV1InvoicePaymentCanceledEvent and V1InvoicePaymentOpenEvent with related object InvoicePaymentV1InvoiceitemAmountChangedEvent, V1InvoiceitemDiscountAddedEvent, and V1InvoiceitemDiscountRemovedEvent with related object InvoiceItemV1PriceActivatedEvent, V1PriceDeactivatedEvent, V1PriceLookupKeyChangedEvent, and V1PriceTaxBehaviorChangedEvent with related object PriceV1ProductActivatedEvent, V1ProductDeactivatedEvent, V1ProductDefaultPriceChangedEvent, and V1ProductTaxCodeChangedEvent with related object ProductV1PromotionCodeFullyRedeemedEvent with related object PromotionCodeV1SubscriptionSchedulePhaseAddedEvent, V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent, V1SubscriptionSchedulePhaseEndDateChangedEvent, V1SubscriptionSchedulePhaseRemovedEvent, and V1SubscriptionSchedulePhaseTrialEndChangedEvent with related object SubscriptionScheduleV2MoneyManagementAdjustmentCreatedEvent with related object V2.MoneyManagement.AdjustmentV2MoneyManagementFinancialAccountCreatedEvent and V2MoneyManagementFinancialAccountUpdatedEvent with related object V2.MoneyManagement.FinancialAccountV2MoneyManagementFinancialAddressActivatedEvent and V2MoneyManagementFinancialAddressFailedEvent with related object V2.MoneyManagement.FinancialAddressV2MoneyManagementInboundTransferAvailableEvent, V2MoneyManagementInboundTransferBankDebitFailedEvent, V2MoneyManagementInboundTransferBankDebitProcessingEvent, V2MoneyManagementInboundTransferBankDebitQueuedEvent, V2MoneyManagementInboundTransferBankDebitReturnedEvent, and V2MoneyManagementInboundTransferBankDebitSucceededEvent with related object V2.MoneyManagement.InboundTransferV2MoneyManagementOutboundPaymentCanceledEvent, V2MoneyManagementOutboundPaymentCreatedEvent, V2MoneyManagementOutboundPaymentFailedEvent, V2MoneyManagementOutboundPaymentPostedEvent, V2MoneyManagementOutboundPaymentReturnedEvent, V2MoneyManagementOutboundPaymentUnderReviewEvent, and V2MoneyManagementOutboundPaymentUpdatedEvent with related object V2.MoneyManagement.OutboundPaymentV2MoneyManagementPayoutIntentCanceledEvent, V2MoneyManagementPayoutIntentCreatedEvent, V2MoneyManagementPayoutIntentPendingEvent, V2MoneyManagementPayoutIntentPostedEvent, V2MoneyManagementPayoutIntentProcessingEvent, V2MoneyManagementPayoutIntentRequiresActionEvent, and V2MoneyManagementPayoutIntentUpdatedEvent with related object V2.MoneyManagement.PayoutIntentV2MoneyManagementPayoutMethodCreatedEvent and V2MoneyManagementPayoutMethodUpdatedEvent with related object V2.MoneyManagement.PayoutMethodV2MoneyManagementReceivedCreditAvailableEvent, V2MoneyManagementReceivedCreditFailedEvent, V2MoneyManagementReceivedCreditReturnedEvent, and V2MoneyManagementReceivedCreditSucceededEvent with related object V2.MoneyManagement.ReceivedCreditV2MoneyManagementRecipientVerificationCreatedEvent and V2MoneyManagementRecipientVerificationUpdatedEvent with related object V2.MoneyManagement.RecipientVerificationV2MoneyManagementTransactionCreatedEvent and V2MoneyManagementTransactionUpdatedEvent with related object V2.MoneyManagement.TransactionAlreadyCanceledException, BlockedByStripeException, CannotProceedException, CapabilityNotEnabledException, ControlledByAlternateResourceException, FeatureNotEnabledException, FinancialAccountNotOpenException, FxQuoteNeedsRefreshException, InsufficientFundsException, InvalidPaymentMethodException, InvalidPayoutMethodException, InvalidVaultedCredentialException, NotCancelableException, QuotaExceededException, RecipientNotNotifiableException, VerificationAttemptFailedException, VerificationExpiredException, and VerificationNotInitiatedExceptionsmart_disputes_not_available, subscription_update_trial_after_billing_cycle_anchor, three_d_secure_authentication_not_supported, and three_d_secure_authentication_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_errorSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-09-30.preview.
Radar.BillingEvaluation, V2.MoneyManagement.FinancialAddressCreditSimulation, and V2.MoneyManagement.FinancialAddressGeneratedMicrodepositsV2.FinancialAddressCreditSimulation and V2.FinancialAddressGeneratedMicrodepositscreate method on resource Radar.BillingEvaluationall method on resource Reserve.Plancredit method on resource V2.MoneyManagement.FinancialAddressCreditSimulationgenerate_microdeposits method on resource V2.MoneyManagement.FinancialAddressGeneratedMicrodepositscredit method on resource V2.FinancialAddressCreditSimulationgenerate_microdeposits method on resource V2.FinancialAddressGeneratedMicrodepositsTax.CalculationLineItem.performance_location and TaxCode.requirements.performance_location to be requiredAccount.business_profile.specified_commercial_transactions_act_url to be requiredafter_expiration on BillingPortal.Session and BillingPortal\Session.create().$paramsfundbox_ca_financing on enums Capital.FinancingOffer.disclaimer_variant and Capital.FinancingSummary.details.disclaimer_variantsetup_credential_usage on Charge.payment_method_details.card, PaymentIntent.confirm().$params.payment_method_option.card, PaymentIntent.create().$params.payment_method_option.card, PaymentIntent.payment_method_options.card, PaymentIntent.update().$params.payment_method_option.card, SetupIntent.confirm().$params.payment_method_option.card, SetupIntent.create().$params.payment_method_option.card, SetupIntent.payment_method_options.card, and SetupIntent.update().$params.payment_method_option.cardstored_credential_usage on Charge.payment_method_details.card, PaymentAttemptRecord.payment_method_details.card, PaymentIntent.confirm().$params.payment_method_option.card, PaymentIntent.create().$params.payment_method_option.card, PaymentIntent.payment_method_options.card, PaymentIntent.update().$params.payment_method_option.card, and PaymentRecord.payment_method_details.cardexpires_at on Checkout\Session.create().$params.payment_method_option.blik.mandate_option, Subscription.create().$params.payment_setting.payment_method_option.blik.mandate_option, Subscription.payment_settings.payment_method_options.blik.mandate_options, and Subscription.update().$params.payment_setting.payment_method_option.blik.mandate_optionexpires_after on Checkout\Session.create().$params.payment_method_option.blik.mandate_option, Subscription.create().$params.payment_setting.payment_method_option.blik.mandate_option, Subscription.payment_settings.payment_method_options.blik.mandate_options, and Subscription.update().$params.payment_setting.payment_method_option.blik.mandate_optionpayment_intent_data on Checkout\Session.update().$paramsappeal on Dispute.evidence and Dispute.update().$params.evidencelivemode on FxQuotecapture_method on PaymentIntent.confirm().$params.payment_method_option.paypay, PaymentIntent.create().$params.payment_method_option.paypay, and PaymentIntent.update().$params.payment_method_option.paypayactive on ProductCatalog.TrialOffer, ProductCatalog\TrialOffer.all().$params, and ProductCatalog\TrialOffer.create().$paramsnickname on ProductCatalog.TrialOffer and ProductCatalog\TrialOffer.create().$paramsname on ProductCatalog.TrialOffer and ProductCatalog\TrialOffer.create().$paramsProductCatalog.TrialOffer.end_behavior.transition to be optionalProduct.tax_details to be requiredstatus_details on QuotePreviewInvoicecompany_details and reference on QuotePreviewInvoice.payment_settings.payment_method_options.billiepause_schedules on QuotePreviewSubscriptionScheduledestination on Reserve.Hold, Reserve.Plan, and Reserve.Releasemanual_release on Reserve.Planother on enum Reserve.Plan.statusmanual_release and other on enum Reserve.Plan.typehold_expired on enum Reserve.Release.reasonbulk_hold_expiry from enum Reserve.Release.reasonSubscriptionItem.current_trial to be requiredfinal_payment_failure and first_payment_failure on enum Subscription.status_details.paused.subscription.typeSubscription.trial_settings.end_behavior.billing_cycle_anchor to be requiredigic on enum Tax.Registration.country_options.es.typeTaxCode.requirements to be requiredconfigurations on V2.Core.AccountLink.use_case.account_onboarding, V2.Core.AccountLink.use_case.account_update, V2\Core\AccountLink.create().$params.use_case.account_onboarding, and V2\Core\AccountLink.create().$params.use_case.account_updaterejected on enums V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.aud.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.cad.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.eur.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.gbp.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.usd.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.aud.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.cad.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.eur.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.gbp.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.usd.status, V2.Core.Account.configuration.money_manager.capabilities.inbound_transfers.bank_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.bank_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.cards.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.financial_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.bank_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.financial_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.received_credits.bank_accounts.status, V2.Core.Account.configuration.money_manager.capabilities.received_debits.bank_accounts.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire.status, and V2.Core.Account.configuration.recipient.capabilities.cards.statusrejected_fraud, rejected_incomplete_verification, rejected_listed, rejected_other, rejected_platform_fraud, rejected_platform_other, rejected_platform_terms_of_service, and rejected_terms_of_service on enums V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.aud.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.cad.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.eur.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.gbp.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.usd.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.aud.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.cad.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.eur.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.gbp.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.usd.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.inbound_transfers.bank_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.bank_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.cards.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.financial_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.bank_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.financial_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.received_credits.bank_accounts.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.received_debits.bank_accounts.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire.status_details[].code, and V2.Core.Account.configuration.recipient.capabilities.cards.status_details[].coderelated_object and request on V2.Iam.ActivityLogstripe_action on enum V2.Iam.ActivityLog.actor.typeaccount_security, authentication, scim, sso, and user_profile on V2.Iam.ActivityLog.detailsaccount_security, authentication, issuing, payout, scim, sso, and user_profile on enum V2.Iam.ActivityLog.details.typeanomaly_detection_settings_updated, issuing_activated, issuing_balance_transfer_created, issuing_card_created, issuing_card_sensitive_details_viewed, issuing_card_updated, issuing_cardholder_created, issuing_cardholder_updated, issuing_dispute_created, issuing_dispute_submitted, issuing_dispute_updated, manual_payouts_disabled, manual_payouts_enabled, payout_destination_added, payout_destination_removed, payout_destination_updated, payout_schedule_edits_disabled, payout_schedule_edits_enabled, scim_group_deleted, scim_group_member_added, scim_group_member_removed, scim_group_roles_updated, scim_group_updated, sso_domain_verified, sso_settings_created, sso_settings_deleted, sso_settings_updated, two_step_authentication_mandate_disabled, two_step_authentication_mandate_enabled, user_auth_challenge_failed, user_email_changed, user_email_verified, user_express_phone_number_changed, user_google_account_connected, user_google_account_disconnected, user_passkey_added, user_passkey_removed, user_passkey_updated, user_passkey_upgraded, user_password_changed, user_password_initialized, user_password_reset_failed, user_password_reset_requested, user_password_reset_succeeded, user_two_step_authentication_backup_code_used, user_two_step_authentication_method_added, user_two_step_authentication_method_removed, user_two_step_authentication_method_reset, user_two_step_authentication_method_updated, and user_two_step_authentication_reset_requested on enum V2.Iam.ActivityLog.typedeposit_insurance_eligibility on V2.MoneyManagement.FinancialAccount.storage and V2\MoneyManagement\FinancialAccount.create().$params.storagebank_account on V2.MoneyManagement.FinancialAddress and V2\MoneyManagement\FinancialAddress.create().$paramstype on V2.MoneyManagement.FinancialAddresscredentials and currency on V2.MoneyManagement.FinancialAddresslevel on V2.MoneyManagement.InboundTransfer.transfer_history[]network_fee_details on V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[]network_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].typearchived on V2.MoneyManagement.PayoutMethodarchived on V2.MoneyManagement.PayoutMethod.bank_account and V2.MoneyManagement.PayoutMethod.cardineligible on enum V2.MoneyManagement.PayoutMethod.usage_status.paymentsineligible on enum V2.MoneyManagement.PayoutMethod.usage_status.transfersamount_received on V2.MoneyManagement.ReceivedCreditoriginating_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transferorigin_type on V2.MoneyManagement.ReceivedCredit.bank_transferidentity on V2.Signals.AccountActivity.account_details.data, V2.Signals.AccountEvaluation.account_details.data, V2\Signals\AccountActivity.create().$params.account_detail.datum, and V2\Signals\AccountEvaluation.create().$params.account_detail.datumfraudulent_website on V2.Signals.AccountEvaluation.evaluated_signals and V2.Signals.AccountSignalfraudulent_website on enum V2.Signals.AccountEvaluation.pending_signalsfraudulent_website on enum V2.Signals.AccountEvaluation.requested_signalsfraudulent_merchant on V2.Signals.AccountSignalfraudulent_merchant and fraudulent_website on enum V2.Signals.AccountSignal.typecreated_gt, created_gte, created_lt, and created_lte on V2\MoneyManagement\Adjustment.all().$params, V2\MoneyManagement\InboundTransfer.all().$params, V2\MoneyManagement\ReceivedCredit.all().$params, V2\MoneyManagement\Transaction.all().$params, and V2\MoneyManagement\TransactionEntry.all().$paramsV2\MoneyManagement\Adjustment.all().$params.created, V2\MoneyManagement\InboundTransfer.all().$params.created, V2\MoneyManagement\ReceivedCredit.all().$params.created, V2\MoneyManagement\Transaction.all().$params.created, and V2\MoneyManagement\TransactionEntry.all().$params.created from DateTime to an objectinclude on V2\MoneyManagement\FinancialAddress.all().$params and V2\MoneyManagement\FinancialAddress.retrieve().$paramssettlement_currency on V2\MoneyManagement\FinancialAddress.create().$paramsinclude on V2\MoneyManagement\FinancialAccount.all().$params and V2\MoneyManagement\FinancialAccount.retrieve().$paramstreasury_transaction on EventsV2MoneyManagementTransactionUpdatedEventV2SignalsAccountSignalFraudulentMerchantReadyEvent and V2SignalsAccountSignalFraudulentWebsiteReadyEvent with related object V2.Signals.AccountSignalInvalidVaultedCredentialException, VerificationAttemptFailedException, VerificationExpiredException, and VerificationNotInitiatedExceptionControlledByDashboardExceptiondispute_evidence_page_limit_exceeded, financial_connections_consent_locale_invalid, financial_connections_consent_locale_unsupported, and payment_evaluation_on_api_version_not_supported on QuotePreviewInvoice.last_finalization_errorSee the changelog for the full release notes.
See the changelog for the full release notes.
Risk.Form and V2.Data.SearchResultListretrieve and update methods on resource Risk.Formsearch method on resource V2.Data.SearchResultListbusiness_profile_management and reporting_chart on AccountSession.componentsAccountSession.components.terminal_hardware_orders from nullable(ConnectEmbeddedBaseConfig) to ConnectEmbeddedBaseConfigAccountSession.components.terminal_hardware_shop from nullable(ConnectEmbeddedBaseConfig) to ConnectEmbeddedBaseConfigAccountSession.components.terminal_hardware_orders to be requiredAccountSession.components.terminal_hardware_shop to be requiredsubscription_pause on BillingPortal.Configuration.featuresBillingPortal.Session.flow.subscription_pause to be requiredmandiri on enums Charge.payment_method_details.id_bank_transfer.bank, ConfirmationToken.payment_method_preview.id_bank_transfer.bank, PaymentAttemptRecord.payment_method_details.id_bank_transfer.bank, PaymentMethod.id_bank_transfer.bank, PaymentRecord.payment_method_details.id_bank_transfer.bank, and SetupAttempt.payment_method_details.id_bank_transfer.bankmarketing_attributions on Checkout.Session and Checkout\Session.create().$paramsmetronome_commit on Checkout.Session.items[] and Checkout\Session.create().$params.itemadjustable_quantity on Checkout\Session.create().$params.item.subscription.itemau_acn, au_wpn, cz_dic, fr_siren, fr_siret, fr_spi, is_kt, md_cf, mu_vat, mz_nuit, nz_bn, pt_nif, sm_coe, tt_bir, and tt_vat on enums Checkout.Session.collected_information.tax_id.type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, and Tax.Transaction.customer_details.tax_ids[].typemetronome_commit on enum Checkout.Session.items[].typemandate_options on Checkout.Session.payment_method_options.cardDispute.evidence.appeal from DisputeAppeal to nullable(DisputeAppeal)Dispute.evidence_details.submission_method to be requireddetails on Identity.VerificationReport.emailemail from enums Identity.VerificationReport.type and Identity.VerificationSession.typemerchant_amount_exchange_rate on Issuing\Authorization.capture().$params, Issuing\Authorization.create().$params, and Issuing\Transaction.create_force_capture().$paramstype on Issuing.Authorization and Issuing\Authorization.create().$paramssettlement_details on Issuing\Authorization.capture().$params and Issuing\Transaction.create_force_capture().$paramshealthcare on Issuing\Authorization.capture().$params.purchase_detail, Issuing\Transaction.create_force_capture().$params.purchase_detail, and Issuing\Transaction.create_unlinked_refund().$params.purchase_detailproduct_eligibility_inquiry on Issuing.Authorizationaccount_tax_ids, custom_fields, description, and footer on PaymentLink.subscription_data.invoice_settingsRadar.PaymentEvaluation.signals.early_fraud_warning from nullable(Payment Evaluation Signal) to Payment Evaluation SignalRadar.PaymentEvaluation.signals.early_fraud_warning to be optionalreference_status and reference on Refund.destination_details.afterpay_clearpay, Refund.destination_details.klarna, and Refund.destination_details.paypalbw, ci, gh, and mu on Tax.Registration.country_optionsaccount_takeover on enum V2.Core.AccountEvaluation.evaluations_triggeredczk, nok, pln, and sek on V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound, V2\Core\Account.create().$params.configuration.money_manager.capability.business_storage.inbound, V2\Core\Account.create().$params.configuration.money_manager.capability.business_storage.outbound, V2\Core\Account.update().$params.configuration.money_manager.capability.business_storage.inbound, and V2\Core\Account.update().$params.configuration.money_manager.capability.business_storage.outboundstablecoin_custodial on V2.Core.Account.configuration.recipient.capabilities.stripe_balance, V2\Core\Account.create().$params.configuration.recipient.capability.stripe_balance, and V2\Core\Account.update().$params.configuration.recipient.capability.stripe_balancestripe_balance.stablecoin_custodial on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilityaccount_takeover_confirmation, account_takeover_report, credential_change, mfa_addition, and mfa_removal on V2.Signals.AccountActivity, V2\Signals\AccountActivity.create().$params, and V2\Signals\AccountEvaluation.create().$params.account_activity_detail.datumaccount_takeover_confirmation, account_takeover_mitigation, account_takeover_report, credential_change, mfa_addition, and mfa_removal on enum V2.Signals.AccountActivity.typeaccount_takeover on V2.Signals.AccountEvaluation.evaluated_signals and V2.Signals.AccountSignalaccount_takeover on enum V2.Signals.AccountEvaluation.pending_signalsaccount_takeover on enum V2.Signals.AccountEvaluation.requested_signalscustomer_risk on V2.Signals.AccountSignalaccount_takeover and customer_risk on enum V2.Signals.AccountSignal.typebusiness_storage.inbound.czk, business_storage.inbound.nok, business_storage.inbound.pln, business_storage.inbound.sek, business_storage.outbound.czk, business_storage.outbound.nok, business_storage.outbound.pln, and business_storage.outbound.sek on enum EventsV2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent.updated_capabilitystripe_balance.stablecoin_custodial on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityV2SignalsAccountSignalCustomerRiskReadyEvent with related object V2.Signals.AccountSignalSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-10-14.preview.
capture method on resource V2.Payments.OffSessionPaymentacknowledge_confirmation_of_payee and initiate_confirmation_of_payee methods on resource V2.Core.Vault.GbBankAccountwechat_pay_mobile_web_payments on Account.create().$params.setting, Account.settings, and Account.update().$params.settingwechat_pay_payments on Account.create().$params.setting, Account.settings, and Account.update().$params.settingsettlement_reserved on BalanceBalanceSettings.payments.default_settlement_currency from nullable(string) to stringsettlement_reserved on enum BalanceTransaction.balance_typecarecredit, getflex, and sezzle on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datumrakuten_pay on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_datum, PaymentMethod.create().$params, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datummandate_options on Checkout\Session.create().$params.payment_method_option.cardauto on enum Checkout.Session.payment_method_collectionCheckout.Session.items[].subscription.backdate_start_date to be requiredcarecredit, getflex, rakuten_pay, and sezzle on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typethree_d_secure.authentication.canceled, three_d_secure.authentication.challenge_started, three_d_secure.authentication.errored, three_d_secure.authentication.failed, three_d_secure.authentication.requires_challenge, three_d_secure.authentication.requires_submission, and three_d_secure.authentication.succeeded on enum Event.typefraudulent_document on Identity.VerificationReport.signalscarecredit, getflex, rakuten_pay, and sezzle on enums PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_typescarecredit, getflex, rakuten_pay, and sezzle on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typescontact_email on V2.Core.AccountEvaluation.account_data, V2.Signals.AccountActivity.account_details.data, V2.Signals.AccountEvaluation.account_details.data, V2\Core\AccountEvaluation.create().$params.account_datum, V2\Signals\AccountActivity.create().$params.account_detail.datum, and V2\Signals\AccountEvaluation.create().$params.account_detail.datumuser_merchant_fit on enum V2.Core.AccountEvaluation.evaluations_triggeredV2.Core.Account.identity.individual.additional_addresses[].purpose and V2.Core.AccountPerson.additional_addresses[].purpose from literal('registered') to enum('birthplace'|'registered')bre_b, nip, and pix on V2.MoneyManagement.FinancialAddress.bank_account and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_accountousd on enum V2.MoneyManagement.FinancialAddress.crypto_wallet.supported_network_details.value.supported_token_currenciesbre_b, nip, and pix on enum V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.typeamount_capturable on V2.Payments.OffSessionPaymentcapture on V2.Payments.OffSessionPayment and V2\Payments\OffSessionPayment.create().$paramsuser_merchant_fit on V2.Signals.AccountEvaluation.evaluated_signals and V2.Signals.AccountSignaluser_merchant_fit on enum V2.Signals.AccountEvaluation.pending_signalsuser_merchant_fit on enum V2.Signals.AccountEvaluation.requested_signalsuser_merchant_fit on enum V2.Signals.AccountSignal.typeV2\Core\Account.create().$params.identity.individual.additional_address.purpose, V2\Core\Account.update().$params.identity.individual.additional_address.purpose, V2\Core\AccountPerson.create().$params.additional_address.purpose, V2\Core\AccountPerson.update().$params.additional_address.purpose, V2\Core\AccountPersonToken.create().$params.additional_address.purpose, and V2\Core\AccountToken.create().$params.identity.individual.additional_address.purpose from literal('registered') to enum('birthplace'|'registered')THREE_D_SECURE_AUTHENTICATION_CANCELED, THREE_D_SECURE_AUTHENTICATION_CHALLENGE_STARTED, THREE_D_SECURE_AUTHENTICATION_ERRORED, THREE_D_SECURE_AUTHENTICATION_FAILED, THREE_D_SECURE_AUTHENTICATION_REQUIRES_CHALLENGE, THREE_D_SECURE_AUTHENTICATION_REQUIRES_SUBMISSION, and THREE_D_SECURE_AUTHENTICATION_SUCCEEDED with resource ThreeDSecure.AuthenticationV2PaymentsOffSessionPaymentRequiresCaptureEvent with related object V2.Payments.OffSessionPaymentSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-10-07.preview.
Radar.Rule, V2.MoneyManagement.FundingSession, and V2.MoneyManagement.InboundTransferMandateall, cancel, create, and retrieve methods on resource V2.MoneyManagement.InboundTransferMandatecreate method on resource V2.MoneyManagement.FundingSessionexcluded_payout_destinations on Account.update().$params.setting.capitalwero_payments on Account.capabilitiesCharge.outcome.rule from RadarRule to $Radar.Ruleousd on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currencylocation and reader on Charge.payment_method_details.swish, PaymentAttemptRecord.payment_method_details.swish, and PaymentRecord.payment_method_details.swishpayment_settings on Checkout.Session and Checkout\Session.create().$paramson_behalf_of on Checkout.Sessionfednow and rtp on enum CustomerCashBalanceTransaction.funded.bank_transfer.us_bank_transfer.networkflexible_credential on Issuing.Authorizationfuels on Issuing.Transaction.purchase_detailsus_bank_account on PaymentAttemptRecord.report_failed().$params.payment_method_detail, PaymentRecord.report_payment().$params.payment_method_detail, PaymentRecord.report_payment_attempt().$params.payment_method_detail, PaymentRecord.report_payment_attempt_failed().$params.payment_method_detail, Radar.PaymentEvaluation.payment_details.money_movement_details, and Radar\PaymentEvaluation.create().$params.payment_detail.money_movement_detailPaymentAttemptRecord.report_failed().$params.payment_method_detail.type and PaymentRecord.report_payment_attempt_failed().$params.payment_method_detail.type from literal('card') to enum('card'|'us_bank_account')fleet on PaymentIntent.confirm().$params.payment_method_option.card_present, PaymentIntent.create().$params.payment_method_option.card_present, PaymentIntent.payment_method_options.card_present, and PaymentIntent.update().$params.payment_method_option.card_presentsubscription_reference on PaymentIntent.confirm().$params.payment_method_option.paypay, PaymentIntent.create().$params.payment_method_option.paypay, PaymentIntent.payment_method_options.paypay, and PaymentIntent.update().$params.payment_method_option.paypayenablement_details on QuotePreviewSubscriptionSchedule.default_settings.automatic_tax, QuotePreviewSubscriptionSchedule.phases[].automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_taxRadar\PaymentEvaluation.create().$params.payment_detail.money_movement_detail.money_movement_type from literal('card') to enum('card'|'us_bank_account')rules on Radar.PaymentEvaluationRadar.PaymentEvaluation.payment_details.money_movement_details.money_movement_type from literal('card') to enum('card'|'us_bank_account')request_three_d_secure and reroute on enum Radar.PaymentEvaluation.recommended_actionbank_initiated_return on Radar.PaymentEvaluation.signalshour on enums SharedPayment.GrantedToken.usage_limits.recurring.interval and SharedPayment.IssuedToken.usage_limits.recurring.intervalutility_users_tax on Tax.Registration.country_options.usdigital_excise_tax and utility_users_tax on enum Tax.Registration.country_options.us.typeenable_customer_cancellation on Terminal\Reader.activate_gift_card().$params, Terminal\Reader.cashout_gift_card().$params, Terminal\Reader.check_gift_card_balance().$params, and Terminal\Reader.reload_gift_card().$paramsvipps_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilitybusiness_custodial_storage on V2.Core.Account.configuration.money_manager.capabilities, V2\Core\Account.create().$params.configuration.money_manager.capability, and V2\Core\Account.update().$params.configuration.money_manager.capabilityofframp and onramp on V2.Core.Account.configuration.money_manager.capabilities.outbound_payments, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers, V2.Core.Account.configuration.money_manager.capabilities.received_credits, V2\Core\Account.create().$params.configuration.money_manager.capability.outbound_payment, V2\Core\Account.create().$params.configuration.money_manager.capability.outbound_transfer, V2\Core\Account.create().$params.configuration.money_manager.capability.received_credit, V2\Core\Account.update().$params.configuration.money_manager.capability.outbound_payment, V2\Core\Account.update().$params.configuration.money_manager.capability.outbound_transfer, and V2\Core\Account.update().$params.configuration.money_manager.capability.received_creditpix on V2.Core.Account.configuration.recipient.capabilities, V2.MoneyManagement.PayoutMethod, V2\Core\Account.create().$params.configuration.recipient.capability, V2\Core\Account.update().$params.configuration.recipient.capability, and V2\MoneyManagement\OutboundSetupIntent.create().$params.payout_method_datumpix on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typepix and vipps_payments on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilityaccount on V2.MoneyManagement.FinancialAddress, V2\MoneyManagement\FinancialAddress.all().$params, and V2\MoneyManagement\FinancialAddress.create().$paramsbre_b, nip, and pix on enum V2.MoneyManagement.FinancialAddress.bank_account.typesupported_network_details on V2.MoneyManagement.FinancialAddress.crypto_walletbitcoin on enums V2.MoneyManagement.FinancialAddress.crypto_wallet.network and V2.MoneyManagement.ReceivedCredit.crypto_wallet_transfer.crypto_wallet.networknetwork_details on V2.MoneyManagement.InboundTransfer and V2\MoneyManagement\InboundTransfer.create().$paramsbacs_debit on V2.MoneyManagement.InboundTransfer.from.payment_methodpix on enum V2.MoneyManagement.PayoutMethod.typebic on V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.aba and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.sort_codeoriginating_crypto_wallet, token_currency, and transaction_hash on V2.MoneyManagement.ReceivedCredit.crypto_wallet_transferinvoices on V2.Tax.IntegrationConfiguration and V2\Tax\IntegrationConfiguration.update().$paramsaccount on V2\Risk\Inquiry.all().$paramscustomer and subscription on EventsV1InvoiceUpcomingEventvipps_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilitybusiness_custodial_storage.inbound.ousd, business_custodial_storage.inbound.usdc, business_custodial_storage.outbound.ousd, business_custodial_storage.outbound.usdc, outbound_payments.offramp.bank_accounts.brl, outbound_payments.offramp.bank_accounts.cop, outbound_payments.offramp.bank_accounts.eur, outbound_payments.offramp.bank_accounts.gbp, outbound_payments.offramp.bank_accounts.mxn, outbound_payments.offramp.bank_accounts.usd, outbound_payments.onramp.crypto_wallets.brl, outbound_payments.onramp.crypto_wallets.cop, outbound_payments.onramp.crypto_wallets.eur, outbound_payments.onramp.crypto_wallets.gbp, outbound_payments.onramp.crypto_wallets.mxn, outbound_payments.onramp.crypto_wallets.usd, outbound_transfers.offramp.bank_accounts.brl, outbound_transfers.offramp.bank_accounts.cop, outbound_transfers.offramp.bank_accounts.eur, outbound_transfers.offramp.bank_accounts.gbp, outbound_transfers.offramp.bank_accounts.mxn, outbound_transfers.offramp.bank_accounts.usd, outbound_transfers.onramp.crypto_wallets.brl, outbound_transfers.onramp.crypto_wallets.cop, outbound_transfers.onramp.crypto_wallets.eur, outbound_transfers.onramp.crypto_wallets.gbp, outbound_transfers.onramp.crypto_wallets.mxn, outbound_transfers.onramp.crypto_wallets.usd, received_credits.offramp.bank_accounts.brl, received_credits.offramp.bank_accounts.cop, received_credits.offramp.bank_accounts.eur, received_credits.offramp.bank_accounts.gbp, received_credits.offramp.bank_accounts.mxn, received_credits.offramp.bank_accounts.usd, received_credits.onramp.crypto_wallets.brl, received_credits.onramp.crypto_wallets.cop, received_credits.onramp.crypto_wallets.eur, received_credits.onramp.crypto_wallets.gbp, received_credits.onramp.crypto_wallets.mxn, and received_credits.onramp.crypto_wallets.usd on enum EventsV2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent.updated_capabilitypix on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityV2MoneyManagementInboundTransferMandateActivatedEvent, V2MoneyManagementInboundTransferMandateCreatedEvent, V2MoneyManagementInboundTransferMandateExpiredEvent, V2MoneyManagementInboundTransferMandateRefusedEvent, and V2MoneyManagementInboundTransferMandateRevokedEvent with related object V2.MoneyManagement.InboundTransferMandateSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-09-30.preview.
V2.Data.QueryRun, V2.Data.ReportRun, V2.Data.Report, V2.Data.Schema, V2.MoneyManagement.EarnedCreditSimulation, V2.MoneyManagement.EarnedCredit, and V2.Provisioning.ResourceAccessConfigurationearned_credits method on resource V2.MoneyManagement.EarnedCreditSimulationall and retrieve methods on resources V2.Data.Report, V2.Data.Schema, and V2.MoneyManagement.EarnedCreditcreate and retrieve methods on resources V2.Data.QueryRun and V2.Data.ReportRunreveal_access_configuration method on resource V2.Provisioning.Resourcerefresh_regulatory_receipt method on resource V2.MoneyManagement.Transactioncapital_financing_manual_payment on AccountSession.create().$params.componentauthorized_content_security_policy, authorized_endpoints, authorized_permissions, and state on Apps.InstallApps.Install.channel from string to enumApps.Install.content_security_policy_granted from nullable(AppServiceResourceInstallContentSecurityPolicy) to AppServiceResourceInstallContentSecurityPolicyApps.Install.endpoints_granted from nullable(array(string)) to array(string)Apps.Install.permissions_granted from nullable(array(string)) to array(string)Apps.Install.status from nullable(enum) to enumfinancing_documents on Capital.FinancingOfferenabled_payment_types and overdue_amount on Capital.FinancingSummary.detailscard_account_update on Charge.payment_method_details.cardon_behalf_of on Checkout\Session.create().$paramsbilling_cycle_anchor on Checkout.Session.items[].subscription.trial_settings.end_behavior, Checkout\Session.create().$params.item.subscription.trial_setting.end_behavior, Checkout\Session.create().$params.subscription_datum.trial_setting.end_behavior, PaymentLink.create().$params.subscription_datum.trial_setting.end_behavior, PaymentLink.subscription_data.trial_settings.end_behavior, and PaymentLink.update().$params.subscription_datum.trial_setting.end_behaviorpayment_method_preselect on Checkout.Session.saved_payment_method_options and Checkout\Session.create().$params.saved_payment_method_optiones on CustomerTaxExemption.create().$params and CustomerTaxExemptionfinancial_activity on FinancialConnections.Transaction.classifications[]enablement_details on Invoice.automatic_tax and QuotePreviewInvoice.automatic_taxsquads on enum Issuing.Card.crypto_wallet.typereturn_code on PaymentAttemptRecord.payment_method_details.us_bank_account and PaymentRecord.payment_method_details.us_bank_accountrequest_card_account_update on PaymentIntent.confirm().$params.payment_method_option.card, PaymentIntent.create().$params.payment_method_option.card, PaymentIntent.payment_method_options.card, and PaymentIntent.update().$params.payment_method_option.cardname on ProductCatalog.TrialOfferRadar.PaymentEvaluation.signals.early_fraud_warning.score and Radar.PaymentEvaluation.signals.fraudulent_dispute.score from number to nullable(number)status on Tax.Form and Tax\Form.all().$paramscard_not_present_transactions, gross_amount_of_transactions_decimal, monthly_volumes, payment_transactions_count, and state_income_tax_withheld on Tax.Form.us_1099_kcash_tips, currency, and federal_income_tax_withheld on Tax.Form.us_1099_k, Tax.Form.us_1099_misc, and Tax.Form.us_1099_neccrop_insurance_proceeds, direct_sales_for_resale, excess_golden_parachute_payments, fatca_filing_required, fish_purchased_for_resale, fishing_boat_proceeds, gross_proceeds_paid_to_an_attorney, medical_and_health_care_payments, nonqualified_deferred_compensation, other_income, rents, royalties, section_409a_deferrals, and substitute_payments on Tax.Form.us_1099_miscovertime_compensation, state_income, and state_tax_withheld on Tax.Form.us_1099_misc and Tax.Form.us_1099_necdirect_sales_indicator, fatca_filing_requirement, and nonemployee_compensation on Tax.Form.us_1099_nectamper_state on Terminal\Reader.all().$paramsconfigurations on V2.Core.AccountLink.use_case.recipient_onboarding, V2.Core.AccountLink.use_case.recipient_update, V2\Core\AccountLink.create().$params.use_case.recipient_onboarding, and V2\Core\AccountLink.create().$params.use_case.recipient_updaterejected on enums V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.fifth_third.charge_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card.status, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.spend_card.status, V2.Core.Account.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card.status, V2.Core.Account.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card.status, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.debit_card.status, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.prepaid_card.status, V2.Core.Account.configuration.developer.capabilities.projects.status, V2.Core.Account.configuration.merchant.capabilities.blik_recurring_payments.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.usdc.status, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.usdc.status, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.inbound.usd.status, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.inbound.usdc.status, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.outbound.usd.status, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.outbound.usdc.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.crypto_wallets.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.paper_checks.status, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.crypto_wallets.status, V2.Core.Account.configuration.money_manager.capabilities.received_credits.crypto_wallets.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.ach.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.becs.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.eft.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.fedwire.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.fps.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.instant.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.npp.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.rtp.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.sepa_credit.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.sepa_instant.status, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.swift.status, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets.status, and V2.Core.Account.configuration.recipient.capabilities.paper_checks.statusrejected_fraud, rejected_incomplete_verification, rejected_listed, rejected_other, rejected_platform_fraud, rejected_platform_other, rejected_platform_terms_of_service, and rejected_terms_of_service on enums V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.fifth_third.charge_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.spend_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.consumer.celtic.revolving_credit_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.consumer.cross_river_bank.prepaid_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.debit_card.status_details[].code, V2.Core.Account.configuration.card_creator.capabilities.consumer.lead.prepaid_card.status_details[].code, V2.Core.Account.configuration.developer.capabilities.projects.status_details[].code, V2.Core.Account.configuration.merchant.capabilities.blik_recurring_payments.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound.usdc.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound.usdc.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.inbound.usd.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.inbound.usdc.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.outbound.usd.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.consumer_storage.outbound.usdc.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.crypto_wallets.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_payments.paper_checks.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.outbound_transfers.crypto_wallets.status_details[].code, V2.Core.Account.configuration.money_manager.capabilities.received_credits.crypto_wallets.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.ach.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.becs.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.eft.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.fedwire.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.fps.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.instant.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.npp.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.rtp.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.sepa_credit.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.sepa_instant.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.swift.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets.status_details[].code, and V2.Core.Account.configuration.recipient.capabilities.paper_checks.status_details[].codeousd on V2.Core.Account.configuration.money_manager.capabilities.business_storage.inbound, V2.Core.Account.configuration.money_manager.capabilities.business_storage.outbound, V2\Core\Account.create().$params.configuration.money_manager.capability.business_storage.inbound, V2\Core\Account.create().$params.configuration.money_manager.capability.business_storage.outbound, V2\Core\Account.update().$params.configuration.money_manager.capability.business_storage.inbound, and V2\Core\Account.update().$params.configuration.money_manager.capability.business_storage.outboundorigin on V2.Core.Vault.NetworkTokenaccount_security, authentication, issuing, payout, scim, sso, and user_profile on enum V2.Iam.ActivityLog.details.typebic on V2.MoneyManagement.FinancialAddress.bank_account.aba, V2.MoneyManagement.FinancialAddress.bank_account.cpa, V2.MoneyManagement.FinancialAddress.bank_account.iban, and V2.MoneyManagement.FinancialAddress.bank_account.sort_codeiban on V2.MoneyManagement.FinancialAddress.bank_account.sort_codestatement_descriptor on V2.MoneyManagement.InboundTransfer and V2\MoneyManagement\InboundTransfer.create().$paramsnetwork_fee_details on V2.MoneyManagement.PayoutIntent.estimated_fees[]network_fee on enum V2.MoneyManagement.PayoutIntent.estimated_fees[].typearchived on V2.MoneyManagement.PayoutMethod.crypto_walletswift on enums V2.MoneyManagement.ReceivedCredit.bank_transfer.ca_bank_account.network and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.cpa.networkswift on enums V2.MoneyManagement.ReceivedCredit.bank_transfer.gb_bank_account.network and V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.sort_code.networkswift on enums V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.aba.network and V2.MoneyManagement.ReceivedCredit.bank_transfer.us_bank_account.networkswift on enums V2.MoneyManagement.ReceivedCredit.bank_transfer.originating_bank_account.iban.network and V2.MoneyManagement.ReceivedCredit.bank_transfer.sepa_bank_account.networknetwork_details on V2.MoneyManagement.ReceivedDebit.bank_transferearned_credit on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryearned_credit on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowearned_credit on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typeregulatory_receipt on V2.MoneyManagement.Transactionretry_until on V2.Payments.OffSessionPayment.retry_detailscvc on V2\Payments\OffSessionPayment.create().$params.payment_method_datum.cardfrom_resource on V2\MoneyManagement\OutboundSetupIntent.create().$paramsV2\Core\Vault\NetworkToken.create().$params.card.origin and V2\Core\Vault\NetworkToken.create_from_credential().$params.card.origin from literal('card_on_file') to enum('card_on_file'|'wallet')V2\Core\Vault\NetworkToken.create().$params.type and V2\Core\Vault\NetworkToken.create_from_credential().$params.type from literal('card') to enum('card')V2\Core\Vault\NetworkToken.generate_cryptogram().$params.type from literal('token_cryptogram') to enum('token_cryptogram')V2\Billing\Contract.create().$params.pricing_line.pricing.price_detail.pricing_override.overwrite_price.unit_amount, V2\Billing\Contract.update().$params.pricing_line_action.add.pricing.price_detail.pricing_override.overwrite_price.unit_amount, and V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.add.overwrite_price.unit_amount from string to decimal_stringV2\Billing\Contract.create().$params.pricing_override.multiply_pricing.factor from string to decimal_stringbilling_settings on V2\Billing\Contract.update().$paramsbusiness_storage.inbound.ousd and business_storage.outbound.ousd on enum EventsV2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent.updated_capabilityaccount, evaluated_at, fraudulent_merchant, and type on EventsV2SignalsAccountSignalFraudulentMerchantReadyEventV2DataQueryRunCreatedEvent, V2DataQueryRunFailedEvent, V2DataQueryRunSucceededEvent, and V2DataQueryRunUpdatedEvent with related object V2.Data.QueryRunV2DataReportRunCreatedEvent, V2DataReportRunFailedEvent, V2DataReportRunSucceededEvent, and V2DataReportRunUpdatedEvent with related object V2.Data.ReportRunV2MoneyManagementEarnedCreditSucceededEvent with related object V2.MoneyManagement.EarnedCreditReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
See the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-09-30.endive.
#2144 Support EventNotifications with singleton related objects
⚠️ #2148 Expand PHPDoc union parameter shapes
array type. This change affects documentation and static analysis only, but may produce new PHPStan or IDE diagnostics for arrays that do not match the documented types.#2149 Allow suppressing Stripe notices
Set the STRIPE_SUPPRESS_NOTICES environment variable to true to suppress Stripe notices in test and sandbox environments when not running under a detected AI agent. Notices remain enabled by default and continue to be shown to AI agents.
#2151 Fix account scoping for event notification handler callback clients
⚠️ Drop support for PHP 7.2 and 7.3
⚠️ #2140 Update generated code
Apps.Install, ProductCatalog.TrialOffer, Tax.Location, and ThreeDSecure.Authenticationall, create, retrieve, uninstall, and update methods on resource Apps.Installall, create, retrieve, and update methods on resource ProductCatalog.TrialOfferall, create, and retrieve methods on resource Tax.Locationall, cancel, create, retrieve, and submit methods on resource ThreeDSecure.Authenticationpause method on resource Subscriptioninvalid_address_cmra_address and invalid_address_registered_agent_address on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codeperformance_location on Tax.CalculationLineItem and Tax\Calculation.create().$params.line_itemperformance on enums Tax.Calculation.shipping_cost.tax_breakdown[].sourcing, Tax.CalculationLineItem.tax_breakdown[].sourcing, and Tax.Transaction.shipping_cost.tax_breakdown[].sourcingadmissions_tax, attendance_tax, digital_excise_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, recycling_fee, resort_tax, tourism_tax, and utility_users_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typedestination on Reserve.Hold, Reserve.Plan, and Reserve.Releasemanual_release on Reserve.Planother on enum Reserve.Plan.statusmanual_release and other on enum Reserve.Plan.typehold_expired on enum Reserve.Release.reasonbulk_hold_expiry from enum Reserve.Release.reasonspecified_commercial_transactions_act_url on Account.business_profile, Account.create().$params.business_profile, and Account.update().$params.business_profileblik_recurring_payments and sequra_payments on Account.capabilities, Account.create().$params.capability, Account.update().$params.capability, V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilitypaypay_payments on Account.capabilities, Account.create().$params.capability, Account.create().$params.setting, Account.settings, Account.update().$params.capability, and Account.update().$params.settingsepa_debit_payments on Account.create().$params.setting, V2\Core\Account.create().$params.configuration.merchant, and V2\Core\Account.update().$params.configuration.merchantissuing_dispute_provisional_credit_reversal and issuing_dispute_provisional_credit on enum BalanceTransaction.typepaypay on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datumsequra on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout\Session.create().$params.payment_method_option, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datumelectronic_commerce_indicator on Charge.payment_method_details.cardCharge.payment_method_details.card.mandate from string to expandable($Mandate)allowed_payment_method_types on Checkout.Session and Checkout\Session.create().$paramspayment_method_types on Checkout\Session.create().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, SetupIntent.create().$params, and SetupIntent.update().$paramstax_details on Checkout\Session.create().$params.line_item.price_datum.product_datum, Checkout\Session.update().$params.line_item.price_datum.product_datum, Invoice.add_lines().$params.line.price_datum.product_datum, Invoice.update_lines().$params.line.price_datum.product_datum, InvoiceLineItem.update().$params.price_datum.product_datum, PaymentLink.create().$params.line_item.price_datum.product_datum, Plan.create().$params.product, Price.create().$params.product_datum, Product.create().$params, Product.update().$params, and Productblik on Checkout\Session.create().$params.payment_method_option, Invoice.create().$params.payment_setting.payment_method_option, Invoice.payment_settings.payment_method_options, Invoice.update().$params.payment_setting.payment_method_option, Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_option, Subscription.create().$params.payment_setting.payment_method_option, Subscription.payment_settings.payment_method_options, and Subscription.update().$params.payment_setting.payment_method_optionCheckout\Session.create().$params.payment_method_option.bancontact.setup_future_usage, PaymentIntent.confirm().$params.payment_method_option.blik.setup_future_usage, PaymentIntent.create().$params.payment_method_option.blik.setup_future_usage, and PaymentIntent.update().$params.payment_method_option.blik.setup_future_usage from literal('none') to enum('none'|'off_session')Checkout.Session.payment_method_options.bancontact.setup_future_usage and PaymentIntent.payment_method_options.blik.setup_future_usage from literal('none') to enum('none'|'off_session')paypay and sequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeapps.install.created, apps.install.deleted, and apps.install.updated on enum Event.typeexpired and pending on enum FinancialConnections.Account.account_numbers[].statuscountry on FinancialConnections\Session.create().$params.filtercountries on FinancialConnections.Session.filters and FinancialConnections\Session.create().$params.filterinvoicing_rules on InvoiceItem.update().$params and InvoiceItemcompany_details on Invoice.create().$params.payment_setting.payment_method_option.billie, Invoice.payment_settings.payment_method_options.billie, Invoice.update().$params.payment_setting.payment_method_option.billie, PaymentIntent.confirm().$params.payment_method_option.billie, PaymentIntent.create().$params.payment_method_option.billie, PaymentIntent.payment_method_options.billie, PaymentIntent.update().$params.payment_method_option.billie, Subscription.create().$params.payment_setting.payment_method_option.billie, Subscription.payment_settings.payment_method_options.billie, and Subscription.update().$params.payment_setting.payment_method_option.billiereference on Invoice.create().$params.payment_setting.payment_method_option.billie, Invoice.payment_settings.payment_method_options.billie, Invoice.update().$params.payment_setting.payment_method_option.billie, PaymentIntent.confirm().$params.payment_method_option.billie, PaymentIntent.create().$params.payment_method_option.billie, PaymentIntent.payment_method_options.billie, and PaymentIntent.update().$params.payment_method_option.billiepause on Invoice.create_preview().$params.subscription_detailInvoice.create_preview().$params.subscription_detail.billing_cycle_anchor from enum('now'|'unchanged') | DateTime to billing_cycle_anchor_paramcurrent_trial on Invoice.create_preview().$params.subscription_detail.item, Subscription.create().$params.item, Subscription.update().$params.item, SubscriptionItem.create().$params, SubscriptionItem.update().$params, and SubscriptionItemstatus_details on Invoice and Subscriptionblik on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typesindia on Mandate.payment_method_details.cardmomo on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details2.3.0 and 2.3.1 on enums PaymentAttemptRecord.payment_method_details.card.three_d_secure.version and PaymentRecord.payment_method_details.card.three_d_secure.versionlink on PaymentAttemptRecord.payment_method_details.card.wallet and PaymentRecord.payment_method_details.card.walletfunding_source_group on PaymentAttemptRecord.payment_method_details.link and PaymentRecord.payment_method_details.linkmandate_options on PaymentIntent.confirm().$params.payment_method_option.blik, PaymentIntent.create().$params.payment_method_option.blik, PaymentIntent.payment_method_options.blik, and PaymentIntent.update().$params.payment_method_option.blikpayment_record on PaymentIntentcard_present and interac_present on enums PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_typespaypay and sequra on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesexpires_at on PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_codepaypay and sequra on enum PaymentLink.payment_method_typespayto on PaymentMethod.update().$paramscanceled on PaymentRecord.report_payment().$params and PaymentRecord.report_payment_attempt().$paramsrerouted on enum Radar.PaymentEvaluation.outcome.typeearly_fraud_warning and fraudulent_dispute on Radar.PaymentEvaluation.signalsRadar.PaymentEvaluation.signals.fraudulent_payment.score from number to nullable(number)pause_schedules on SubscriptionSchedule.create().$params, SubscriptionSchedule.update().$params, and SubscriptionScheduleSubscription.resume().$params.billing_cycle_anchor and Subscription.update().$params.billing_cycle_anchor from enum('now'|'unchanged') to billing_cycle_anchor_parambilling_cycle_anchor on Subscription.create().$params.trial_setting.end_behavior, Subscription.trial_settings.end_behavior, and Subscription.update().$params.trial_setting.end_behaviorSubscription.create().$params.trial_setting.end_behavior.missing_payment_method and Subscription.update().$params.trial_setting.end_behavior.missing_payment_method to be optionalpayment_behavior on Subscription.resume().$paramscancel_at_period_end on Subscription.pending_updateigic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, Tax.Registration.country_options.sk, Tax\Registration.create().$params.country_option.at, Tax\Registration.create().$params.country_option.be, Tax\Registration.create().$params.country_option.bg, Tax\Registration.create().$params.country_option.cy, Tax\Registration.create().$params.country_option.cz, Tax\Registration.create().$params.country_option.de, Tax\Registration.create().$params.country_option.dk, Tax\Registration.create().$params.country_option.e, Tax\Registration.create().$params.country_option.ee, Tax\Registration.create().$params.country_option.fi, Tax\Registration.create().$params.country_option.fr, Tax\Registration.create().$params.country_option.gr, Tax\Registration.create().$params.country_option.hr, Tax\Registration.create().$params.country_option.hu, Tax\Registration.create().$params.country_option.ie, Tax\Registration.create().$params.country_option.it, Tax\Registration.create().$params.country_option.lt, Tax\Registration.create().$params.country_option.lu, Tax\Registration.create().$params.country_option.lv, Tax\Registration.create().$params.country_option.mt, Tax\Registration.create().$params.country_option.nl, Tax\Registration.create().$params.country_option.pl, Tax\Registration.create().$params.country_option.pt, Tax\Registration.create().$params.country_option.ro, Tax\Registration.create().$params.country_option.se, Tax\Registration.create().$params.country_option.si, and Tax\Registration.create().$params.country_option.skadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.country_options.us and Tax\Registration.create().$params.country_option.meadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enum Tax.Registration.country_options.us.typerequirements on TaxCodedigital_excise_tax and utility_users_tax on enum TaxRate.tax_typertp on enum Treasury.FinancialAccount.financial_addresses[].supported_networksrtp on enum Treasury.ReceivedCredit.networkconfigurations on V2.Core.AccountLink.use_case.account_onboarding, V2.Core.AccountLink.use_case.account_update, V2\Core\AccountLink.create().$params.use_case.account_onboarding, and V2\Core\AccountLink.create().$params.use_case.account_updaterejected on enums V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax.status, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.alma_payments.status, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status, V2.Core.Account.configuration.merchant.capabilities.blik_payments.status, V2.Core.Account.configuration.merchant.capabilities.boleto_payments.status, V2.Core.Account.configuration.merchant.capabilities.card_payments.status, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status, V2.Core.Account.configuration.merchant.capabilities.eps_payments.status, V2.Core.Account.configuration.merchant.capabilities.fpx_payments.status, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.ideal_payments.status, V2.Core.Account.configuration.merchant.capabilities.jcb_payments.status, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.klarna_payments.status, V2.Core.Account.configuration.merchant.capabilities.konbini_payments.status, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status, V2.Core.Account.configuration.merchant.capabilities.link_payments.status, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status, V2.Core.Account.configuration.merchant.capabilities.p24_payments.status, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status, V2.Core.Account.configuration.merchant.capabilities.payco_payments.status, V2.Core.Account.configuration.merchant.capabilities.paynow_payments.status, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status, V2.Core.Account.configuration.merchant.capabilities.sunbit_payments.status, V2.Core.Account.configuration.merchant.capabilities.swish_payments.status, V2.Core.Account.configuration.merchant.capabilities.twint_payments.status, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.zip_payments.status, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status, and V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.statusrejected_fraud, rejected_incomplete_verification, rejected_listed, rejected_other, rejected_platform_fraud, rejected_platform_other, rejected_platform_terms_of_service, and rejected_terms_of_service 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.sunbit_payments.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.Account.configuration.merchant.capabilities.zip_payments.status_details[].code, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status_details[].code, and V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.status_details[].codesatispay_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilityinvalid_address_cmra_address and invalid_address_registered_agent_address on enums V2.Core.Account.future_requirements.entries[].errors[].code and V2.Core.Account.requirements.entries[].errors[].codeblik_recurring_payments and satispay_payments on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitysnapshot_event on V2.Core.Eventblik_recurring_payments, satispay_payments, and sequra_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityAPPS_INSTALL_CREATED, APPS_INSTALL_DELETED, and APPS_INSTALL_UPDATED with resource Apps.InstallV1AccountApplicationAuthorizedEvent, V1AccountApplicationDeauthorizedEvent, V1AccountExternalAccountCreatedEvent, V1AccountExternalAccountDeletedEvent, V1AccountExternalAccountUpdatedEvent, V1BillingPortalSessionCreatedEvent, and V1EntitlementsActiveEntitlementSummaryUpdatedEventV1AccountUpdatedEvent with related object AccountV1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFeeV1ApplicationFeeRefundUpdatedEvent with related object ApplicationFeeRefundV1BalanceAvailableEvent with related object BalanceV1BalanceSettingsUpdatedEvent with related object BalanceSettingsV1BillingAlertTriggeredEvent with related object Billing.AlertV1BillingCreditBalanceTransactionCreatedEvent with related object Billing.CreditBalanceTransactionV1BillingCreditGrantCreatedEvent and V1BillingCreditGrantUpdatedEvent with related object Billing.CreditGrantV1BillingMeterCreatedEvent, V1BillingMeterDeactivatedEvent, V1BillingMeterReactivatedEvent, and V1BillingMeterUpdatedEvent with related object Billing.MeterV1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.ConfigurationV1CapabilityUpdatedEvent with related object CapabilityV1CashBalanceFundsAvailableEvent with related object CashBalanceV1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object ChargeV1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object DisputeV1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object RefundV1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.SessionV1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.OrderV1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.ProductV1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object CouponV1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNoteV1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object CustomerV1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object DiscountV1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object SubscriptionV1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxIdV1CustomerCashBalanceTransactionCreatedEvent with related object CustomerCashBalanceTransactionV1FileCreatedEvent with related object FileV1FinancialConnectionsAccountAccountNumbersUpdatedEvent, V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, V1FinancialConnectionsAccountRefreshedTransactionsEvent, V1FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, V1FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent, and V1FinancialConnectionsAccountUpcomingDeactivationEvent with related object FinancialConnections.AccountV1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSessionV1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentAttemptRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object InvoiceV1InvoicePaymentPaidEvent with related object InvoicePaymentV1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItemV1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.AuthorizationV1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.CardV1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.CardholderV1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.DisputeV1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesignV1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.TokenV1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.TransactionV1MandateUpdatedEvent with related object MandateV1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntentV1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLinkV1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethodV1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object PayoutV1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object PersonV1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object PlanV1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object PriceV1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object ProductV1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCodeV1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object QuoteV1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarningV1ReviewClosedEvent and V1ReviewOpenedEvent with related object ReviewV1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntentV1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRunV1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object SourceV1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionScheduleV1TaxSettingsUpdatedEvent with related object Tax.SettingsV1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRateV1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.ReaderV1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClockV1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object TopupV1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transferdispute_evidence_page_limit_exceeded, financial_connections_consent_locale_invalid, financial_connections_consent_locale_unsupported, and payment_evaluation_on_api_version_not_supported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error#2165 Update generated code
This release changes the pinned API version to 2026-08-26.preview.
This release changes the pinned API version to 2026-08-26.preview.
V2.Core.ApprovalRequest, V2.Signals.AccountActivity, V2.Signals.AccountEvaluation, and V2.Signals.AccountSignalall and retrieve methods on resource V2.Signals.AccountSignalcreate and retrieve methods on resource V2.Signals.AccountEvaluationcreate, delete, and retrieve methods on resource V2.Signals.AccountActivityall, cancel, retrieve, and update methods on resource V2.Core.ApprovalRequestdisable method on resource V2.MoneyManagement.PayoutMethoddisable_stripe_user_authentication on AccountSession.create().$params.component.payment_method_setting.featurepayment_method_types on PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, SetupIntent.create().$params, and SetupIntent.update().$paramsProductCatalog.TrialOffer.end_behavior.transition.price and ProductCatalog.TrialOffer.price from $Price to deletable($Price)billie on QuotePreviewInvoice.payment_settings.payment_method_optionsbillie on enum QuotePreviewInvoice.payment_settings.payment_method_typespayout_methods on V2.Core.Account.defaults and V2\Core\Account.update().$params.defaultrestricted on V2.Core.Vault.GbBankAccount and V2.Core.Vault.UsBankAccountenabled_delivery_schemes on V2.MoneyManagement.PayoutMethod.bank_accountenabled_delivery_options on V2.MoneyManagement.PayoutMethod.bank_accountdisabled on enum V2.MoneyManagement.PayoutMethod.usage_status.paymentsdisabled on enum V2.MoneyManagement.PayoutMethod.usage_status.transfersV2CoreApprovalRequestApprovedEvent, V2CoreApprovalRequestCanceledEvent, V2CoreApprovalRequestCreatedEvent, V2CoreApprovalRequestExpiredEvent, V2CoreApprovalRequestFailedEvent, V2CoreApprovalRequestRejectedEvent, and V2CoreApprovalRequestSucceededEvent with related object V2.Core.ApprovalRequestV2SignalsAccountEvaluationCompleteEvent with related object V2.Signals.AccountEvaluationauthentication_failure, capability_not_active, expired_payment_method, incorrect_postal_code, invalid_canceled_subscription_fields, and payment_method_restricted on QuotePreviewInvoice.last_finalization_errorSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-09-23.preview.
FinancialConnections.Consent, V2.MoneyManagement.FinancialAccountWalletExportCredentials, V2.MoneyManagement.FinancialAccountWalletExport, V2.Provisioning.Eligibility, V2.Provisioning.PaymentMethodRequest, V2.Provisioning.PaymentProfile, V2.Provisioning.Project, V2.Provisioning.ProviderConnectionRequest, V2.Provisioning.ProviderConnection, V2.Provisioning.ProviderServiceDetail, V2.Provisioning.Provider, and V2.Provisioning.ResourceRadar.BillingEvaluationcreate and retrieve methods on resource FinancialConnections.Consentcreate method on resource Radar.BillingEvaluationcreate, link, remove, retrieve, rotate_credentials, submit_information, unlink, and update methods on resource V2.Provisioning.Resourcecreate, retrieve, and submit_information methods on resource V2.Provisioning.ProviderConnectionRequestall and unlink methods on resource V2.Provisioning.ProviderConnectioncreate method on resources V2.Provisioning.PaymentMethodRequest and V2.Provisioning.Projectretrieve and update_limit methods on resource V2.Provisioning.PaymentProfileretrieve method on resource V2.Provisioning.Eligibilityexport_credentials and retrieve methods on resource V2.MoneyManagement.FinancialAccountWalletExportinvalid_address_cmra_address and invalid_address_registered_agent_address on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codedigital_excise_tax, recycling_fee, and utility_users_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typeApps.Install.content_security_policy_granted.connect_src and Apps.Install.content_security_policy_pending.connect_src from nullable(array(string)) to array(string)Apps.Install.content_security_policy_granted.image_src and Apps.Install.content_security_policy_pending.image_src from nullable(array(string)) to array(string)blik_recurring_payments on Account.capabilitiescapital on Account.settingsAccount.business_profile.specified_commercial_transactions_act_url to be requiredpayout_method on Balance.instant_available[].net_available[]destination_currency on BalanceSettings.payments.payouts.automatic_transfer_rules_by_currency.value[] and BalanceSettings.update().$params.payment.payout.automatic_transfer_rules_by_currencytotal_due_amount on Capital.FinancingOffer.accepted_terms and Capital.FinancingSummary.detailsincremental_interval_target_amount and starts_at on Capital.FinancingSummary.details.current_repayment_intervalsetup_credential_usage on Charge.payment_method_details.card, PaymentIntent.payment_method_options.card, and SetupIntent.payment_method_options.cardstored_credential_usage on Charge.payment_method_details.card, PaymentAttemptRecord.payment_method_details.card, PaymentIntent.payment_method_options.card, and PaymentRecord.payment_method_details.cardCharge.payment_method_details.card.electronic_commerce_indicator to be requiredpayment_method_options on Checkout\Session.approve().$paramspayment_reservation on Checkout.Sessioncustom on Checkout.Session.current_attempt.payment_method_detailsCheckout.Session.items[].subscription from nullable(PaymentPagesCheckoutSessionSubscription) to PaymentPagesCheckoutSessionSubscriptionpayment_method_preselect on CustomerSession.components.payment_element.features and CustomerSession.create().$params.component.payment_element.featurebic, iban_last4, and network on CustomerCashBalanceTransaction.funded.bank_transfer.gb_bank_transferapps.install.created, apps.install.deleted, and apps.install.updated on enum Event.typeexpired and pending on enum FinancialConnections.Account.account_numbers[].statuspre_collected_consent on FinancialConnections.Sessionfinancial_activity on FinancialConnections.Transaction.classifications[]credit on FinancialConnections.Transaction.classifications[]touch_n_go on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typesfuels on Issuing.AuthorizationMandate.payment_method_details.blik.type from enum('off_session'|'on_session') to literal('off_session')mandate_options on PaymentIntent.payment_method_options.blikPaymentIntent.payment_method_options.blik.setup_future_usage from literal('none') to enum('none'|'off_session')payout_method_options on Payoutrerouted on enum Radar.PaymentEvaluation.outcome.typeblik on SetupAttempt.payment_method_details and SetupIntent.payment_method_optionscancel_at_period_end on Subscription.pending_updateTaxCode.requirements.performance_location to be requiredtamper_state on Terminal\Reader.all().$paramsorigin_payment_method_options on Treasury\InboundTransfer.create().$paramsach on Treasury.InboundTransfer.origin_payment_method_details.us_bank_accountcollection_status_transitions and collection_status on V2.Billing.ContractV2.Billing.Contract.pricing_lines.data[].ends_at, V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[].ends_at, and V2.Billing.Contract.pricing_overrides.data[].ends_at to be optionaldeveloper on enums EventsV2CoreAccountLinkReturnedEvent.configurations, V2.Core.AccountLink.use_case.account_onboarding.configurations, and V2.Core.AccountLink.use_case.account_update.configurationsdeveloper on enum V2.Core.Account.applied_configurationsdeveloper on V2.Core.Account.configuration, V2\Core\Account.create().$params.configuration, and V2\Core\Account.update().$params.configurationapple_pay on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typeprojects on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitydeveloper on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].configuration and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configurationskip_exportable_balances on V2.MoneyManagement.FinancialAccount.status_details.closed.forwarding_settings and V2\MoneyManagement\FinancialAccount.close().$params.forwarding_settingcrypto on V2.MoneyManagement.FinancialAccount.storage, V2\MoneyManagement\FinancialAccount.create().$params.storage, and V2\MoneyManagement\FinancialAccount.update().$params.storageaddenda on V2.MoneyManagement.OutboundPayment.to.payout_method_options.bank_account.preferred_network_options.ach, V2.MoneyManagement.OutboundPaymentQuote.to.payout_method_options.bank_account.preferred_network_options.ach, V2.MoneyManagement.PayoutIntent.to.payout_method_options.bank_account.preferred_network_options.ach, V2\MoneyManagement\OutboundPayment.create().$params.to.payout_method_option.bank_account.preferred_network_option.ach, V2\MoneyManagement\OutboundPaymentQuote.create().$params.to.payout_method_option.bank_account.preferred_network_option.ach, V2\MoneyManagement\PayoutIntent.create().$params.to.payout_method_option.bank_account.preferred_network_option.ach, and V2\MoneyManagement\PayoutIntent.update().$params.to.payout_method_option.bank_account.preferred_network_option.achpreferred_network_options on V2.MoneyManagement.OutboundTransfer.to.payout_method_options.bank_account and V2\MoneyManagement\OutboundTransfer.create().$params.to.payout_method_option.bank_accountapple_pay on V2.MoneyManagement.PayoutMethod and V2\MoneyManagement\OutboundSetupIntent.create().$params.payout_method_datumapple_pay on enum V2.MoneyManagement.PayoutMethod.typenetwork_details on V2.MoneyManagement.ReceivedCredit.bank_transfercrypto_wallet_export on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryV2\MoneyManagement\FinancialAccount.all().$params.include and V2\MoneyManagement\FinancialAccount.retrieve().$params.include from literal('payments.balance_by_funds_type') to enum('payments.balance_by_funds_type'|'storage.crypto')forwarding_settings on V2\MoneyManagement\FinancialAccount.update().$paramsV2\Billing\Contract.create().$params.pricing_line.ends_at, V2\Billing\Contract.create().$params.pricing_override.ends_at, V2\Billing\Contract.update().$params.pricing_line_action.add.ends_at, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.add.ends_at, and V2\Billing\Contract.update().$params.pricing_override_action.add.ends_at to be optionalAPPS_INSTALL_CREATED, APPS_INSTALL_DELETED, and APPS_INSTALL_UPDATED with resource Apps.InstallV2BillingContractCollectionBlockedEvent, V2BillingContractCollectionCurrentEvent, V2BillingContractCollectionPastDueEvent, and V2BillingContractCollectionUnpaidEvent with related object V2.Billing.ContractV2CoreVaultNetworkTokenActivatedEvent, V2CoreVaultNetworkTokenAuthorizationRequirementsChangedEvent, V2CoreVaultNetworkTokenDeactivatedEvent, V2CoreVaultNetworkTokenDetailsUpdatedEvent, and V2CoreVaultNetworkTokenSuspendedEvent with related object V2.Core.Vault.NetworkTokenV2MoneyManagementFinancialAccountWalletExportCompletedEvent, V2MoneyManagementFinancialAccountWalletExportPendingEvent, and V2MoneyManagementFinancialAccountWalletExportReadyEvent with related object V2.MoneyManagement.FinancialAccountServiceUnavailableExceptionSee the changelog for the full release notes.
See the changelog for the full release notes.
This release changes the pinned API version to 2026-09-16.preview.
Apps.Install and V2.Core.Vault.NetworkTokencreate_from_credential, create, generate_cryptogram, and retrieve methods on resource V2.Core.Vault.NetworkTokennesting_demo on AccountSession.componentsshared_payment_granted_token on Charge.payment_method_detailsCharge.payment_method_details.card.mandate from string to expandable($Mandate)current_trial on Checkout.Session.items[].subscription.items[] and Checkout\Session.create().$params.item.subscription.itemverification_method on Checkout.Session.payment_method_options.bacs_debit and Checkout\Session.create().$params.payment_method_option.bacs_debitaddress_validation_failed and person_verification_failed on enum Crypto.Customer.kyc_tiers[].verification_errorsaddress_validation_failed and person_verification_failed on enum Crypto.Customer.verifications[].errorsripusd on enum Crypto.OnrampSession.transaction_details.destination_currenciesripusd on enum Crypto.OnrampSession.transaction_details.destination_currencycad, cop, and php on enum Crypto.OnrampSession.transaction_details.source_currencyappeal on Dispute.evidencebacs_debit on Invoice.create().$params.payment_setting.payment_method_option, Invoice.payment_settings.payment_method_options, Invoice.update().$params.payment_setting.payment_method_option, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.create().$params.payment_setting.payment_method_option, Subscription.payment_settings.payment_method_options, and Subscription.update().$params.payment_setting.payment_method_optionpricing_token on Invoice.create_preview().$paramsexpires_at on Mandate.payment_method_details.blik, PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code, and Subscription.payment_settings.payment_method_options.blik.mandate_optionsexpires_after on Mandate.payment_method_details.blik and Subscription.payment_settings.payment_method_options.blik.mandate_optionsmomo on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details2.3.0 and 2.3.1 on enums PaymentAttemptRecord.payment_method_details.card.three_d_secure.version and PaymentRecord.payment_method_details.card.three_d_secure.versionlink on PaymentAttemptRecord.payment_method_details.card.wallet and PaymentRecord.payment_method_details.card.walletfunding_source_group on PaymentAttemptRecord.payment_method_details.link and PaymentRecord.payment_method_details.linkpayout_method_options on Payout.create().$paramsProductCatalog.TrialOffer.end_behavior.transition to be optionalearly_fraud_warning and fraudulent_dispute on Radar.PaymentEvaluation.signalsigic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, and Tax.Registration.country_options.skigic on enum Tax.Registration.country_options.es.typemetadata on V2.Billing.Contract.one_time_fees.data[], V2\Billing\Contract.create().$params.one_time_fee, V2\Billing\Contract.update().$params.one_time_fee_action.add, and V2\Billing\Contract.update().$params.one_time_fee_action.updatebank_account and crypto_wallet on V2.MoneyManagement.FinancialAddress and V2\MoneyManagement\FinancialAddress.create().$paramstype on V2.MoneyManagement.FinancialAddress and V2.MoneyManagement.ReceivedCredit.crypto_wallet_transfercredentials and currency on V2.MoneyManagement.FinancialAddressamount_received on V2.MoneyManagement.ReceivedCreditoriginating_bank_account on V2.MoneyManagement.ReceivedCredit.bank_transferorigin_type on V2.MoneyManagement.ReceivedCredit.bank_transfer and V2.MoneyManagement.ReceivedCredit.crypto_wallet_transferlatest_payment_attempt_record_details on V2.Payments.OffSessionPaymentaccount_reviewed on V2.Signals.AccountActivity and V2\Signals\AccountActivity.create().$paramsaccount_reviewed on enum V2.Signals.AccountActivity.typeV2.Signals.PaymentRetrySignal.payment_record to be optionalinclude on V2\Payments\OffSessionPayment.create().$paramsinclude on V2\MoneyManagement\FinancialAddress.all().$params and V2\MoneyManagement\FinancialAddress.retrieve().$paramscrypto_properties and sepa_bank_account on V2\MoneyManagement\FinancialAddress.create().$paramsMerchantNotGatedExceptionAdd support for customer_tax_exemption on Tax.Calculation.shipping_cost.tax_breakdown[] , Tax.CalculationLineItem.tax_breakdown[] , and Tax.Transactio
customer_tax_exemption on Tax.Calculation.shipping_cost.tax_breakdown[], Tax.CalculationLineItem.tax_breakdown[], and Tax.Transaction.shipping_cost.tax_breakdown[]data_share_only on enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.resultbackdate_start_date on Checkout.Session.items[].subscription and Checkout\Session.create().$params.item.subscriptionsignals on Identity.VerificationReportnetwork_response_code on Issuing.Authorization.request_history[]unit_cost_precision on PaymentIntent.capture().$params.amount_detail.line_item, PaymentIntent.confirm().$params.amount_detail.line_item, PaymentIntent.create().$params.amount_detail.line_item, PaymentIntent.decrement_authorization().$params.amount_detail.line_item, PaymentIntent.increment_authorization().$params.amount_detail.line_item, PaymentIntent.update().$params.amount_detail.line_item, and PaymentIntentAmountDetailsLineItemPaymentIntent.payment_record to be requiredactive on ProductCatalog\TrialOffer.all().$paramsSubscription.trial_settings.end_behavior.billing_cycle_anchor to be requiredrtp on enum Treasury.FinancialAccount.financial_addresses[].supported_networksblik_recurring_payments on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilityAdd support for new resources Radar.BillingEvaluation , V2.Signals.PaymentRetryEvaluation , V2.Signals.PaymentRetrySignal , and V2.Tax.IntegrationConf
Radar.BillingEvaluation, V2.Signals.PaymentRetryEvaluation, V2.Signals.PaymentRetrySignal, and V2.Tax.IntegrationConfigurationcreate method on resource Radar.BillingEvaluationall, create, deactivate, retrieve, and update methods on resource Billing.FeedbackOptionretrieve and update methods on resource V2.Tax.IntegrationConfigurationretrieve method on resource V2.Signals.PaymentRetrySignalcancel, create, retrieve, and update methods on resource V2.Signals.PaymentRetryEvaluationdisable method on resource V2.MoneyManagement.PayoutMethodupdate method on resource V2.Core.ApprovalRequestexecute and submit methods on resource V2.Core.ApprovalRequestdisable_stripe_user_authentication on AccountSession.create().$params.component.payment_method_setting.featurecapital_financing_manual_payment on AccountSession.componentssequra_payments on Account.capabilitiesfeedback_options on BillingPortal\Configuration.create().$params.feature.subscription_cancel.cancellation_reason and BillingPortal\Configuration.update().$params.feature.subscription_cancel.cancellation_reasonfundbox_ca_financing on enum Capital.FinancingSummary.details.disclaimer_variantsequra on Charge.payment_method_details, Checkout.Session.payment_method_options, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, and PaymentRecord.payment_method_detailsdata_share_only from enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.resultfunding_types_blocked on Checkout\Session.create().$params.payment_method_option.card.restrictionpayment_intent_data on Checkout\Session.update().$paramsCheckout.Session.payment_method_options.bancontact.setup_future_usage from literal('none') to enum('none'|'off_session')metadata on ConfirmationToken, V2.Signals.AccountActivity, and V2\Signals\AccountActivity.create().$paramssequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeactive_entitlements and customer_portal on CustomerSession.create().$params.componentaddress_match_confidence and name_match_confidence on Identity.VerificationReport.email and Identity.VerificationReport.phonedomain_country, email_exists_confidence, observed_domain_tenure_days, observed_email_tenure_days, and phone_match_confidence on Identity.VerificationReport.emailemail_address_mismatch, email_name_mismatch, email_ownership_unverified, email_phone_mismatch, and email_short_tenure on enum Identity.VerificationReport.email.error.codecarrier, line_type, and observed_phone_tenure_days on Identity.VerificationReport.phonephone_address_mismatch, phone_invalid_line_type, phone_invalid, phone_name_mismatch, phone_ownership_unverified, phone_short_tenure, and phone_unsupported_country on enum Identity.VerificationReport.phone.error.codeemail_address_mismatch, email_name_mismatch, email_ownership_unverified, email_phone_mismatch, email_short_tenure, phone_address_mismatch, phone_invalid_line_type, phone_invalid, phone_name_mismatch, phone_ownership_unverified, phone_short_tenure, and phone_unsupported_country on enum Identity.VerificationSession.last_error.codetruemoney on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typespayment_method_types on PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, SetupIntent.create().$params, and SetupIntent.update().$paramsverification_method on PaymentIntent.confirm().$params.payment_method_option.bacs_debit, PaymentIntent.create().$params.payment_method_option.bacs_debit, PaymentIntent.payment_method_options.bacs_debit, PaymentIntent.update().$params.payment_method_option.bacs_debit, SetupIntent.confirm().$params.payment_method_option.bacs_debit, SetupIntent.create().$params.payment_method_option.bacs_debit, SetupIntent.payment_method_options.bacs_debit, and SetupIntent.update().$params.payment_method_option.bacs_debittouch_n_go on enums PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_typessequra on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesPaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_types to be requiredapplication_fee_amount, application_fee_percent, on_behalf_of, and transfer_data on PaymentLink.update().$paramscanceled on PaymentRecord.report_payment().$params and PaymentRecord.report_payment_attempt().$paramsProductCatalog.TrialOffer.price from $Price to deletable($Price)ProductCatalog.TrialOffer.name to be optionalrecurring on SharedPayment.GrantedToken.usage_limits, SharedPayment.IssuedToken.usage_limits, SharedPayment\GrantedToken.create().$params.usage_limit, and SharedPayment\IssuedToken.create().$params.usage_limitfeedback_option on Subscription.cancel().$params.cancellation_detail and Subscription.update().$params.cancellation_detailpricing_token on Subscription.update().$paramsigic on Tax\Registration.create().$params.country_option.at, Tax\Registration.create().$params.country_option.be, Tax\Registration.create().$params.country_option.bg, Tax\Registration.create().$params.country_option.cy, Tax\Registration.create().$params.country_option.cz, Tax\Registration.create().$params.country_option.de, Tax\Registration.create().$params.country_option.dk, Tax\Registration.create().$params.country_option.e, Tax\Registration.create().$params.country_option.ee, Tax\Registration.create().$params.country_option.fi, Tax\Registration.create().$params.country_option.fr, Tax\Registration.create().$params.country_option.gr, Tax\Registration.create().$params.country_option.hr, Tax\Registration.create().$params.country_option.hu, Tax\Registration.create().$params.country_option.ie, Tax\Registration.create().$params.country_option.it, Tax\Registration.create().$params.country_option.lt, Tax\Registration.create().$params.country_option.lu, Tax\Registration.create().$params.country_option.lv, Tax\Registration.create().$params.country_option.mt, Tax\Registration.create().$params.country_option.nl, Tax\Registration.create().$params.country_option.pl, Tax\Registration.create().$params.country_option.pt, Tax\Registration.create().$params.country_option.ro, Tax\Registration.create().$params.country_option.se, Tax\Registration.create().$params.country_option.si, and Tax\Registration.create().$params.country_option.skone_time_fees on V2.Billing.Contract and V2\Billing\Contract.create().$paramspayment_method_collection on V2.Core.Account.configuration.merchant.gross_settlement, V2\Core\Account.create().$params.configuration.merchant.gross_settlement, and V2\Core\Account.update().$params.configuration.merchant.gross_settlementpayout_methods on V2.Core.Account.defaults and V2\Core\Account.update().$params.defaultreason on V2.Core.ApprovalRequestdescription on V2.Core.ApprovalRequestapi_key, type, and user on V2.Core.ApprovalRequest.requested_by and V2.Core.ApprovalRequest.review.reviewed_byid and name on V2.Core.ApprovalRequest.requested_by and V2.Core.ApprovalRequest.review.reviewed_byapproved_at on V2.Core.ApprovalRequest.status_transitionsrequires_execution_at on V2.Core.ApprovalRequest.status_transitionscrypto_transaction on V2.Core.FeeBatch.collection_records[]crypto_transaction on enum V2.Core.FeeBatch.collection_records[].typerestricted on V2.Core.Vault.GbBankAccount and V2.Core.Vault.UsBankAccountsavings on V2.MoneyManagement.FinancialAccount and V2\MoneyManagement\FinancialAccount.create().$paramssavings on enum V2.MoneyManagement.FinancialAccount.typeenabled_delivery_schemes on V2.MoneyManagement.PayoutMethod.bank_accountenabled_delivery_options on V2.MoneyManagement.PayoutMethod.bank_accountdisabled on enum V2.MoneyManagement.PayoutMethod.usage_status.paymentsdisabled on enum V2.MoneyManagement.PayoutMethod.usage_status.transfersto_account on V2.MoneyManagement.ReceivedDebit.balance_transferaccount_restricted and account_suspended on V2.Signals.AccountActivity and V2\Signals\AccountActivity.create().$paramsaccount_restricted and account_suspended on enum V2.Signals.AccountActivity.typenot_assessed from enums V2.Signals.AccountEvaluation.evaluated_signals.fraudulent_website.risk_level, V2.Signals.AccountEvaluation.evaluated_signals.user_account_sharing.risk_level, V2.Signals.AccountEvaluation.evaluated_signals.user_multi_accounting.risk_level, V2.Signals.AccountSignal.fraudulent_merchant.risk_level, V2.Signals.AccountSignal.fraudulent_website.risk_level, V2.Signals.AccountSignal.merchant_delinquency.risk_level, V2.Signals.AccountSignal.user_account_sharing.risk_level, and V2.Signals.AccountSignal.user_multi_accounting.risk_leveladditional_details on V2.Signals.AccountSignal.fraudulent_merchant and V2.Signals.AccountSignal.merchant_delinquencyindicators on V2.Signals.AccountSignal.fraudulent_merchant and V2.Signals.AccountSignal.merchant_delinquencyaction, created, and status on V2\Core\ApprovalRequest.all().$paramsone_time_fee_actions on V2\Billing\Contract.update().$paramsV2CoreHealthMetronomeNotificationLatencyFiringEvent, V2CoreHealthMetronomeNotificationLatencyResolvedEvent, and V2SignalsPaymentRetryEvaluationsRetryRecommendedEventV2MoneyManagementPayoutIntentCanceledEvent, V2MoneyManagementPayoutIntentCreatedEvent, V2MoneyManagementPayoutIntentPostedEvent, V2MoneyManagementPayoutIntentProcessingEvent, and V2MoneyManagementPayoutIntentRequiresActionEvent with related object V2.MoneyManagement.PayoutIntentauthentication_failure, capability_not_active, expired_payment_method, incorrect_postal_code, invalid_canceled_subscription_fields, and payment_method_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_errorThis release changes the pinned API version to 2026-08-26.preview.
This release changes the pinned API version to 2026-08-26.preview.
CustomerTaxExemptionall, create, delete, and retrieve methods on resource CustomerTaxExemptiondetails on Account.future_requirements.errors[], Account.requirements.errors[], BankAccount.future_requirements.errors[], BankAccount.requirements.errors[], Capability.future_requirements.errors[], Capability.requirements.errors[], Person.future_requirements.errors[], and Person.requirements.errors[]sequra_payments on Account.capabilitiessubscription_pause on BillingPortal\Session.create().$params.flow_datumsequra on Charge.payment_method_details, Checkout.Session.payment_method_options, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, and PaymentRecord.payment_method_detailsenablement_details on Checkout.Session.automatic_taxsequra from enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typecredit on FinancialConnections.Transaction.classifications[]FinancialConnections.Transaction.classifications[].money_movement from nullable(BankConnectionsResourceTransactionResourceClassificationsLabels) to BankConnectionsResourceTransactionResourceClassificationsLabelsFinancialConnections.Transaction.classifications[].personal_finance from nullable(BankConnectionsResourceTransactionResourceClassificationsLabels) to BankConnectionsResourceTransactionResourceClassificationsLabelsFinancialConnections.Transaction.classifications[].money_movement to be optionalFinancialConnections.Transaction.classifications[].personal_finance to be optionaluser_consent on Identity\VerificationSession.create().$params and Identity\VerificationSession.update().$paramscompany_details on Invoice.payment_settings.payment_method_options.billie, PaymentIntent.confirm().$params.payment_method_option.billie, PaymentIntent.create().$params.payment_method_option.billie, PaymentIntent.payment_method_options.billie, PaymentIntent.update().$params.payment_method_option.billie, QuotePreviewInvoice.payment_settings.payment_method_options.billie, and Subscription.payment_settings.payment_method_options.billiereference on Invoice.payment_settings.payment_method_options.billie, PaymentIntent.confirm().$params.payment_method_option.billie, PaymentIntent.create().$params.payment_method_option.billie, PaymentIntent.payment_method_options.billie, PaymentIntent.update().$params.payment_method_option.billie, and QuotePreviewInvoice.payment_settings.payment_method_options.billiepos_condition on Issuing.Authorization and Issuing\Authorization.create().$paramscrypto_wallet on Issuing.Card, Issuing\Card.create().$params, and Issuing\Card.update().$paramspayment_evaluations and payment_method_details on PaymentAttemptRecord.report_authorized().$paramsaade_data on PaymentIntent.confirm().$params.payment_method_option.card_present, PaymentIntent.create().$params.payment_method_option.card_present, and PaymentIntent.update().$params.payment_method_option.card_presentcancel_at_period_end on Subscription.pending_updateblik_recurring_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capabilityuser_access on V2.Iam.ActivityLog.detailsuser_access on enum V2.Iam.ActivityLog.details.typeuser_access_started on enum V2.Iam.ActivityLog.typeblik_recurring_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
See the changelog for more details .
See the changelog for more details .
This release changes the pinned API version to 2026-08-26.dahlia.
This release changes the pinned API version to 2026-08-26.dahlia.
#2113 Support discriminated unions in the V2 runtime and fix array coercion
nullable and discriminatedUnion field encodings in the V2 coercion runtime, so int64 and decimal fields wrapped in those schema kinds convert correctly.\Stripe\Exception\InvalidArgumentException when a polymorphic (discriminated union) parameter is missing its discriminator field, or that field is not a string.int64_string and decimal_string fields inside arrays not being coerced in either direction.#2124 Add new EventNotificationHandler class for better thin event management
StripeClient and the fully-typed nature of thin events. This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.#2118 Update generated code
Billing.FeedbackOptionall, create, deactivate, retrieve, and update methods on resource Billing.FeedbackOptionpayment_method_settings on AccountSession.components and AccountSession.create().$params.componentfeedback_options on BillingPortal.Configuration.features.subscription_cancel.cancellation_reason, BillingPortal\Configuration.create().$params.feature.subscription_cancel.cancellation_reason, and BillingPortal\Configuration.update().$params.feature.subscription_cancel.cancellation_reasoncustomer_update on BillingPortal.Session.flowcustomer_update on enum BillingPortal.Session.flow.typefunding_source_group on Charge.payment_method_details.card.wallet.link and Charge.payment_method_details.linkfunding_types_blocked on Checkout.Session.payment_method_options.card.restrictions and Checkout\Session.create().$params.payment_method_option.card.restrictionmetadata on ConfirmationTokenactive_entitlements and customer_portal on CustomerSession.components and CustomerSession.create().$params.componentcountry on FinancialConnections.Session.filtersfrozen_fields on InvoiceItembillie on Invoice.create().$params.payment_setting.payment_method_option, Invoice.payment_settings.payment_method_options, Invoice.update().$params.payment_setting.payment_method_option, Subscription.create().$params.payment_setting.payment_method_option, Subscription.payment_settings.payment_method_options, and Subscription.update().$params.payment_setting.payment_method_optionbillie on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typescryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_securetouch_n_go on enums PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_typesPaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_types to be requiredapplication_fee_amount, application_fee_percent, on_behalf_of, and transfer_data on PaymentLink.update().$paramsfeedback_option on Subscription.cancel().$params.cancellation_detail, Subscription.cancellation_details, and Subscription.update().$params.cancellation_detailigic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, Tax.Registration.country_options.sk, Tax\Registration.create().$params.country_option.at, Tax\Registration.create().$params.country_option.be, Tax\Registration.create().$params.country_option.bg, Tax\Registration.create().$params.country_option.cy, Tax\Registration.create().$params.country_option.cz, Tax\Registration.create().$params.country_option.de, Tax\Registration.create().$params.country_option.dk, Tax\Registration.create().$params.country_option.e, Tax\Registration.create().$params.country_option.ee, Tax\Registration.create().$params.country_option.fi, Tax\Registration.create().$params.country_option.fr, Tax\Registration.create().$params.country_option.gr, Tax\Registration.create().$params.country_option.hr, Tax\Registration.create().$params.country_option.hu, Tax\Registration.create().$params.country_option.ie, Tax\Registration.create().$params.country_option.it, Tax\Registration.create().$params.country_option.lt, Tax\Registration.create().$params.country_option.lu, Tax\Registration.create().$params.country_option.lv, Tax\Registration.create().$params.country_option.mt, Tax\Registration.create().$params.country_option.nl, Tax\Registration.create().$params.country_option.pl, Tax\Registration.create().$params.country_option.pt, Tax\Registration.create().$params.country_option.ro, Tax\Registration.create().$params.country_option.se, Tax\Registration.create().$params.country_option.si, and Tax\Registration.create().$params.country_option.skauthentication_failure, capability_not_active, expired_payment_method, incorrect_postal_code, invalid_canceled_subscription_fields, and payment_method_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_errorAdd support for new resources Billing.FeedbackOption and PaymentPlan
Billing.FeedbackOption and PaymentPlanBilling.FeedbackOptionsall, create, retrieve, and update methods on resource PaymentPlanupdate method on resource V2.MoneyManagement.Transactionwechat_pay_payments on Account.create().$params.setting, Account.settings, and Account.update().$params.settingBillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options from $Billing.FeedbackOptions to $Billing.FeedbackOptionBillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options to be requiredsubscription_pause on BillingPortal.Session.flowsubscription_pause on enum BillingPortal.Session.flow.typeusdt on enum Crypto.OnrampSession.transaction_details.destination_currenciesusdt on enum Crypto.OnrampSession.transaction_details.destination_currencyactive_entitlements on CustomerSession.componentsshared_payment_issued_token on DelegatedCheckout\RequestedSession.confirm().$paramspayment_plan.created, payment_plan.installment_due, payment_plan.installment_paid, payment_plan.installment_will_be_due, and payment_plan.updated on enum Event.typemanaged_payments on Invoice.create().$params, InvoiceItem.create().$params, InvoiceItem, Invoice, and QuotePreviewInvoicepayment_plan on Invoiceestimated_fee_details and estimated_fee on Issuing.Authorization.pending_request.hold_amount_details and Issuing.Authorization.request_history[].hold_amount_detailscryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secureProductCatalog.TrialOffer.end_behavior.transition.price from $Price to deletable($Price)Subscription.cancellation_details.feedback_option from $Billing.FeedbackOptions to $Billing.FeedbackOptioncancel_at_period_end on Subscription.pending_updateSubscription.cancellation_details.feedback_option to be requiredigic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, and Tax.Registration.country_options.skmetadata on V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[], V2.Billing.Contract.pricing_overrides.data[], V2.MoneyManagement.Transaction, V2\Billing\Contract.create().$params.pricing_override, V2\Billing\Contract.update().$params.pricing_line_action.update, V2\Billing\Contract.update().$params.pricing_override_action.add, V2\Billing\Contract.update().$params.pricing_override_action.update, and V2\Billing\Contract.update().$paramstax_amount on V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[]payout_method_options on V2.MoneyManagement.OutboundPaymentQuote.to and V2\MoneyManagement\OutboundPaymentQuote.create().$params.toV2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.update.metadata from string to emptyable(string)PAYMENT_PLAN_CREATED, PAYMENT_PLAN_INSTALLMENT_DUE, PAYMENT_PLAN_INSTALLMENT_PAID, PAYMENT_PLAN_INSTALLMENT_WILL_BE_DUE, and PAYMENT_PLAN_UPDATED with resource PaymentPlanThis release changes the pinned API version to 2026-08-12.preview.
This release changes the pinned API version to 2026-08-12.preview.
V2.Tax.OperationsResolveAddressResultresolve_address method on resource V2.Tax.OperationsResolveAddressResultconfirm and fx_quote methods on resource V2.MoneyManagement.PayoutIntentpartner_disabled on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codepartner_disabled_dispute_rate, partner_disabled_responsibilities, partner_disabled_restricted_business, and partner_disabled_suspected_fraud from enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codecustomer_update on BillingPortal.Session.flowcustomer_update on enum BillingPortal.Session.flow.typefunding_source_group on Charge.payment_method_details.linkpricing_group on Charge.payment_method_details.linkcelo on enum Crypto.CustomerConsumerWallet.networkcelo on enum Crypto.OnrampSession.transaction_details.destination_networkcelo on enum Crypto.OnrampSession.transaction_details.destination_networkscelo on Crypto.OnrampSession.transaction_details.wallet_addressescustomer_portal on CustomerSession.componentsapplied_to_invoice and type on CustomerBalanceTransaction.create().$paramsclassification_state and enrichment_state on FinancialConnections.Accountcountry on FinancialConnections.Session.filtersclassifications and enrichments on FinancialConnections.Transactioncustomer_balance on Invoice and QuotePreviewInvoicebillie on Invoice.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, and Subscription.payment_settings.payment_method_optionsbillie, paypay, and vipps on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typeshold_amount_details and hold_amount on Issuing.Authorization.pending_request and Issuing.Authorization.request_history[]hu and ro on enum Issuing.Cardholder.preferred_localesnetwork_decline_code on PaymentAttemptRecord.report_failed().$params.payment_method_detail.card and PaymentRecord.report_payment_attempt_failed().$params.payment_method_detail.cardsetup_future_usage on PaymentIntent.payment_method_options.sequrastatus on QuotePreviewSubscriptionSchedule.pause_schedules[].pause, QuotePreviewSubscriptionSchedule.pause_schedules[].resume, SubscriptionSchedule.pause_schedules[].pause, and SubscriptionSchedule.pause_schedules[].resumeSubscriptionSchedule.create().$params.pause_schedule.pause to be optionalSubscriptionSchedule.update().$params.pause_schedule.resume from pause_schedule_update_resume_params to emptyable(pause_schedule_update_resume_params)acquirer on EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.dimensions[], EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.dimensions[], V2.Core.Health.Alert.authorization_rate_drop.dimensions[], and V2.Core.Health.AlertHistoryEntry.authorization_rate_drop.dimensions[]EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.dimensions[].type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.dimensions[].type, V2.Core.Health.Alert.authorization_rate_drop.dimensions[].type, and V2.Core.Health.AlertHistoryEntry.authorization_rate_drop.dimensions[].type from literal('issuer') to enum('acquirer'|'issuer')confirmation_method on V2.MoneyManagement.PayoutIntent and V2\MoneyManagement\PayoutIntent.create().$paramsestimated_fees and fx_quote on V2.MoneyManagement.PayoutIntentdebited on V2.MoneyManagement.PayoutIntent.fromconfirm on V2.MoneyManagement.PayoutIntent.next_actionV2.MoneyManagement.PayoutIntent.next_action.type from literal('handle_failure') to enum('confirm'|'handle_failure')credited on V2.MoneyManagement.PayoutIntent.toV1BalanceSettingsUpdatedEvent with related object BalanceSettingsV1BillingCreditBalanceTransactionCreatedEvent with related object Billing.CreditBalanceTransactionV1BillingCreditGrantCreatedEvent and V1BillingCreditGrantUpdatedEvent with related object Billing.CreditGrantV1BillingMeterCreatedEvent, V1BillingMeterDeactivatedEvent, V1BillingMeterReactivatedEvent, and V1BillingMeterUpdatedEvent with related object Billing.MeterV1FinancialConnectionsAccountAccountNumbersUpdatedEvent, V1FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, V1FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, V1FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent, and V1FinancialConnectionsAccountUpcomingDeactivationEvent with related object FinancialConnections.AccountV1InvoicePaymentAttemptRequiredEvent with related object InvoiceFxQuoteNeedsRefreshExceptionSee the changelog for more details .
Added methods that return their respective Event / EventNotification class instances without verifying authenticity. Use them when you've previously v
#2119 Surface object property on EventNotification
#2117 Emit Claude Code plugin hint at module load time
#2105 add/adjust event parsing helpers
Event/EventNotification class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from AWS EventBridge and Azure Event Grid natively.
Webhook::constructEventWithoutVerification($payload)BaseStripeClient::constructEventWithoutVerification($payload)BaseStripeClient::parseEventNotificationWithoutVerification($payload)WebhookSignature::generateSignatureHeader($payload, $secret, $timestamp = null), which computes a full Stripe-Signature header for the given payload. Useful for unit tests!#2112 Add stripe.major_api_version constant
This release changes the pinned API version to 2026-07-29.preview.
This release changes the pinned API version to 2026-07-29.preview.
all and retrieve methods on resource ProductCatalog.TrialOffertax_items on Charge.capture().$params.payment_detail.car_rental_datum.total.tax, Charge.capture().$params.payment_detail.flight_datum.total.tax, Charge.capture().$params.payment_detail.lodging_datum.total.tax, Charge.update().$params.payment_detail.car_rental_datum.total.tax, Charge.update().$params.payment_detail.flight_datum.total.tax, Charge.update().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.capture().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.capture().$params.payment_detail.flight_datum.total.tax, PaymentIntent.capture().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.flight_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.create().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.create().$params.payment_detail.flight_datum.total.tax, PaymentIntent.create().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, PaymentIntent.payment_details.lodging_data[].total.tax, PaymentIntent.update().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.update().$params.payment_detail.flight_datum.total.tax, and PaymentIntent.update().$params.payment_detail.lodging_datum.total.taxtaxes on Charge.capture().$params.payment_detail.car_rental_datum.total.tax, Charge.capture().$params.payment_detail.flight_datum.total.tax, Charge.capture().$params.payment_detail.lodging_datum.total.tax, Charge.update().$params.payment_detail.car_rental_datum.total.tax, Charge.update().$params.payment_detail.flight_datum.total.tax, Charge.update().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.capture().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.capture().$params.payment_detail.flight_datum.total.tax, PaymentIntent.capture().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.flight_datum.total.tax, PaymentIntent.confirm().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.create().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.create().$params.payment_detail.flight_datum.total.tax, PaymentIntent.create().$params.payment_detail.lodging_datum.total.tax, PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, PaymentIntent.payment_details.lodging_data[].total.tax, PaymentIntent.update().$params.payment_detail.car_rental_datum.total.tax, PaymentIntent.update().$params.payment_detail.flight_datum.total.tax, and PaymentIntent.update().$params.payment_detail.lodging_datum.total.taxtax_id on Checkout.Session.collected_informationtax_ids on Checkout.Session.collected_informationmode on FinancialConnections.Session.manual_entryname on Issuing\Cardholder.update().$paramsic_nif on enums Order.tax_details.tax_ids[].type and QuotePreviewInvoice.customer_tax_ids[].typealipay and mb_way on enum QuotePreviewInvoice.payment_settings.payment_method_typescustom_fields, description, and footer on QuotePreviewSubscriptionSchedule.default_settings.invoice_settings and QuotePreviewSubscriptionSchedule.phases[].invoice_settingstrial on QuotePreviewSubscriptionSchedule.phases[]acss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, twint, upi, us_bank_account, wechat_pay, and zip on SharedPayment.GrantedToken.payment_method_detailsacss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, custom, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, twint, upi, us_bank_account, wechat_pay, and zip from enum SharedPayment.GrantedToken.payment_method_details.typeuse_stripe_sdk on SharedPayment.IssuedToken and SharedPayment\IssuedToken.create().$paramsredirect_to_url on SharedPayment.IssuedToken.next_actionSharedPayment.IssuedToken.next_action.type from literal('use_stripe_sdk') to enum('redirect_to_url'|'use_stripe_sdk')livemode on Tax.Locationsource on V2.Iam.ActivityLog.details.user_rolespayout on V2.MoneyManagement.ReceivedCredit.balance_transferpayout_v1 on V2.MoneyManagement.ReceivedCredit.balance_transferpayout on enum V2.MoneyManagement.ReceivedCredit.balance_transfer.typeV2.MoneyManagement.ReceivedDebit.bank_transfer.us_bank_account to be optionalAdd support for new resource Billing.FeedbackOptions
Billing.FeedbackOptionssequra_payments on Account.capabilitiesfeedback_options on BillingPortal.Configuration.features.subscription_cancel.cancellation_reasonsequra on Charge.payment_method_details, Checkout.Session.payment_method_options, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, and PaymentRecord.payment_method_detailsretrieval_reference_number on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_presentpricing_group on Charge.payment_method_details.linktax_rates on Checkout.Session.shipping_options[], Checkout\Session.create().$params.shipping_option, and Checkout\Session.update().$params.shipping_optiondaikin on enums Checkout.Session.automatic_surcharge.provider and PaymentLink.automatic_surcharge.providerfunding_types_blocked on Checkout.Session.payment_method_options.card.restrictionssequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typehealthcare on Issuing\Authorization.capture().$params.purchase_detail, Issuing\Authorization.create().$params, Issuing\Transaction.create_force_capture().$params.purchase_detail, and Issuing\Transaction.create_unlinked_refund().$params.purchase_detailIssuing.Authorization.healthcare.verification_status from nullable(enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified')) to enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified')is_anomalous on PaymentAttemptRecord.report_guaranteed().$paramssequra on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typesaade_data on PaymentIntent.payment_method_options.card_presentRadar.PaymentEvaluation.payment_details.payment_method_details.card.first6 to be requiredRadar.PaymentEvaluation.payment_details.payment_method_details.card.last4 to be requiredfeedback_option on Subscription.cancellation_detailsapplication on V2.Payments.OffSessionPaymentstatus on V2\MoneyManagement\FinancialAccountStatement.all().$paramsV2\Billing\Contract.create().$params.pricing_lines to be optionalThis release changes the pinned API version to 2026-07-29.preview.
This release changes the pinned API version to 2026-07-29.preview.
V2.MoneyManagement.ReceivedDebitMandate, V2.Risk.Inquiry, V2.Signals.AccountActivity, and V2.Signals.AccountEvaluationcreate and retrieve methods on resource V2.Signals.AccountEvaluationcreate, delete, and retrieve methods on resource V2.Signals.AccountActivityall, retrieve, and update methods on resource V2.Risk.Inquiryall, cancel, and retrieve methods on resource V2.MoneyManagement.ReceivedDebitMandaterate_cards on Billing.CreditGrant.applicability_config.scope, Billing\CreditBalanceSummary.retrieve().$params.filter.applicability_scope, and Billing\CreditGrant.create().$params.applicability_config.scopeConfirmationToken.payment_method_preview.gift_card.brand, GiftCard.brand, GiftCard.create().$params.brand, PaymentMethod.gift_card.brand, Terminal\Reader.activate_gift_card().$params.brand, Terminal\Reader.cashout_gift_card().$params.brand, Terminal\Reader.check_gift_card_balance().$params.brand, and Terminal\Reader.reload_gift_card().$params.brand from enum('fiserv_valuelink'|'givex'|'svs') to literal('svs')tempo on enum Crypto.CustomerConsumerWallet.networktempo on enum Crypto.OnrampSession.transaction_details.destination_networktempo on enum Crypto.OnrampSession.transaction_details.destination_networkstempo on Crypto.OnrampSession.transaction_details.wallet_addressestry_again_later on enum GiftCardOperation.failure_codehealthcare on Issuing.Authorizationproduct_code on Issuing.Card, Issuing\Card.create().$params, and Issuing\Card.update().$paramsproduct_graduation_state on Issuing.Cardcvc and number on Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.cardRadar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.card.first6 to be optionalRadar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.card.last4 to be optionalcard on Radar.PaymentEvaluation.payment_details.payment_method_detailsTerminal\Reader.collect_payment_method().$params.collect_config.gift_card_brand and Terminal\Reader.process_payment_intent().$params.process_config.gift_card_brand from enum('fiserv_valuelink'|'givex'|'svs') to literal('svs')gift_card on Terminal\Reader.present_payment_method().$paramsamount_due and customer_balance_applied on V2.Billing.Intent.amount_detailsV2.Core.AccountEvaluation.evaluations_triggered from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')gross_settlement on V2.Core.Account.configuration.merchant, V2\Core\Account.create().$params.configuration.merchant, and V2\Core\Account.update().$params.configuration.merchantV2.MoneyManagement.DebitDispute.bank_transfer.network from literal('ach') to enum('ach'|'bacs')beneficiary_unrecognized, mandate_canceled_by_stripe, mandate_canceled, no_advance_notice, originator_requested, and signature_invalid on enum V2.MoneyManagement.DebitDispute.bank_transfer.reasonmanaged_by on V2.MoneyManagement.FinancialAccountpayout_intent on V2.MoneyManagement.OutboundPaymentsettles_at on V2.MoneyManagement.ReceivedDebitgb_bank_account on V2.MoneyManagement.ReceivedDebit.bank_transferV2.MoneyManagement.ReceivedDebit.bank_transfer.origin_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')V2.MoneyManagement.ReceivedDebit.bank_transfer.payment_method_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')scheduled on enum V2.MoneyManagement.ReceivedDebit.statusno_mandate on enum V2.MoneyManagement.ReceivedDebit.status_details.failed.reasontarget_date on V2.Payments.OffSessionPayment and V2\Payments\OffSessionPayment.create().$paramsaccount_evaluation, fraudulent_website, payment_delinquency_exposure, user_account_sharing, and user_multi_accounting on V2.Signals.AccountSignalfraudulent_website, user_account_sharing, and user_multi_accounting on enum V2.Signals.AccountSignal.typeV2\MoneyManagement\FinancialAddressDebitSimulation.debit().$params.network from literal('ach') to enum('ach'|'bacs')received_debit_mandate on V2\MoneyManagement\ReceivedDebit.all().$paramspayout_intent on V2\MoneyManagement\OutboundPayment.create().$paramsV2\Core\AccountEvaluation.create().$params.signals from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')id on EventsV2SignalsAccountSignalFraudulentMerchantReadyEventV2MoneyManagementReceivedDebitCreatedEvent and V2MoneyManagementReceivedDebitScheduledEvent with related object V2.MoneyManagement.ReceivedDebitV2MoneyManagementReceivedDebitMandateCanceledEvent, V2MoneyManagementReceivedDebitMandateCreatedEvent, V2MoneyManagementReceivedDebitMandateExpiredEvent, V2MoneyManagementReceivedDebitMandatePendingCancellationEvent, and V2MoneyManagementReceivedDebitMandateUpdatedEvent with related object V2.MoneyManagement.ReceivedDebitMandateV2SignalsAccountEvaluationCompleteEvent with related object V2.Signals.AccountEvaluationV2SignalsAccountSignalFraudulentWebsiteReadyEvent and V2SignalsAccountSignalPaymentDelinquencyExposureReadyEvent with related object V2.Signals.AccountSignalSee the changelog for more details .
Remove support for proof_of_registration on Account.create().$params.document . This field was limited-use and is being deprecated.
This release changes the pinned API version to 2026-07-29.dahlia.
FinancialConnections.Authorizationunreject method on resource Accountall method on resource PaymentRecordmass_transit_parking_tax and parking_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, and TaxRate.tax_typechaps on enums FundingInstructions.bank_transfer.financial_addresses[].supported_networks and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networkssmart_disputes_management on AccountSession.components.disputes_list.features, AccountSession.components.payment_details.features, AccountSession.components.payment_disputes.features, AccountSession.components.payments.features, AccountSession.create().$params.component.disputes_list.feature, AccountSession.create().$params.component.payment.feature, AccountSession.create().$params.component.payment_detail.feature, and AccountSession.create().$params.component.payment_dispute.featureadministrative_address and principal_place_of_business on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.companysepa_debit_payments on Account.update().$params.settingproof_of_registration on Account.create().$params.document. This field was limited-use and is being deprecated.payouts_action on Account.reject().$paramsdata_share_only on enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.resultbnp_paribas, citibank, and mbsb_bank on enums Charge.payment_method_details.fpx.bank, ConfirmationToken.payment_method_preview.fpx.bank, PaymentAttemptRecord.payment_method_details.fpx.bank, PaymentMethod.fpx.bank, and PaymentRecord.payment_method_details.fpx.bankdynamic_tax_rates on Checkout\Session.create().$params.line_item. This field was limited-use and is being deprecated.setup_future_usage on Checkout.Session.payment_method_options.payco, Checkout.Session.payment_method_options.samsung_pay, Checkout\Session.create().$params.payment_method_option.payco, Checkout\Session.create().$params.payment_method_option.samsung_pay, PaymentIntent.confirm().$params.payment_method_option.payco, PaymentIntent.confirm().$params.payment_method_option.samsung_pay, PaymentIntent.create().$params.payment_method_option.payco, PaymentIntent.create().$params.payment_method_option.samsung_pay, PaymentIntent.payment_method_options.payco, PaymentIntent.payment_method_options.samsung_pay, PaymentIntent.update().$params.payment_method_option.payco, PaymentIntent.update().$params.payment_method_option.samsung_pay, and PaymentLink.update().$params.payment_intent_datumic_nif on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typenetwork on Dispute.payment_method_details.cardfinancial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enum Event.typelimits and manual_entry on FinancialConnections.Session and FinancialConnections\Session.create().$paramsrequire_payment_method_support on FinancialConnections.Session.filters and FinancialConnections\Session.create().$params.filterbank_account_token on FinancialConnections.Sessionmetadata on Invoice.create_preview().$params.subscription_detailalipay and mb_way on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_typesstripe_internal_error on enum Issuing.Authorization.request_history[].reasonbusiness_name on Issuing.Card.shipping, Issuing\Card.create().$params.shipping, and Issuing\Card.update().$params.shippingcorreos on enum Issuing.Card.shipping.carrierallowed_payment_method_types on PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, PaymentIntent, SetupIntent.confirm().$params, SetupIntent.create().$params, SetupIntent.update().$params, and SetupIntentreferrer on PaymentIntent.confirm().$params.radar_option and PaymentIntent.create().$params.radar_optionconsent_collection and shipping_options on PaymentLink.update().$paramscustom_fields, description, and footer on Quote.create().$params.invoice_setting, Quote.invoice_settings, Quote.update().$params.invoice_setting, SubscriptionSchedule.create().$params.default_setting.invoice_setting, SubscriptionSchedule.create().$params.phase.invoice_setting, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases[].invoice_settings, SubscriptionSchedule.update().$params.default_setting.invoice_setting, and SubscriptionSchedule.update().$params.phase.invoice_settingcustomer_account and customer on Refundpayment_method on Refund and Topuptrial on SubscriptionSchedule.phases[]mass_transit_parking_tax and parking_tax on Tax.Registration.country_options.us and Tax\Registration.create().$params.country_option.memass_transit_parking_tax and parking_tax on enum Tax.Registration.country_options.us.typeinitiated_by and payment_method_options on Topupadditional_addresses on V2.Core.Account.identity.business_details, V2\Core\Account.create().$params.identity.business_detail, V2\Core\Account.update().$params.identity.business_detail, and V2\Core\AccountToken.create().$params.identity.business_detailFINANCIAL_CONNECTIONS_ACCOUNT_EXPECTED_DEACTIVATION_DATE_UPDATED, FINANCIAL_CONNECTIONS_ACCOUNT_SUPPORTED_PAYMENT_METHOD_TYPES_UPDATED, and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_DEACTIVATION with resource FinancialConnections.AccountFINANCIAL_CONNECTIONS_AUTHORIZATION_EXPECTED_DEACTIVATION_DATE_UPDATED and FINANCIAL_CONNECTIONS_AUTHORIZATION_UPCOMING_DEACTIVATION with resource FinancialConnections.AuthorizationAdd support for new resources Billing.AlertNotification and Crypto.DepositAddress
Billing.AlertNotification and Crypto.DepositAddressall, create, and retrieve methods on resource Crypto.DepositAddressall method on resource Billing.AlertNotificationpartner_disabled_dispute_rate, partner_disabled_responsibilities, partner_disabled_restricted_business, and partner_disabled_suspected_fraud on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].codedata_share_only on enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.resultvipps on ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datumvipps on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typesui on enum Crypto.CustomerConsumerWallet.networksui on enum Crypto.OnrampSession.transaction_details.destination_networksui on enum Crypto.OnrampSession.transaction_details.destination_networkssui on Crypto.OnrampSession.transaction_details.wallet_addressesuse_stripe_sdk on DelegatedCheckout\RequestedSession.confirm().$paramsmb_way on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typesev_charging on PaymentIntent.capture().$params.amount_detail.line_item.payment_method_option.card, PaymentIntent.confirm().$params.amount_detail.line_item.payment_method_option.card, PaymentIntent.create().$params.amount_detail.line_item.payment_method_option.card, PaymentIntent.decrement_authorization().$params.amount_detail.line_item.payment_method_option.card, PaymentIntent.increment_authorization().$params.amount_detail.line_item.payment_method_option.card, PaymentIntent.update().$params.amount_detail.line_item.payment_method_option.card, and PaymentIntentAmountDetailsLineItem.payment_method_options.cardPaymentIntent.allowed_payment_method_types from string to enumvipps on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_typestax_items on PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, and PaymentIntent.payment_details.lodging_data[].total.taxtaxes on PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, and PaymentIntent.payment_details.lodging_data[].total.taxPaymentRecord.create().$params.closed to be optionalPaymentRecord.create().$params.funded to be optionalcard on Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detailacss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, customer_balance, eps, fpx, gift_card, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, tamara, twint, upi, us_bank_account, wechat_pay, and zip on SharedPayment.GrantedToken.payment_method_detailsshop_pay on enum SharedPayment.GrantedToken.payment_method_details.typeacss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, custom, customer_balance, eps, fpx, gift_card, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, tamara, twint, upi, us_bank_account, wechat_pay, and zip from enum SharedPayment.GrantedToken.payment_method_details.typespend_card on V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe, V2\Core\Account.create().$params.configuration.card_creator.capability.commercial.stripe, and V2\Core\Account.update().$params.configuration.card_creator.capability.commercial.stripecommercial.stripe.spend_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitypayment_delinquency_exposure on enum V2.Signals.AccountSignal.typecommercial.stripe.spend_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability⚠️ #2096 Update generated code for private-preview
FrMealVouchersOnboardingall, create, retrieve, and update methods on resource FrMealVouchersOnboardingcreate method on resource PaymentRecordchaps on enums FundingInstructions.bank_transfer.financial_addresses[].supported_networks and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networksfinancial_accounts_transactions, financial_accounts, and recipients_list on AccountSession.create().$params.componentsmart_disputes_management on AccountSession.components.disputes_list.features, AccountSession.components.payment_details.features, AccountSession.components.payment_disputes.features, and AccountSession.components.payments.featuresic_nif on enums Checkout.Session.collected_information.tax_id.type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, and Tax.Transaction.customer_details.tax_ids[].typefinancial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enum Event.typemode on FinancialConnections.Session.manual_entryalipay and sequra on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_typesstripe_internal_error on enum Issuing.Authorization.request_history[].reasonbusiness_name on Issuing.Card.shippingcorreos on enum Issuing.Card.shipping.carrierIssuing.Transaction.network_data.trace_id from IssuingTransactionTraceId to nullable(IssuingTransactionTraceId)pause_schedules on QuotePreviewSubscriptionSchedule, SubscriptionSchedule.create().$params, SubscriptionSchedule.update().$params, and SubscriptionScheduletrial on QuotePreviewSubscriptionSchedule.phases[] and SubscriptionSchedule.phases[]payment_record on Refund.create().$paramsredirect_to_url on SharedPayment.IssuedToken.next_actionSharedPayment.IssuedToken.next_action.type from literal('use_stripe_sdk') to enum('redirect_to_url'|'use_stripe_sdk')FINANCIAL_CONNECTIONS_ACCOUNT_EXPECTED_DEACTIVATION_DATE_UPDATED, FINANCIAL_CONNECTIONS_ACCOUNT_SUPPORTED_PAYMENT_METHOD_TYPES_UPDATED, and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_DEACTIVATION with resource FinancialConnections.AccountFINANCIAL_CONNECTIONS_AUTHORIZATION_EXPECTED_DEACTIVATION_DATE_UPDATED and FINANCIAL_CONNECTIONS_AUTHORIZATION_UPCOMING_DEACTIVATION with resource FinancialConnections.AuthorizationThis release does not change the pinned API version. It's still 2026-06-24.dahlia.
This release does not change the pinned API version. It's still 2026-06-24.dahlia.
We're releasing it as a major out of an abundance of caution, but it should be functionally a patch release for most users. See below.
ErrorObject
ErrorObject were typed as string when many of them should have been null|string. If you (or your typechecker) were treating these as plain strings, you'll need to be more defensive in your code.This release changes the pinned API version to 2026-06-24.preview.
This release changes the pinned API version to 2026-06-24.preview.
redaction on Card, Charge, Checkout.Session, Customer, Issuing.Authorization, Issuing.Card, Issuing.Cardholder, Issuing.Dispute, Issuing.Transaction, PaymentIntent, PaymentMethod, SetupIntent, Source, and Tokendisclaimer_variant on Capital.FinancingOffer and Capital.FinancingSummary.detailsactive on FinancialConnections.Account.status_details and FinancialConnections.Authorization.status_detailsinstitution_requirement on enum FinancialConnections.Account.status_details.inactive.causeFinancialConnections\Session.create().$params.limit.accounts from longInteger to emptyable(longInteger)pause on Invoice.create_preview().$params.subscription_detailsatispay on enum QuotePreviewInvoice.payment_settings.payment_method_typesrelease_details on Reserve.Holdbuyer_id on SharedPayment.GrantedToken.payment_method_details.bizum and SharedPayment.GrantedToken.payment_method_details.blikfingerprint on SharedPayment.GrantedToken.payment_method_details.pixmoney_manager on enums EventsV2CoreAccountLinkReturnedEvent.configurations, V2.Core.AccountLink.use_case.account_onboarding.configurations, and V2.Core.AccountLink.use_case.account_update.configurationsmoney_manager on enum V2.Core.Account.applied_configurationsstorer from enum V2.Core.Account.applied_configurationsmoney_manager on V2.Core.Account.configuration, V2.Core.Account.identity.attestations.terms_of_service, V2\Core\Account.create().$params.configuration, V2\Core\Account.create().$params.identity.attestation.terms_of_service, V2\Core\Account.update().$params.configuration, and V2\Core\AccountToken.create().$params.identity.attestation.terms_of_servicestorer on V2.Core.Account.configuration, V2.Core.Account.identity.attestations.terms_of_service, V2\Core\Account.create().$params.configuration, V2\Core\Account.create().$params.identity.attestation.terms_of_service, V2\Core\Account.update().$params.configuration, and V2\Core\AccountToken.create().$params.identity.attestation.terms_of_servicebusiness_storage.inbound.eur, business_storage.inbound.gbp, business_storage.inbound.usd, business_storage.outbound.eur, business_storage.outbound.gbp, business_storage.outbound.usd, received_credits.bank_accounts, and received_debits.bank_accounts on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capabilitymoney_manager on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].configuration and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].configurationmaximum_rps on V2.Core.BatchJob and V2\Core\BatchJob.create().$paramsbic on V2.MoneyManagement.FinancialAddress.credentials.us_bank_accountswift_code on V2.MoneyManagement.FinancialAddress.credentials.us_bank_accountprocessing on V2.MoneyManagement.OutboundPayment.status_details and V2.MoneyManagement.OutboundTransfer.status_detailsfx_rate_drift_exceeded_after_review, payout_method_amount_limit_exceeded, and review_rejected on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reasonfx_rate_drift_exceeded_after_review and review_rejected on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reasonaccount_holder_name on V2.MoneyManagement.ReceivedCredit.bank_transfer.us_bank_accountcapability_inactive on enum V2.MoneyManagement.ReceivedDebit.status_details.failed.reasonstatuses on V2\MoneyManagement\FinancialAccount.all().$paramsstatus on V2\MoneyManagement\FinancialAccount.all().$paramsV2\Core\BatchJob.create().$params.metadata to be optionalV2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationMoneyManagerUpdatedEvent with related object V2.Core.AccountV2MoneyManagementOutboundPaymentUnderReviewEvent with related object V2.MoneyManagement.OutboundPaymentV2MoneyManagementOutboundTransferUnderReviewEvent with related object V2.MoneyManagement.OutboundTransferV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.Accountanomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on QuotePreviewInvoice.last_finalization_errorThis release changes the pinned API version to 2026-07-08.preview.
This release changes the pinned API version to 2026-07-08.preview.
activate_gift_card, cashout_gift_card, check_gift_card_balance, and reload_gift_card methods on resource Terminal.Readeraggregation_period on Billing.AlertRecoveredmass_transit_parking_tax and parking_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typeadministrative_address and principal_place_of_business on Account.companybnp_paribas, citibank, and mbsb_bank on enums Charge.payment_method_details.fpx.bank, ConfirmationToken.payment_method_preview.fpx.bank, PaymentAttemptRecord.payment_method_details.fpx.bank, PaymentMethod.fpx.bank, PaymentRecord.payment_method_details.fpx.bank, and SharedPayment.GrantedToken.payment_method_details.fpx.bankaddress_collection_precision on Checkout.Session.automatic_taxtax_id on Checkout.Session.collected_informationtax_ids on Checkout.Session.collected_informationsetup_future_usage on Checkout.Session.payment_method_options.payco, Checkout.Session.payment_method_options.samsung_pay, PaymentIntent.confirm().$params.payment_method_option.paypay, PaymentIntent.create().$params.payment_method_option.paypay, PaymentIntent.payment_method_options.payco, PaymentIntent.payment_method_options.paypay, PaymentIntent.payment_method_options.samsung_pay, and PaymentIntent.update().$params.payment_method_option.paypaynetwork on Dispute.payment_method_details.cardrequire_payment_method_support on FinancialConnections.Session.filtersnetwork_data on Issuing.Authorization.request_history[]acquiring_institution_country, acquiring_institution_id, retrieval_reference_number, routed_network, and trace_id on Issuing.Transaction.network_datacustom_fields, description, and footer on Quote.invoice_settings, QuotePreviewSubscriptionSchedule.default_settings.invoice_settings, QuotePreviewSubscriptionSchedule.phases[].invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, and SubscriptionSchedule.phases[].invoice_settingspaypay on SetupAttempt.payment_method_detailsmass_transit_parking_tax and parking_tax on Tax.Registration.country_options.usmass_transit_parking_tax and parking_tax on enum Tax.Registration.country_options.us.typegift_card_brand on Terminal\Reader.collect_payment_method().$params.collect_config and Terminal\Reader.process_payment_intent().$params.process_configactivate_gift_card, cashout_gift_card, check_gift_card_balance, deactivate_gift_card, and reload_gift_card on Terminal.Reader.actionactivate_gift_card, cashout_gift_card, check_gift_card_balance, deactivate_gift_card, and reload_gift_card on enum Terminal.Reader.action.typestatus_transitions on V2.Billing.Contractone_time_fees on V2.Billing.Contract and V2\Billing\Contract.create().$paramsstatus_details on V2.Billing.Contractid and priority on V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[]pricing_override on V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[]tiering_mode and tiers on V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[].overwrite_price, V2\Billing\Contract.create().$params.pricing_line.pricing.price_detail.pricing_override.overwrite_price, V2\Billing\Contract.update().$params.pricing_line_action.add.pricing.price_detail.pricing_override.overwrite_price, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.add.overwrite_price, and V2\Billing\Contract.update().$params.pricing_override_action.add.overwrite_pricemultiply_pricing on V2.Billing.Contract.pricing_overrides.data[], V2\Billing\Contract.create().$params.pricing_override, and V2\Billing\Contract.update().$params.pricing_override_action.addmultiplier on V2.Billing.Contract.pricing_overrides.data[], V2\Billing\Contract.create().$params.pricing_override, and V2\Billing\Contract.update().$params.pricing_override_action.addV2.Billing.Contract.pricing_overrides.data[].type, V2\Billing\Contract.create().$params.pricing_override.type, and V2\Billing\Contract.update().$params.pricing_override_action.add.type from literal('multiplier') to literal('multiply_pricing')related_network_object on V2.Core.Account and V2\Core\Account.all().$paramsnetwork_business_profile_wallet on enum V2.Core.Account.configuration.recipient.default_outbound_destination.typenetwork_business_profile_wallet on V2.MoneyManagement.PayoutMethodnetwork_business_profile_wallet on enum V2.MoneyManagement.PayoutMethod.typestripe_network_transfer on V2.MoneyManagement.ReceivedCreditstripe_network_transfer on enum V2.MoneyManagement.ReceivedCredit.typeV2\Billing\Contract.create().$params.pricing_line.ends_at.type, V2\Billing\Contract.create().$params.pricing_line.pricing.price_detail.pricing_override.ends_at.type, V2\Billing\Contract.create().$params.pricing_override.ends_at.type, and V2\Billing\Contract.update().$params.pricing_line_action.add.pricing.price_detail.pricing_override.ends_at.type from enum('contract_end'|'timestamp') to literal('timestamp')V2\Billing\Contract.create().$params.pricing_line.pricing.price_detail.pricing_override.starts_at.type, V2\Billing\Contract.create().$params.pricing_line.starts_at.type, V2\Billing\Contract.create().$params.pricing_override.starts_at.type, and V2\Billing\Contract.update().$params.pricing_line_action.add.pricing.price_detail.pricing_override.starts_at.type from enum('contract_start'|'timestamp') to literal('timestamp')V2\Billing\Contract.create().$params.pricing_override.priority and V2\Billing\Contract.update().$params.pricing_override_action.add.priority to be optionalV2\Billing\Contract.update().$params.pricing_line_action.add.ends_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.ends_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.add.ends_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.update.ends_at.type, V2\Billing\Contract.update().$params.pricing_override_action.add.ends_at.type, and V2\Billing\Contract.update().$params.pricing_override_action.update.ends_at.type from enum('billing_period_end'|'timestamp') to literal('timestamp')V2\Billing\Contract.update().$params.pricing_line_action.add.starts_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.add.starts_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.update.starts_at.type, V2\Billing\Contract.update().$params.pricing_line_action.update.starts_at.type, V2\Billing\Contract.update().$params.pricing_override_action.add.starts_at.type, and V2\Billing\Contract.update().$params.pricing_override_action.update.starts_at.type from enum('billing_period_start'|'timestamp') to literal('timestamp')V2BillingContractActivatedEvent, V2BillingContractCanceledEvent, V2BillingContractCreatedEvent, V2BillingContractEndedEvent, and V2BillingContractUpdatedEvent with related object V2.Billing.ContractThis release changes the pinned API version to 2026-07-01.preview.
This release changes the pinned API version to 2026-07-01.preview.
Crypto.CustomerConsumerWallet, Crypto.CustomerPaymentToken, Crypto.Customer, Crypto.OnrampSession, and Crypto.OnrampTransactionLimitsall and retrieve methods on resource Crypto.Customerall, checkout, create, quote, and retrieve methods on resource Crypto.OnrampSessionretrieve method on resource Crypto.OnrampTransactionLimitselectronic_commerce_indicator on Charge.payment_method_details.cardamount_received and amount_requested on Charge.payment_method_details.crypto, PaymentAttemptRecord.payment_method_details.crypto, and PaymentRecord.payment_method_details.cryptofingerprint on Charge.payment_method_details.gift_card, PaymentAttemptRecord.payment_method_details.gift_card, and PaymentRecord.payment_method_details.gift_cardaddress_collection_precision on Checkout\Session.create().$params.automatic_taxsubscription on Checkout.Session.items[]deactivation on GiftCardOperationdeactivation from enum GiftCardOperation.typemerchant_amount_exchange_rate on Issuing.Authorization and Issuing.Transactiondevice_id on Issuing.Authorization.token_details.network_data.device and Issuing.Token.network_data.deviceprogram on Issuing.Cardpayment_method_details on PaymentAttemptRecord.report_failed().$params and PaymentRecord.report_payment_attempt_failed().$paramsreason on PaymentAttemptRecord.report_refund().$params and PaymentRecord.report_refund().$paramsamount_reconciliation on PaymentIntent.confirm().$params.payment_method_option.crypto, PaymentIntent.create().$params.payment_method_option.crypto, PaymentIntent.payment_method_options.crypto, and PaymentIntent.update().$params.payment_method_option.cryptoconnect_permissions and permissions on V2.Iam.ApiKey, V2\Iam\ApiKey.create().$params, and V2\Iam\ApiKey.update().$paramscredit on V2.MoneyManagement.FinancialAccountcredit on enum V2.MoneyManagement.FinancialAccount.typecurrency_required on enum V2.MoneyManagement.PayoutIntent.next_action.handle_failure.failure_reasonissuing_authorization, issuing_transaction, and platform_funded_credit_transaction on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.categoryaccount, issuing_authorization, issuing_dispute, and issuing_transaction on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flowissuing_authorization, issuing_dispute, and issuing_transaction on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.typeV2\MoneyManagement\FinancialAccount.create().$params.type from literal('storage') to enum('credit'|'storage')expires_at on V2\Iam\ApiKey.create().$paramsOne column per quarter.