stripe/stripe-php

• #2120 Update generated code for private-preview
  • Add support for new resources Billing.FeedbackOption and PaymentPlan
  • ⚠️ Remove support for resource Billing.FeedbackOptions
  • Add support for all, create, retrieve, and update methods on resource PaymentPlan
  • Add support for update method on resource V2.MoneyManagement.Transaction
  • Add support for wechat_pay_payments on Account.create().$params.setting, Account.settings, and Account.update().$params.setting
  • ⚠️ Change type of BillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options from $Billing.FeedbackOptions to $Billing.FeedbackOption
  • Change BillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options to be required
  • Add support for subscription_pause on BillingPortal.Session.flow
  • Add support for new value subscription_pause on enum BillingPortal.Session.flow.type
  • Add support for new value usdt on enum Crypto.OnrampSession.transaction_details.destination_currencies
  • Add support for new value usdt on enum Crypto.OnrampSession.transaction_details.destination_currency
  • Add support for active_entitlements on CustomerSession.components
  • Add support for shared_payment_issued_token on DelegatedCheckout\RequestedSession.confirm().$params
  • Add support for new values payment_plan.created, payment_plan.installment_due, payment_plan.installment_paid, payment_plan.installment_will_be_due, and payment_plan.updated on enum Event.type
  • Add support for managed_payments on Invoice.create().$params, InvoiceItem.create().$params, InvoiceItem, Invoice, and QuotePreviewInvoice
  • Add support for payment_plan on Invoice
  • Add support for estimated_fee_details and estimated_fee on Issuing.Authorization.pending_request.hold_amount_details and Issuing.Authorization.request_history[].hold_amount_details
  • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • ⚠️ Change type of ProductCatalog.TrialOffer.end_behavior.transition.price from $Price to deletable($Price)
  • ⚠️ Change type of Subscription.cancellation_details.feedback_option from $Billing.FeedbackOptions to $Billing.FeedbackOption
  • Add support for cancel_at_period_end on Subscription.pending_update
  • Change Subscription.cancellation_details.feedback_option to be required
  • Add support for igic 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.sk
  • Add support for metadata 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().$params
  • Add support for tax_amount on V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[]
  • Add support for payout_method_options on V2.MoneyManagement.OutboundPaymentQuote.to and V2\MoneyManagement\OutboundPaymentQuote.create().$params.to
  • Change type of V2\Billing\Contract.update().$params.pricing_line_action.update.pricing.price_detail.pricing_override_action.update.metadata from string to emptyable(string)
  • Add support for snapshot events PAYMENT_PLAN_CREATED, PAYMENT_PLAN_INSTALLMENT_DUE, PAYMENT_PLAN_INSTALLMENT_PAID, PAYMENT_PLAN_INSTALLMENT_WILL_BE_DUE, and PAYMENT_PLAN_UPDATED with resource PaymentPlan

See the changelog for more details.

This release changes the pinned API version to 2026-08-12.preview.

• #2116 Update generated code for private-preview
  • Add support for new resource V2.Tax.OperationsResolveAddressResult
  • Add support for resolve_address method on resource V2.Tax.OperationsResolveAddressResult
  • Add support for confirm and fx_quote methods on resource V2.MoneyManagement.PayoutIntent
  • ⚠️ Add support for new value partner_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[].code
  • ⚠️ Remove support for values partner_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[].code
  • Add support for customer_update on BillingPortal.Session.flow
  • Add support for new value customer_update on enum BillingPortal.Session.flow.type
  • Add support for funding_source_group on Charge.payment_method_details.link
  • ⚠️ Remove support for pricing_group on Charge.payment_method_details.link
  • Add support for new value celo on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value celo on enum Crypto.OnrampSession.transaction_details.destination_network
  • Add support for new value celo on enum Crypto.OnrampSession.transaction_details.destination_networks
  • Add support for celo on Crypto.OnrampSession.transaction_details.wallet_addresses
  • Add support for customer_portal on CustomerSession.components
  • Add support for applied_to_invoice and type on CustomerBalanceTransaction.create().$params
  • Add support for classification_state and enrichment_state on FinancialConnections.Account
  • Add support for country on FinancialConnections.Session.filters
  • Add support for classifications and enrichments on FinancialConnections.Transaction
  • Add support for customer_balance on Invoice and QuotePreviewInvoice
  • Add support for billie on Invoice.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, and Subscription.payment_settings.payment_method_options
  • Add support for new values billie, paypay, and vipps on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_types
  • Add support for hold_amount_details and hold_amount on Issuing.Authorization.pending_request and Issuing.Authorization.request_history[]
  • Add support for new values hu and ro on enum Issuing.Cardholder.preferred_locales
  • Add support for network_decline_code on PaymentAttemptRecord.report_failed().$params.payment_method_detail.card and PaymentRecord.report_payment_attempt_failed().$params.payment_method_detail.card
  • Add support for setup_future_usage on PaymentIntent.payment_method_options.sequra
  • Add support for status on QuotePreviewSubscriptionSchedule.pause_schedules[].pause, QuotePreviewSubscriptionSchedule.pause_schedules[].resume, SubscriptionSchedule.pause_schedules[].pause, and SubscriptionSchedule.pause_schedules[].resume
  • Change SubscriptionSchedule.create().$params.pause_schedule.pause to be optional
  • Change type of SubscriptionSchedule.update().$params.pause_schedule.resume from pause_schedule_update_resume_params to emptyable(pause_schedule_update_resume_params)
  • Add support for 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[]
  • ⚠️ Change type of 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')
  • Add support for confirmation_method on V2.MoneyManagement.PayoutIntent and V2\MoneyManagement\PayoutIntent.create().$params
  • Add support for estimated_fees and fx_quote on V2.MoneyManagement.PayoutIntent
  • Add support for debited on V2.MoneyManagement.PayoutIntent.from
  • Add support for confirm on V2.MoneyManagement.PayoutIntent.next_action
  • ⚠️ Change type of V2.MoneyManagement.PayoutIntent.next_action.type from literal('handle_failure') to enum('confirm'|'handle_failure')
  • Add support for credited on V2.MoneyManagement.PayoutIntent.to
  • Add support for event notification V1BalanceSettingsUpdatedEvent with related object BalanceSettings
  • Add support for event notification V1BillingCreditBalanceTransactionCreatedEvent with related object Billing.CreditBalanceTransaction
  • Add support for event notifications V1BillingCreditGrantCreatedEvent and V1BillingCreditGrantUpdatedEvent with related object Billing.CreditGrant
  • Add support for event notifications V1BillingMeterCreatedEvent, V1BillingMeterDeactivatedEvent, V1BillingMeterReactivatedEvent, and V1BillingMeterUpdatedEvent with related object Billing.Meter
  • Add support for event notifications V1FinancialConnectionsAccountAccountNumbersUpdatedEvent, V1FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, V1FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, V1FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent, and V1FinancialConnectionsAccountUpcomingDeactivationEvent with related object FinancialConnections.Account
  • Add support for event notification V1InvoicePaymentAttemptRequiredEvent with related object Invoice
  • Add support for error type FxQuoteNeedsRefreshException

See the changelog for more details.

• #2126 Don't emit agent hint during tests. Fixes #2125

See the changelog for more details.

• #2126 Don't emit agent hint during tests. Fixes #2125

• #2119 Surface object property on EventNotification

• #2117 Emit Claude Code plugin hint at module load time

• #2115 Fix v2 timestamp phpdoc type annotations (#2114)

• #2105 add/adjust event parsing helpers

  • Added methods that return their respective 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)
  • Added 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

See the changelog for more details.

• #2119 Surface object property on EventNotification

• #2117 Emit Claude Code plugin hint at module load time

• #2115 Fix v2 timestamp phpdoc type annotations (#2114)

• #2105 add/adjust event parsing helpers

  • Added methods that return their respective 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)
  • Added 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.

• #2090 Update generated code for beta
  • Add support for all and retrieve methods on resource ProductCatalog.TrialOffer
  • Add support for tax_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.tax
  • ⚠️ Remove support for taxes 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.tax
  • Add support for tax_id on Checkout.Session.collected_information
  • ⚠️ Remove support for tax_ids on Checkout.Session.collected_information
  • Add support for mode on FinancialConnections.Session.manual_entry
  • Add support for name on Issuing\Cardholder.update().$params
  • Add support for new value ic_nif on enums Order.tax_details.tax_ids[].type and QuotePreviewInvoice.customer_tax_ids[].type
  • Add support for new values alipay and mb_way on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Add support for custom_fields, description, and footer on QuotePreviewSubscriptionSchedule.default_settings.invoice_settings and QuotePreviewSubscriptionSchedule.phases[].invoice_settings
  • Add support for trial on QuotePreviewSubscriptionSchedule.phases[]
  • ⚠️ Remove support for 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_details
  • ⚠️ Remove support for values acss_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.type
  • Add support for use_stripe_sdk on SharedPayment.IssuedToken and SharedPayment\IssuedToken.create().$params
  • Add support for redirect_to_url on SharedPayment.IssuedToken.next_action
  • ⚠️ Change type of SharedPayment.IssuedToken.next_action.type from literal('use_stripe_sdk') to enum('redirect_to_url'|'use_stripe_sdk')
  • Add support for livemode on Tax.Location
  • Add support for source on V2.Iam.ActivityLog.details.user_roles
  • Add support for payout on V2.MoneyManagement.ReceivedCredit.balance_transfer
  • ⚠️ Remove support for payout_v1 on V2.MoneyManagement.ReceivedCredit.balance_transfer
  • Add support for new value payout on enum V2.MoneyManagement.ReceivedCredit.balance_transfer.type
  • ⚠️ Change V2.MoneyManagement.ReceivedDebit.bank_transfer.us_bank_account to be optional

See the changelog for more details.

• #2108 Update generated code for private-preview
  • Add support for new resource Billing.FeedbackOptions
  • Add support for sequra_payments on Account.capabilities
  • Add support for feedback_options on BillingPortal.Configuration.features.subscription_cancel.cancellation_reason
  • Add support for sequra 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_details
  • Add support for retrieval_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_present
  • Add support for pricing_group on Charge.payment_method_details.link
  • Add support for tax_rates on Checkout.Session.shipping_options[], Checkout\Session.create().$params.shipping_option, and Checkout\Session.update().$params.shipping_option
  • Add support for new value daikin on enums Checkout.Session.automatic_surcharge.provider and PaymentLink.automatic_surcharge.provider
  • Add support for funding_types_blocked on Checkout.Session.payment_method_options.card.restrictions
  • Add support for new value sequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for healthcare 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_detail
  • Change type of Issuing.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')
  • Add support for is_anomalous on PaymentAttemptRecord.report_guaranteed().$params
  • Add support for new value sequra on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for aade_data on PaymentIntent.payment_method_options.card_present
  • Change Radar.PaymentEvaluation.payment_details.payment_method_details.card.first6 to be required
  • Change Radar.PaymentEvaluation.payment_details.payment_method_details.card.last4 to be required
  • Add support for feedback_option on Subscription.cancellation_details
  • Add support for application on V2.Payments.OffSessionPayment
  • Add support for status on V2\MoneyManagement\FinancialAccountStatement.all().$params
  • Change V2\Billing\Contract.create().$params.pricing_lines to be optional

See the changelog for more details.

This release changes the pinned API version to 2026-07-29.preview.

• #2104 Update generated code for private-preview
  • Add support for new resources V2.MoneyManagement.ReceivedDebitMandate, V2.Risk.Inquiry, V2.Signals.AccountActivity, and V2.Signals.AccountEvaluation
  • Add support for create and retrieve methods on resource V2.Signals.AccountEvaluation
  • Add support for create, delete, and retrieve methods on resource V2.Signals.AccountActivity
  • Add support for all, retrieve, and update methods on resource V2.Risk.Inquiry
  • Add support for all, cancel, and retrieve methods on resource V2.MoneyManagement.ReceivedDebitMandate
  • Add support for rate_cards on Billing.CreditGrant.applicability_config.scope, Billing\CreditBalanceSummary.retrieve().$params.filter.applicability_scope, and Billing\CreditGrant.create().$params.applicability_config.scope
  • ⚠️ Change type of ConfirmationToken.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')
  • Add support for new value tempo on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value tempo on enum Crypto.OnrampSession.transaction_details.destination_network
  • Add support for new value tempo on enum Crypto.OnrampSession.transaction_details.destination_networks
  • Add support for tempo on Crypto.OnrampSession.transaction_details.wallet_addresses
  • Add support for new value try_again_later on enum GiftCardOperation.failure_code
  • Add support for healthcare on Issuing.Authorization
  • Add support for product_code on Issuing.Card, Issuing\Card.create().$params, and Issuing\Card.update().$params
  • Add support for product_graduation_state on Issuing.Card
  • Add support for cvc and number on Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.card
  • Change Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.card.first6 to be optional
  • Change Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail.card.last4 to be optional
  • Add support for card on Radar.PaymentEvaluation.payment_details.payment_method_details
  • ⚠️ Change type of Terminal\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')
  • Add support for gift_card on Terminal\Reader.present_payment_method().$params
  • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
  • ⚠️ Change type of V2.Core.AccountEvaluation.evaluations_triggered from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')
  • Add support for gross_settlement on V2.Core.Account.configuration.merchant, V2\Core\Account.create().$params.configuration.merchant, and V2\Core\Account.update().$params.configuration.merchant
  • ⚠️ Change type of V2.MoneyManagement.DebitDispute.bank_transfer.network from literal('ach') to enum('ach'|'bacs')
  • Add support for new values beneficiary_unrecognized, mandate_canceled_by_stripe, mandate_canceled, no_advance_notice, originator_requested, and signature_invalid on enum V2.MoneyManagement.DebitDispute.bank_transfer.reason
  • ⚠️ Remove support for managed_by on V2.MoneyManagement.FinancialAccount
  • Add support for payout_intent on V2.MoneyManagement.OutboundPayment
  • Add support for settles_at on V2.MoneyManagement.ReceivedDebit
  • Add support for gb_bank_account on V2.MoneyManagement.ReceivedDebit.bank_transfer
  • ⚠️ Change type of V2.MoneyManagement.ReceivedDebit.bank_transfer.origin_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')
  • ⚠️ Change type of V2.MoneyManagement.ReceivedDebit.bank_transfer.payment_method_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')
  • Add support for new value scheduled on enum V2.MoneyManagement.ReceivedDebit.status
  • Add support for new value no_mandate on enum V2.MoneyManagement.ReceivedDebit.status_details.failed.reason
  • Add support for target_date on V2.Payments.OffSessionPayment and V2\Payments\OffSessionPayment.create().$params
  • Add support for account_evaluation, fraudulent_website, payment_delinquency_exposure, user_account_sharing, and user_multi_accounting on V2.Signals.AccountSignal
  • Add support for new values fraudulent_website, user_account_sharing, and user_multi_accounting on enum V2.Signals.AccountSignal.type
  • Change type of V2\MoneyManagement\FinancialAddressDebitSimulation.debit().$params.network from literal('ach') to enum('ach'|'bacs')
  • Add support for received_debit_mandate on V2\MoneyManagement\ReceivedDebit.all().$params
  • ⚠️ Remove support for payout_intent on V2\MoneyManagement\OutboundPayment.create().$params
  • Change type of V2\Core\AccountEvaluation.create().$params.signals from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')
  • ⚠️ Remove support for id on EventsV2SignalsAccountSignalFraudulentMerchantReadyEvent
  • Add support for event notifications V2MoneyManagementReceivedDebitCreatedEvent and V2MoneyManagementReceivedDebitScheduledEvent with related object V2.MoneyManagement.ReceivedDebit
  • Add support for event notifications V2MoneyManagementReceivedDebitMandateCanceledEvent, V2MoneyManagementReceivedDebitMandateCreatedEvent, V2MoneyManagementReceivedDebitMandateExpiredEvent, V2MoneyManagementReceivedDebitMandatePendingCancellationEvent, and V2MoneyManagementReceivedDebitMandateUpdatedEvent with related object V2.MoneyManagement.ReceivedDebitMandate
  • Add support for event notification V2SignalsAccountEvaluationCompleteEvent with related object V2.Signals.AccountEvaluation
  • Add support for event notifications V2SignalsAccountSignalFraudulentWebsiteReadyEvent and V2SignalsAccountSignalPaymentDelinquencyExposureReadyEvent with related object V2.Signals.AccountSignal

See the changelog for more details.

• #2110 suppress warnings when we can't access a directory

See the changelog for more details.

• #2110 suppress warnings when we can't access a directory

This release changes the pinned API version to 2026-07-29.dahlia.

• #2106 Update generated code
  • Add support for new resource FinancialConnections.Authorization
  • Add support for unreject method on resource Account
  • Add support for all method on resource PaymentRecord
  • Add support for new values mass_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_type
  • Add support for new value chaps on enums FundingInstructions.bank_transfer.financial_addresses[].supported_networks and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networks
  • Add support for smart_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.feature
  • Add support for administrative_address and principal_place_of_business on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.company
  • Add support for sepa_debit_payments on Account.update().$params.setting
  • Remove support for proof_of_registration on Account.create().$params.document. This field was limited-use and is being deprecated.
  • Add support for payouts_action on Account.reject().$params
  • Add support for new value 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.result
  • Add support for new values bnp_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.bank
  • Remove support for dynamic_tax_rates on Checkout\Session.create().$params.line_item. This field was limited-use and is being deprecated.
  • Add support for 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_datum
  • Add support for new value ic_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.type
  • Add support for network on Dispute.payment_method_details.card
  • Add support for new values financial_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.type
  • Add support for limits and manual_entry on FinancialConnections.Session and FinancialConnections\Session.create().$params
  • Add support for require_payment_method_support on FinancialConnections.Session.filters and FinancialConnections\Session.create().$params.filter
  • Add support for bank_account_token on FinancialConnections.Session
  • Add support for metadata on Invoice.create_preview().$params.subscription_detail
  • Add support for new values alipay and mb_way on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for new value stripe_internal_error on enum Issuing.Authorization.request_history[].reason
  • Add support for business_name on Issuing.Card.shipping, Issuing\Card.create().$params.shipping, and Issuing\Card.update().$params.shipping
  • Add support for new value correos on enum Issuing.Card.shipping.carrier
  • Add support for allowed_payment_method_types on PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, PaymentIntent, SetupIntent.confirm().$params, SetupIntent.create().$params, SetupIntent.update().$params, and SetupIntent
  • Add support for referrer on PaymentIntent.confirm().$params.radar_option and PaymentIntent.create().$params.radar_option
  • Add support for consent_collection and shipping_options on PaymentLink.update().$params
  • Add support for custom_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_setting
  • Add support for customer_account and customer on Refund
  • Add support for payment_method on Refund and Topup
  • Add support for trial on SubscriptionSchedule.phases[]
  • Add support for mass_transit_parking_tax and parking_tax on Tax.Registration.country_options.us and Tax\Registration.create().$params.country_option.me
  • Add support for new values mass_transit_parking_tax and parking_tax on enum Tax.Registration.country_options.us.type
  • Add support for initiated_by and payment_method_options on Topup
  • Add support for additional_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_detail
  • Add support for snapshot events FINANCIAL_CONNECTIONS_ACCOUNT_EXPECTED_DEACTIVATION_DATE_UPDATED, FINANCIAL_CONNECTIONS_ACCOUNT_SUPPORTED_PAYMENT_METHOD_TYPES_UPDATED, and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_DEACTIVATION with resource FinancialConnections.Account
  • Add support for snapshot events FINANCIAL_CONNECTIONS_AUTHORIZATION_EXPECTED_DEACTIVATION_DATE_UPDATED and FINANCIAL_CONNECTIONS_AUTHORIZATION_UPCOMING_DEACTIVATION with resource FinancialConnections.Authorization

See the changelog for more details.

This release changes the pinned API version to 2026-07-29.dahlia.

• #2106 Update generated code
  • Add support for new resource FinancialConnections.Authorization
  • Add support for unreject method on resource Account
  • Add support for all method on resource PaymentRecord
  • Add support for new values mass_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_type
  • Add support for new value chaps on enums FundingInstructions.bank_transfer.financial_addresses[].supported_networks and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networks
  • Add support for smart_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.feature
  • Add support for administrative_address and principal_place_of_business on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.company
  • Add support for sepa_debit_payments on Account.update().$params.setting
  • Remove support for proof_of_registration on Account.create().$params.document. This field was limited-use and is being deprecated.
  • Add support for payouts_action on Account.reject().$params
  • Add support for new value 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.result
  • Add support for new values bnp_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.bank
  • Remove support for dynamic_tax_rates on Checkout\Session.create().$params.line_item. This field was limited-use and is being deprecated.
  • Add support for 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_datum
  • Add support for new value ic_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.type
  • Add support for network on Dispute.payment_method_details.card
  • Add support for new values financial_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.type
  • Add support for limits and manual_entry on FinancialConnections.Session and FinancialConnections\Session.create().$params
  • Add support for require_payment_method_support on FinancialConnections.Session.filters and FinancialConnections\Session.create().$params.filter
  • Add support for bank_account_token on FinancialConnections.Session
  • Add support for metadata on Invoice.create_preview().$params.subscription_detail
  • Add support for new values alipay and mb_way on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for new value stripe_internal_error on enum Issuing.Authorization.request_history[].reason
  • Add support for business_name on Issuing.Card.shipping, Issuing\Card.create().$params.shipping, and Issuing\Card.update().$params.shipping
  • Add support for new value correos on enum Issuing.Card.shipping.carrier
  • Add support for allowed_payment_method_types on PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, PaymentIntent, SetupIntent.confirm().$params, SetupIntent.create().$params, SetupIntent.update().$params, and SetupIntent
  • Add support for referrer on PaymentIntent.confirm().$params.radar_option and PaymentIntent.create().$params.radar_option
  • Add support for consent_collection and shipping_options on PaymentLink.update().$params
  • Add support for custom_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_setting
  • Add support for customer_account and customer on Refund
  • Add support for payment_method on Refund and Topup
  • Add support for trial on SubscriptionSchedule.phases[]
  • Add support for mass_transit_parking_tax and parking_tax on Tax.Registration.country_options.us and Tax\Registration.create().$params.country_option.me
  • Add support for new values mass_transit_parking_tax and parking_tax on enum Tax.Registration.country_options.us.type
  • Add support for initiated_by and payment_method_options on Topup
  • Add support for additional_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_detail
  • Add support for snapshot events FINANCIAL_CONNECTIONS_ACCOUNT_EXPECTED_DEACTIVATION_DATE_UPDATED, FINANCIAL_CONNECTIONS_ACCOUNT_SUPPORTED_PAYMENT_METHOD_TYPES_UPDATED, and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_DEACTIVATION with resource FinancialConnections.Account
  • Add support for snapshot events FINANCIAL_CONNECTIONS_AUTHORIZATION_EXPECTED_DEACTIVATION_DATE_UPDATED and FINANCIAL_CONNECTIONS_AUTHORIZATION_UPCOMING_DEACTIVATION with resource FinancialConnections.Authorization

• #2103 Update generated code for private-preview
  • Add support for new resources Billing.AlertNotification and Crypto.DepositAddress
  • Add support for all, create, and retrieve methods on resource Crypto.DepositAddress
  • Add support for all method on resource Billing.AlertNotification
  • Add support for new values partner_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[].code
  • Add support for new value 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.result
  • Add support for vipps 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_datum
  • Add support for new value vipps on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value sui on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value sui on enum Crypto.OnrampSession.transaction_details.destination_network
  • Add support for new value sui on enum Crypto.OnrampSession.transaction_details.destination_networks
  • Add support for sui on Crypto.OnrampSession.transaction_details.wallet_addresses
  • Add support for use_stripe_sdk on DelegatedCheckout\RequestedSession.confirm().$params
  • Add support for new value mb_way on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_types
  • Add support for ev_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.card
  • ⚠️ Change type of PaymentIntent.allowed_payment_method_types from string to enum
  • Add support for new value vipps on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for tax_items on PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, and PaymentIntent.payment_details.lodging_data[].total.tax
  • ⚠️ Remove support for taxes on PaymentIntent.payment_details.car_rental_data[].total.tax, PaymentIntent.payment_details.flight_data[].total.tax, and PaymentIntent.payment_details.lodging_data[].total.tax
  • Change PaymentRecord.create().$params.closed to be optional
  • Change PaymentRecord.create().$params.funded to be optional
  • Add support for card on Radar\PaymentEvaluation.create().$params.payment_detail.payment_method_detail
  • ⚠️ Remove support for 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, 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_details
  • ⚠️ Add support for new value shop_pay on enum SharedPayment.GrantedToken.payment_method_details.type
  • ⚠️ Remove support for values acss_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.type
  • Add support for spend_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.stripe
  • Add support for new value commercial.stripe.spend_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new value payment_delinquency_exposure on enum V2.Signals.AccountSignal.type
  • Add support for new value commercial.stripe.spend_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

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.

• #2097 ⚠️ Correctly type properties on ErrorObject
  • the properties of 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.
  • to be clear: no runtime code has changed, we've just made the types more accurate. We didn't want to break any builds in a patch version, so this is released as a major
• #2098 Replace source hash with Telemetry UUID
• #2095 Remove unused Retry-After header support

• #2093 Add TStripeObject to iterator PHPDoc comments (fixes #2091)
  • Fixed: PHPStan no longer infers iterated Collection values as mixed; loop variables are now correctly typed as the collection's generic type parameter

This release changes the pinned API version to 2026-06-24.dahlia.

• #2088 Update generated code
  • Add support for release_details on Reserve.Hold
  • Add support for new value tax_fund on enum BalanceTransaction.type
  • Change Billing.CreditGrant.priority to be required
  • Add support for buyer_id on Charge.payment_method_details.bizum, ConfirmationToken.payment_method_preview.bizum, ConfirmationToken.payment_method_preview.blik, PaymentAttemptRecord.payment_method_details.bizum, PaymentMethod.bizum, PaymentMethod.blik, and PaymentRecord.payment_method_details.bizum
  • Add support for transaction_link_id on Charge.payment_method_details.card
  • Add support for new value sui on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • Add support for new value usdsui on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for fingerprint on Charge.payment_method_details.pix, ConfirmationToken.payment_method_preview.pix, PaymentMethod.pix, and SetupAttempt.payment_method_details.pix
  • Add support for sunbit on Checkout.Session.payment_method_options, Checkout\Session.create().$params.payment_method_option, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, and PaymentIntent.update().$params.payment_method_option
  • Add support for billing_cycle_anchor_config on Checkout\Session.create().$params.subscription_datum
  • Add support for wechat_pay on Checkout.Session.payment_method_options
  • Add support for mastercard_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and Dispute.update().$params.evidence.enhanced_evidence
  • Add support for new value mastercard_compliance on enum Dispute.enhanced_eligibility_types
  • Add support for status_details on FinancialConnections.Account
  • Add support for new value validated on enum Identity.VerificationSession.redaction.status
  • Add support for new value satispay on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • ⚠️ Remove support for stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.description and PaymentRecord.payment_method_details.card.description to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.iin and PaymentRecord.payment_method_details.card.iin to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.issuer and PaymentRecord.payment_method_details.card.issuer to be optional
  • Add support for setup_future_usage on PaymentIntent.confirm().$params.payment_method_option.satispay, PaymentIntent.create().$params.payment_method_option.satispay, PaymentIntent.payment_method_options.satispay, and PaymentIntent.update().$params.payment_method_option.satispay
  • Change PaymentRecord.report_refund().$params.refunded to be optional
  • Add support for satispay on SetupAttempt.payment_method_details
  • Add support for custom_fields, description, and footer on Subscription.create().$params.invoice_setting, Subscription.invoice_settings, and Subscription.update().$params.invoice_setting
  • Add support for payment_method_options and payment_method on Topup.create().$params
  • Add support for mode on V2.Commerce.ProductCatalogImport
  • Add support for new value promotion on enum V2.Commerce.ProductCatalogImport.feed_type
  • Add support for sunbit_payments on V2.Core.Account.configuration.merchant.capabilities, V2\Core\Account.create().$params.configuration.merchant.capability, and V2\Core\Account.update().$params.configuration.merchant.capability
  • Add support for crypto_money_manager and money_manager on V2\Core\Account.update().$params.identity.attestation.terms_of_service
  • ⚠️ Remove support for crypto_storer and storer on V2\Core\Account.update().$params.identity.attestation.terms_of_service
  • Add support for new value sunbit_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability
  • Add support for error codes anomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

• #2079 Add "source" field to user-agent header

This release changes the pinned API version to 2026-05-27.dahlia.

• #2072 Update generated code
  • Add support for new resource V2.Commerce.ProductCatalogImport
  • Add support for create and retrieve methods on resource V2.Commerce.ProductCatalogImport
  • Add support for bizum_payments and scalapay_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
  • Add support for automatic_transfer_rules_by_currency on BalanceSettings.payments.payouts and BalanceSettings.update().$params.payment.payout
  • Add support for start_of_day on BalanceSettings.payments.settlement_timing and BalanceSettings.update().$params.payment.settlement_timing
  • Add support for description on Charge.create().$params.transfer_datum, PaymentIntent.create().$params.transfer_datum, PaymentIntent.transfer_data, and PaymentIntent.update().$params.transfer_datum
  • Add support for bizum 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.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_datum, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_option
  • Add support for scalapay 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, Refund.destination_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datum
  • Add support for mandate on Charge.payment_method_details.twint, PaymentAttemptRecord.payment_method_details.twint, and PaymentRecord.payment_method_details.twint
  • Change type of Checkout\Session.create().$params.payment_method_option.twint.setup_future_usage, PaymentIntent.confirm().$params.payment_method_option.twint.setup_future_usage, PaymentIntent.create().$params.payment_method_option.twint.setup_future_usage, and PaymentIntent.update().$params.payment_method_option.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • ⚠️ Change type of Checkout.Session.payment_method_options.twint.setup_future_usage and PaymentIntent.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for credited_items on InvoiceItem.proration_details
  • Add support for discountable on Invoice.create_preview().$params.schedule_detail.phase.add_invoice_item, Subscription.create().$params.add_invoice_item, Subscription.update().$params.add_invoice_item, SubscriptionSchedule.create().$params.phase.add_invoice_item, SubscriptionSchedule.phases[].add_invoice_items[], and SubscriptionSchedule.update().$params.phase.add_invoice_item
  • Add support for billing_schedules on Invoice.create_preview().$params.subscription_detail, Subscription.create().$params, Subscription.update().$params, and Subscription
  • Add support for amount_paid_off_stripe on Invoice
  • Add support for new value twint on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for twint on Mandate.payment_method_details and SetupAttempt.payment_method_details
  • Add support for metadata on PaymentIntent.create().$params.transfer_datum, PaymentIntent.transfer_data, PaymentIntent.update().$params.transfer_datum, and Subscription.pending_update
  • Add support for payment_data on PaymentIntent.create().$params.transfer_datum, PaymentIntent.transfer_data, and PaymentIntent.update().$params.transfer_datum
  • Add support for new values bizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for blik_authorize on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for payment_method_options on PaymentLink.create().$params, PaymentLink.update().$params, and PaymentLink
  • Add support for new value bizum on enum PaymentLink.payment_method_types
  • Add support for active on PaymentMethodConfiguration.all().$params
  • Add support for billed_until on SubscriptionItem
  • Add support for discount and discounts on Subscription.pending_update
  • Add support for verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
  • Add support for api_error and print_content on Terminal.Reader.action
  • Add support for new value print_content on enum Terminal.Reader.action.type
  • Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.Reader.device_type
  • Add support for customer on TestHelpers\TestClock.create().$params
  • Add support for signer on V2.Core.Account.identity.business_details.documents.proof_of_registration, V2.Core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2\Core\Account.create().$params.identity.business_detail.document.proof_of_registration, V2\Core\Account.create().$params.identity.business_detail.document.proof_of_ultimate_beneficial_ownership, V2\Core\Account.update().$params.identity.business_detail.document.proof_of_registration, V2\Core\Account.update().$params.identity.business_detail.document.proof_of_ultimate_beneficial_ownership, V2\Core\AccountToken.create().$params.identity.business_detail.document.proof_of_registration, and V2\Core\AccountToken.create().$params.identity.business_detail.document.proof_of_ultimate_beneficial_ownership
  • Add support for azure_event_grid on V2.Core.EventDestination and V2\Core\EventDestination.create().$params
  • Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reason
  • Add support for new value azure_event_grid on enum V2.Core.EventDestination.type
  • Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImport
  • Add support for error codes payment_method_microdeposit_processing_error and siret_invalid on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2071 Emit warning when stripe-notify header is present in response

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

• #2056 Update generated code
  • Add support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component
  • Add support for app_distribution and sunbit_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
  • Add support for new values fee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.type
  • Add support for sunbit 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, 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_datum
  • Add support for new values phantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for location and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarna
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for managed_payments on Checkout.Session, Checkout\Session.create().$params, PaymentIntent, PaymentLink.create().$params, PaymentLink, SetupIntent, and Subscription
  • Add support for mandate_options on Checkout.Session.payment_method_options.pix, Checkout\Session.create().$params.payment_method_option.pix, PaymentIntent.confirm().$params.payment_method_option.pix, PaymentIntent.create().$params.payment_method_option.pix, PaymentIntent.payment_method_options.pix, and PaymentIntent.update().$params.payment_method_option.pix
  • Change type of Checkout\Session.create().$params.payment_method_option.pix.setup_future_usage, PaymentIntent.confirm().$params.payment_method_option.pix.setup_future_usage, PaymentIntent.create().$params.payment_method_option.pix.setup_future_usage, and PaymentIntent.update().$params.payment_method_option.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc 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.type
  • ⚠️ Change type of Checkout.Session.payment_method_options.pix.setup_future_usage and PaymentIntent.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for pix on 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_option
  • Add support for upi 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_option
  • Add support for new values pix and upi on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for card_presence on Issuing.Authorization
  • Add support for allowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.Cardholder.spending_controls, Issuing\Card.create().$params.spending_control, Issuing\Card.update().$params.spending_control, Issuing\Cardholder.create().$params.spending_control, and Issuing\Cardholder.update().$params.spending_control
  • Add support for new value fulfillment_error on enum Issuing.Card.cancellation_reason
  • Add support for new value fulfillment_error on enum Issuing.Card.replacement_reason
  • Add support for amount and currency on Mandate.multi_use
  • Add support for amount_to_confirm on PaymentIntent.confirm().$params
  • Add support for new value sunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for klarna_display_qr_code on PaymentIntent.next_action
  • Add support for new value sunbit on enum PaymentLink.payment_method_types
  • Add support for new values low, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_level
  • Add support for new value account on enum Radar.ValueList.item_type
  • Add support for moto on SetupAttempt.payment_method_details.card
  • Add support for pix_display_qr_code on SetupIntent.next_action
  • Add support for error codes action_blocked and approval_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2052 Fix 2D array parameter encoding
  • Fixes an issue encoding two-dimensional array request params where the SDK incorrectly flattens the array.

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

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

• ⚠️ Breaking change: #2038 Drop support for PHP < 7.2. This is also the last major version to support PHP 7.2 and 7.3. Please upgrade to 7.4+ before September 2026. See the versioning policy for more information.
• ⚠️ Breaking change: #2042 Preserve null values in v2 JSON request bodies
  • The SDK now preserves and sends null when set in V2 API metadata and params, enabling you to clear metadata entries and some unsettable properties for V2 APIs.
  • ⚠️ The Util::objectsToIds() method now has a required $serializeNull parameter to indicate if null values set in the object should be output in the resulting hash. This is relevant for V2 POST APIs to let callers clear emptyable values.
• #1917 Avoid using func_get_args
• #2011 Ensure that previous_attributes is always an instance of StripeObject
• #2033 Add runtime support for V2 int64 string-encoded fields

⚠️ Breaking changes due to changes in the Stripe API

• #2041 ⚠️ Throw an error when using the wrong webhook parsing method
• Generated changes from #2046, #2044, #2025
  • Add support for upi_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
  • Add support for upi 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, Mandate.payment_method_details, 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, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_datum, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_option
  • Add support for new value tempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • Add support for integration_identifier on Checkout.Session and Checkout\Session.create().$params
  • Add support for crypto on Checkout\Session.create().$params.payment_method_option
  • Add support for pending_invoice_item_interval on Checkout\Session.create().$params.subscription_datum
  • Add support for new values elements, embedded_page, form, and hosted_page on enum Checkout.Session.ui_mode
  • Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for metadata on CreditNote.create().$params.line, CreditNote.preview().$params.line, CreditNote.preview_lines().$params.line, and CreditNoteLineItem
  • Add support for quantity_decimal on Invoice.add_lines().$params.line, Invoice.create_preview().$params.invoice_item, Invoice.update_lines().$params.line, InvoiceItem.create().$params, InvoiceItem.update().$params, InvoiceItem, InvoiceLineItem.update().$params, and InvoiceLineItem
  • ⚠️ Add support for level on Issuing\Authorization.create().$params.risk_assessment.card_testing_risk and Issuing\Authorization.create().$params.risk_assessment.merchant_dispute_risk
  • ⚠️ Remove support for risk_level on Issuing\Authorization.create().$params.risk_assessment.card_testing_risk and Issuing\Authorization.create().$params.risk_assessment.merchant_dispute_risk
  • Add support for lifecycle_controls on Issuing.Card and Issuing\Card.create().$params
  • ⚠️ Change type of Issuing.Token.network_data.visa.card_reference_id from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to nullable(enum)
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to nullable(longInteger)
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to nullable(string)
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to nullable(boolean)
  • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • Add support for new value upi on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for new value upi on enum PaymentLink.payment_method_types
  • Add support for recommended_action and signals on Radar.PaymentEvaluation
  • ⚠️ Remove support for insights on Radar.PaymentEvaluation
  • Add support for new value crypto_fingerprint on enum Radar.ValueList.item_type
  • Add support for new value canceled_by_retention_policy on enum Subscription.cancellation_details.reason
  • ⚠️ Change type of V2.Core.EventDestination.events_from from enum('other_accounts'|'self') to string
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

• #2024 Add Stripe-Request-Trigger header
• #2022 Add agent information to UserAgent

This release changes the pinned API version to 2026-02-25.clover.

• #2016 Update generated code
  • Add support for new resources Reserve.Hold, Reserve.Plan, and Reserve.Release
  • Add support for location and reader on Charge.payment_method_details.card_present, Charge.payment_method_details.interac_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.interac_present, PaymentMethod.card.generated_from.payment_method_details.card_present, PaymentRecord.payment_method_details.card_present, and PaymentRecord.payment_method_details.interac_present
  • Add support for new value lk_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.type
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum File.purpose
  • Add support for new value pay_by_bank on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for display_name and service_user_number on Mandate.payment_method_details.bacs_debit
  • Change type of PaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to nullable(string)
  • Change type of PaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from nullable(string) to string
  • Add support for transaction_purpose on PaymentIntent.confirm().$params.payment_method_option.us_bank_account, PaymentIntent.create().$params.payment_method_option.us_bank_account, PaymentIntent.payment_method_options.us_bank_account, and PaymentIntent.update().$params.payment_method_option.us_bank_account
  • Add support for optional_items on PaymentLink.update().$params
  • Remove support for unused card_issuer_decline on Radar.PaymentEvaluation.insights
  • Add support for payment_behavior on SubscriptionItem.delete().$params
  • Add support for lk on Tax.Registration.country_options and Tax\Registration.create().$params.country_option
  • Add support for cellular and stripe_s710 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
  • Add support for new values simulated_stripe_s710 and stripe_s710 on enum Terminal.Reader.device_type
  • Add support for snapshot events RESERVE_HOLD_CREATED and RESERVE_HOLD_UPDATED with resource Reserve.Hold
  • Add support for snapshot events RESERVE_PLAN_CREATED, RESERVE_PLAN_DISABLED, RESERVE_PLAN_EXPIRED, and RESERVE_PLAN_UPDATED with resource Reserve.Plan
  • Add support for snapshot event RESERVE_RELEASE_CREATED with resource Reserve.Release
  • Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

This release changes the pinned API version to 2026-01-28.clover.

• #2001 Update generated code
  • Add support for new resource Radar.PaymentEvaluation
  • Add support for create method on resource Radar.PaymentEvaluation
  • Add support for adjustable_quantity on LineItem
  • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
  • Add support for new values reserve_hold and reserve_release on enum BalanceTransaction.type
  • Add support for new values 2.3.0 and 2.3.1 on enums Charge.payment_method_details.card.three_d_secure.version and SetupAttempt.payment_method_details.card.three_d_secure.version
  • Add support for new value adyen on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
  • Add support for new value ADYBNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value pl_nip 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.type
  • Change Invoice.payment_settings.payment_method_options.payto and Subscription.payment_settings.payment_method_options.payto to be required
  • Add support for enforce_arithmetic_validation on PaymentIntent.capture().$params.amount_detail, PaymentIntent.confirm().$params.amount_detail, PaymentIntent.create().$params.amount_detail, PaymentIntent.increment_authorization().$params.amount_detail, and PaymentIntent.update().$params.amount_detail
  • Add support for error on PaymentIntent.amount_details
  • Remove support for bgn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
  • Add support for topup on Treasury.ReceivedDebit.linked_flows
  • Add support for contact_phone on V2.Core.Account, V2\Core\Account.create().$params, V2\Core\Account.update().$params, and V2\Core\AccountToken.create().$params
  • Add support for registration_date 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_detail
  • Add support for new value gb_vat on enum V2.Core.Account.identity.business_details.id_numbers[].type
  • Add support for error code request_blocked on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2000 Add guidance for undocumented API parameters

• #1997 Update generated code
  • Add support for event notifications V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingDefaultsUpdatedEvent, V2CoreAccountIncludingFutureRequirementsUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, V2CoreAccountIncludingRequirementsUpdatedEvent, and V2CoreAccountUpdatedEvent with related object V2.Core.Account
  • Add support for event notification V2CoreAccountLinkReturnedEvent
  • Add support for event notifications V2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object V2.Core.AccountPerson
• #1984 Improve webhook signature validation doc block

This release changes the pinned API version to 2025-12-15.clover.

• #1975 Update generated code
  • Add support for new resources V2.Core.AccountLink, V2.Core.AccountPersonToken, V2.Core.AccountPerson, V2.Core.AccountToken, and V2.Core.Account
  • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
  • Add support for create method on resource V2.Core.AccountLink
  • Add support for all, close, create, retrieve, and update methods on resource V2.Core.Account
  • Add support for all, create, delete, retrieve, and update methods on resource V2.Core.AccountPerson
  • Add support for customer_account on Billing.CreditBalanceSummary, Billing.CreditGrant, BillingPortal.Session, BillingPortal\Session.create().$params, Billing\CreditBalanceSummary.retrieve().$params, Billing\CreditBalanceTransaction.all().$params, Billing\CreditGrant.all().$params, Billing\CreditGrant.create().$params, CashBalance, Checkout.Session, Checkout\Session.all().$params, Checkout\Session.create().$params, ConfirmationToken.payment_method_preview, CreditNote.all().$params, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSession.create().$params, CustomerSession, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.Session.account_holder, FinancialConnections\Account.all().$params.account_holder, FinancialConnections\Session.create().$params.account_holder, Invoice.all().$params, Invoice.create().$params, Invoice.create_preview().$params, InvoiceItem.all().$params, InvoiceItem.create().$params, InvoiceItem, Invoice, PaymentIntent.all().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, PaymentIntent, PaymentMethod.all().$params, PaymentMethod.attach().$params, PaymentMethod, PromotionCode.all().$params, PromotionCode.create().$params, PromotionCode, Quote.all().$params, Quote.create().$params, Quote.update().$params, Quote, SetupAttempt, SetupIntent.all().$params, SetupIntent.create().$params, SetupIntent.update().$params, SetupIntent, Subscription.all().$params, Subscription.create().$params, SubscriptionSchedule.all().$params, SubscriptionSchedule.create().$params, SubscriptionSchedule, Subscription, TaxId.all().$params.owner, TaxId.create().$params.owner, TaxId.owner, and TaxId
  • Add support for metadata on Checkout\Session.create().$params.line_item and LineItem
  • Add support for payto_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
  • Add support for signer on Account.create().$params.document.proof_of_registration, Account.create().$params.document.proof_of_ultimate_beneficial_ownership, Account.update().$params.document.proof_of_registration, and Account.update().$params.document.proof_of_ultimate_beneficial_ownership
  • Change BillingPortal\Session.create().$params.customer, Billing\CreditBalanceSummary.retrieve().$params.customer, Billing\CreditBalanceTransaction.all().$params.customer, Billing\CreditGrant.create().$params.customer, CustomerSession.create().$params.customer, InvoiceItem.create().$params.customer, PaymentMethod.attach().$params.customer, and Subscription.create().$params.customer to be optional
  • Add support for billing_cycle_anchor on BillingPortal.Configuration.features.subscription_update, BillingPortal\Configuration.create().$params.feature.subscription_update, and BillingPortal\Configuration.update().$params.feature.subscription_update
  • Add support for payto 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, 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, 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.update().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_datum, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_datum, 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_option
  • Add support for expected_debit_date on Charge.payment_method_details.acss_debit, Charge.payment_method_details.au_becs_debit, Charge.payment_method_details.bacs_debit, Charge.payment_method_details.nz_bank_account, Charge.payment_method_details.sepa_debit, Charge.payment_method_details.us_bank_account, PaymentAttemptRecord.payment_method_details.acss_debit, PaymentAttemptRecord.payment_method_details.au_becs_debit, PaymentAttemptRecord.payment_method_details.bacs_debit, PaymentAttemptRecord.payment_method_details.nz_bank_account, PaymentAttemptRecord.payment_method_details.sepa_debit, PaymentAttemptRecord.payment_method_details.us_bank_account, PaymentRecord.payment_method_details.acss_debit, PaymentRecord.payment_method_details.au_becs_debit, PaymentRecord.payment_method_details.bacs_debit, PaymentRecord.payment_method_details.nz_bank_account, PaymentRecord.payment_method_details.sepa_debit, and PaymentRecord.payment_method_details.us_bank_account
  • Add support for new value mollie on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
  • Add support for new value MLLENL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for line_items on Checkout\Session.update().$params
  • Add support for new value payto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for invoice on CustomerBalanceTransaction.all().$params
  • Add support for related_customer_account on Identity.VerificationSession, Identity\VerificationSession.all().$params, and Identity\VerificationSession.create().$params
  • Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable($Price)
  • Add support for new value payto on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for subtotal on InvoiceLineItem
  • Add support for authorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • Add support for new value payto on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Change PaymentIntent.transfer_data to be optional
  • Add support for new value payto on enum PaymentLink.payment_method_types
  • Add support for allow_redisplay on PaymentMethod.all().$params
  • Add support for reported_by on PaymentRecord
  • Change Product.tax_code to be optional
  • Add support for changes on V2.Core.Event
  • Add support for error code account_token_required_for_v2_account on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #1976 Updated bundled CA certs
• #1973 Remove deprecated usage of curl_close() for PHP versions > 8.0