Green Popups (formerly Layered Popups)

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

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

This release changes the pinned API version to 2025-11-17.clover.

• #1961 Update generated code
  • ⚠️ Remove gt, gte, lt, and lte on V2\Core\Event.all().$params in favor of created.
• #1958 Update v2 array parameter serialization to use indexed format
  • Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
• #1956 Update generated code
  • Add support for new resources Tax.Association and Terminal.OnboardingLink
  • Add support for find method on resource Tax.Association
  • Add support for create method on resource Terminal.OnboardingLink
  • Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
  • Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
  • Add support for new value finom 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 FNOMNL22 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 tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
  • Add support for created on CustomerBalanceTransaction.all().$params and InvoicePayment.all().$params
  • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.type
  • Add support for account_numbers on FinancialConnections.Account
  • Change type of FinancialConnections.Session.client_secret from string to nullable(string)
  • Add support for fraud_risk on Issuing\Authorization.create().$params.risk_assessment
  • Add support for latest_fraud_warning on Issuing.Card
  • Add support for hooks on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, PaymentIntent.update().$params, and PaymentIntent
  • Add support for mb_way and twint on Refund.destination_details
  • Add support for snapshot events FINANCIAL_CONNECTIONS_ACCOUNT_ACCOUNT_NUMBERS_UPDATED and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_ACCOUNT_NUMBER_EXPIRY with resource FinancialConnections.Account

• #1953 Update generated code
  • Add support for capture_method on PaymentIntent.confirm().$params.payment_method_option.card_present, PaymentIntent.create().$params.payment_method_option.card_present, PaymentIntent.payment_method_options.card_present, and PaymentIntent.update().$params.payment_method_option.card_present

This release changes the pinned API version to 2025-10-29.clover.

• #1946 Update generated code
  • Improve docs for PaymentIntent related endpoints
• #1942 Update generated code
  • Add support for new resources PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecord
  • Add support for all and retrieve methods on resource PaymentAttemptRecord
  • Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt_informational, report_payment_attempt, report_payment, report_refund, and retrieve methods on resource PaymentRecord
  • Add support for all method on resource PaymentIntentAmountDetailsLineItem
  • Add support for representative_declaration on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.company
  • Change Billing\CreditGrant.create().$params.category to be optional
  • Add support for payment_method_configuration on BillingPortal\Configuration.create().$params.feature.payment_method_update and BillingPortal\Configuration.update().$params.feature.payment_method_update
  • Add support for new value solana on enum Charge.payment_method_details.crypto.network
  • Add support for twint on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_option
  • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for payment_record_refund and type on CreditNote.create().$params.refund, CreditNote.preview().$params.refund, CreditNote.preview_lines().$params.refund, and CreditNote.refunds[]
  • Add support for customer_sheet and mobile_payment_element on CustomerSession.components and CustomerSession.create().$params.component
  • Add support for provider on Customer.tax
  • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enum Event.type
  • Add support for new value platform_terms_of_service on enum File.purpose
  • Add support for payment_record on Invoice.attach_payment().$params, InvoicePayment.all().$params.payment, and InvoicePayment.payment
  • Change type of InvoicePayment.all().$params.payment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
  • Add support for new value custom on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for amount_details on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, and PaymentIntent.update().$params
  • Add support for payment_details on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, PaymentIntent.update().$params, and PaymentIntent
  • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.amount_details
  • Add support for name_collection on PaymentLink.create().$params, PaymentLink.update().$params, and PaymentLink
  • Add support for new value mb_way on enum PaymentLink.payment_method_types
  • Add support for crypto on PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, and Refund.destination_details
  • Add support for mb_way on PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, and PaymentMethodConfiguration
  • Add support for custom on PaymentMethod.create().$params and PaymentMethod
  • Add support for excluded_payment_method_types on SetupIntent.create().$params, SetupIntent.update().$params, and SetupIntent
  • Add support for tw on Tax.Registration.country_options and Tax\Registration.create().$params.country_option
  • Add support for gip on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
  • Add support for last_seen_at on Terminal.Reader
  • Add support for gt, gte, lt, lte, and types on V2\Core\Event.all().$params
  • Change V2\Core\Event.all().$params.object_id to be optional
  • Add support for snapshot event BALANCE_SETTINGS_UPDATED with resource BalanceSettings
  • Add support for snapshot event INVOICE_PAYMENT_ATTEMPT_REQUIRED with resource Invoice
  • Add support for error code payment_intent_rate_limit_exceeded 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 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)

• #1903 ⚠️ Add strongly typed EventNotifications We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.

  • Added matching EventNotification classes for every v2 Event. For example, there's now a V1BillingMeterErrorReportTriggeredEventNotification to match the existing V1BillingMeterErrorReportTriggeredEvent. Each of these interfaces defines a fetchEvent() method to retrieve its corresponding event. For events with related objects, there's a fetchRelatedObject() method that performs the API call and casts the response to the correct type.
  • ⚠️ Rename function StripeClient->parseThinEvent to StripeClient->parseEventNotification and remove the ThinEvent class.
    • This function now returns a Stripe\V2\Core\EventNotification (which is the shared base class that all of the more specific Stripe\*EventNotifications classes share) instead of ThinEvent. When applicable, these event notifications will have the relatedObject property and a fetchRelatedObject() function. They also have a fetchEvent() method to retrieve their corresponding Stripe\Event\*Event instance.
    • If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of Stripe\Events\UnknownEventNotification instead of a more specific type. It has both the relatedObject property and the FetchRelatedObject() function (but they may be/return null)
  • ⚠️ removed the Util::json_decode_thin_event_object. Its functionality was folded into the new \Stripe\V2\EventNotification::fromJson method.

• #1925 add version deprecation note to README

  • NOTE: we'll be dropping support for PHP 5.6, 7.0, and 7.1 in the next major version (March 2026). The README has been updated with a link to our new language version support policy

• #1921 Update generated code

  • Change Invoice.id to be required.

• #1923 Update generated code

  • Remove support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component

• #1920 Move V2.Event API resources to V2.Core.Events

  • ⚠️ Move all V2 Event-related resources (Event, RelatedObject, etc) from Stripe\V2 to Stripe\V2\Core. They now correctly match their API path and are in line with all other resources. To update your code:

  -Stripe\V2\Event
  +Stripe\V2\Core\Event
  

• #1916 Add StripeContext object

  • Add the StripeContext class. Previously you could only send a string for stripe-context header.
  • ⚠️ Change EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext

• #1905 Added StripeContext, StripeAccount and StripeVersion to BaseStripeClientInterface

  • ⚠️ Add getter methods getStripeContext, getStripeVersion and getStripeAccount to BaseStripeClientInterface. Users with custom StripeClient that implement StripeClientInterface, StripeStreamingClientInterface or BaseStripeClientInterface will have to add implementations for these methods.

• #1898 ⚠️ Build SDK w/ V2 OpenAPI spec

  • ⚠️ The delete methods for v2 APIs (the ones in the StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
  • the generated types of some properties in EventDestination changed from something: null|string to something?: string

• #1900, #1912 Update generated code based on incoming API changes in the 2025-09-30.clover API version.

  • ⚠️ Remove support for link and pay_by_bank on PaymentMethod.update().$params
  • ⚠️ Remove support for coupon on Discount, PromotionCode.create().$params, and PromotionCode. Use Discount.source.coupon, PromotionCode.create().$params.promotion.code, and PromotionCode.promotion.code instead.
  • ⚠️ Remove support for values saturday and sunday from enum Account.settings.payouts.schedule.weekly_payout_days
  • ⚠️ Remove support for iterations on Invoice.create_preview().$params.schedule_detail.phase, SubscriptionSchedule.create().$params.phase, and SubscriptionSchedule.update().$params.phase
  • Add support for new value prevented on enum Dispute.status
  • Add support for new resource BalanceSettings
  • Add support for retrieve and update methods on resource BalanceSettings
  • Add support for new values external_request and unsupported_business_type 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 source on Discount
  • Add support for mb_way_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
  • Add support for trial_update_behavior on BillingPortal.Configuration.features.subscription_update, BillingPortal\Configuration.create().$params.feature.subscription_update, and BillingPortal\Configuration.update().$params.feature.subscription_update
  • Add support for mb_way on Charge.payment_method_details, 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, PaymentMethod, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datum
  • Add support for branding_settings and name_collection on Checkout.Session and Checkout\Session.create().$params
  • Add support for excluded_payment_method_types on Checkout.Session, Checkout\Session.create().$params, PaymentIntent.confirm().$params, and PaymentIntent.update().$params
  • Add support for unit_label on Checkout\Session.create().$params.line_item.price_datum.product_datum, Invoice.add_lines().$params.line.price_datum.product_datum, Invoice.update_lines().$params.line.price_datum.product_datum, InvoiceLineItem.update().$params.price_datum.product_datum, and PaymentLink.create().$params.line_item.price_datum.product_datum
  • Add support for alma, billie, and satispay on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_option
  • Add support for demo_pay on Checkout\Session.create().$params.payment_method_option
  • Add support for capture_method on Checkout.Session.payment_method_options.affirm, Checkout.Session.payment_method_options.afterpay_clearpay, Checkout.Session.payment_method_options.amazon_pay, Checkout.Session.payment_method_options.card, Checkout.Session.payment_method_options.cashapp, Checkout.Session.payment_method_options.klarna, Checkout.Session.payment_method_options.link, Checkout.Session.payment_method_options.mobilepay, Checkout.Session.payment_method_options.revolut_pay, Checkout\Session.create().$params.payment_method_option.affirm, Checkout\Session.create().$params.payment_method_option.afterpay_clearpay, Checkout\Session.create().$params.payment_method_option.amazon_pay, Checkout\Session.create().$params.payment_method_option.card, Checkout\Session.create().$params.payment_method_option.cashapp, Checkout\Session.create().$params.payment_method_option.klarna, Checkout\Session.create().$params.payment_method_option.link, Checkout\Session.create().$params.payment_method_option.mobilepay, and Checkout\Session.create().$params.payment_method_option.revolut_pay
  • Add support for flexible on Checkout\Session.create().$params.subscription_datum.billing_mode, Invoice.create_preview().$params.schedule_detail.billing_mode, Invoice.create_preview().$params.subscription_detail.billing_mode, Quote.create().$params.subscription_datum.billing_mode, Quote.subscription_data.billing_mode, Subscription.billing_mode, Subscription.create().$params.billing_mode, Subscription.migrate().$params.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionSchedule.create().$params.billing_mode
  • Add support for business_name and individual_name on Checkout.Session.collected_information, Checkout.Session.customer_details, Customer.create().$params, Customer.update().$params, and Customer
  • Add support for new values mb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for chargeback_loss_reason_code on Dispute.payment_method_details.klarna
  • Add support for net_amount and proration_details on InvoiceItem
  • Add support for fraud_disputability_likelihood and risk_assessment on Issuing\Authorization.create().$params
  • Add support for second_line on Issuing.Card
  • Add support for new values mb_way on enum PaymentIntent.excluded_payment_method_types
  • Add support for fr_meal_voucher_conecs on PaymentMethodConfiguration.create().$params and PaymentMethodConfiguration.update().$params
  • Add support for promotion on PromotionCode.create().$params and PromotionCode
  • Add support for new values acknowledged and payment_never_settled on enum Review.closed_reason
  • Add support for provider on Tax.Settings.defaults
  • Add support for bbpos_wisepad3 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
  • Add support for address_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.Location, Terminal\Location.create().$params, and Terminal\Location.update().$params
  • Change Terminal\Location.create().$params.address to be optional
  • Change Terminal\Location.create().$params.display_name to be optional
  • Add support for error codes financial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

• #1895 Add section on private preview SDKs in readme
• #1890 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component
  • Add support for name on BillingPortal.Configuration, BillingPortal\Configuration.create().$params, and BillingPortal\Configuration.update().$params
  • Add support for installments on Charge.payment_method_details.alma
  • Add support for transaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
  • Add support for location and reader on Charge.payment_method_details.paynow
  • Add support for amount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout\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
  • Add support for new values block and resolution on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal_android_apk on enum File.purpose
  • Add support for metadata and period 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 exp_month and exp_year on Issuing\Card.create().$params
  • Add support for excluded_payment_method_types on PaymentIntent.create().$params and PaymentIntent
  • Add support for payout_method on Payout.create().$params and Payout
  • Add support for mxn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
  • Add support for card on Terminal\Reader.present_payment_method().$params
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #1894 Add getter for Stripe Account on BaseStripeClient
  • Add getStripeAccount method on BaseStripeClient to retrieve Stripe Account ID from a StripeClient instance.

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

• #1887 Update generated code
  • Add support for origin_context on Checkout.Session
• #1881 Ensure compatibility with POST on older versions of libcurl
  • Fixes an issue with older versions of php/libcurl where certain SDK calls that have empty POST bodies will result in a 400 Bad Request returned from the server.

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

• #1880 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
  • Add support for new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSession
  • Add support for new value crypto on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for crypto on PaymentMethod
  • Add support for new value buut on enum PaymentMethod.ideal.bank
  • Add support for new value BUUTNL2A on enum PaymentMethod.ideal.bic
  • Add support for billing_mode on SubscriptionSchedule and Subscription
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.type
  • Add support for snapshot event TERMINAL_READER_ACTION_UPDATED with resource Terminal.Reader
• #1878 Update generated code
  • Add constant CURRENT_MAJOR in ApiVersion

This release changes the pinned API version to 2025-05-28.basil.

• #1871 Update generated code
  • Add support for attach_payment method on resource Invoice
  • Add support for collect_inputs method on resource Terminal.Reader
  • Add support for succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.Reader
  • Add support for refund_and_dispute_prefunding on Balance
  • Add support for balance_type on BalanceTransaction
  • Add support for post_payment_amount and pre_payment_amount on CreditNote
  • Add support for new value mixed on enum CreditNote.type
  • Add support for new value invoice_payment.paid on enum Event.type
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfiguration
  • Add support for billing_thresholds on SubscriptionItem and Subscription
  • Add support for metadata on Tax.CalculationLineItem
  • Add support for new value collect_inputs on enum Terminal.Reader.action.type
  • Add support for new value simulated_stripe_s700 on enum Terminal.Reader.device_type
  • Add support for snapshot event INVOICE_PAYMENT_PAID with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

• #1869 Fixed type of map parameters(eg. metadata, currency_options) from StripeObject to array<KType, VType> in all methods.
• #1866 Adds CONTRIBUTING.md

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

• #1839 Update generated code
  • Add support for new value tax_id_prohibited on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for wallet_options on Checkout.Session
  • Add support for context on Event
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Invoice.customer_tax_ids[].type and TaxId.type
  • Add support for new value affirm on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for pix on PaymentMethodConfiguration
  • Add support for klarna on PaymentMethodDomain
  • Add support for us_cfpb_data on Person
  • Add support for pending_reason on Refund
  • Change type of Tax.CalculationLineItem.reference from nullable(string) to string
• #1857 Include new PHP 8.3 and 8.4 in CI
• #1856 Faster parallel runner for PHP formatter

• #1847 Remove stdClass from object shapes
  • Remove intersection with stdClass in resource properties and fixed instanceof checks.

• #1843 Add null type in resource fields to non required objects
  • Fixes nullable resource properties that were incorrectly set as required in PHPDocs

• #1837 Better type hints in your editor!!

  • Added type hints for method parameters
  • Improved type hints for resource properties that are not primitive types. Take for example, the invoice settings in Customer resource. Previously, you could not reference inner fields like custom_fields on customer->invoice_settings without PHPStan complaining. This is now fixed.

• #1818 Support for APIs in the new API version 2025-03-31.basil

  This release changes the pinned API version to 2025-03-31.basil.

  ⚠️ Breaking changes due to changes in the Stripe API

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

  • Remove support for resources UsageRecordSummary and UsageRecord
  • Remove support for create method on resource UsageRecord
  • Remove support for all method on resource UsageRecordSummary
  • Remove support for upcomingLines and upcoming methods on resource Invoice
  • Remove support for invoice on Charge and PaymentIntent
  • Remove support for shipping_details on Checkout.Session
  • Remove support for refund on CreditNote
  • Remove support for tax_amounts on CreditNoteLineItem, CreditNote, and InvoiceLineItem
  • Remove support for amount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItem
  • Remove support for application_fee_amount, charge, paid_out_of_band, paid, payment_intent, quote, subscription, subscription_details, subscription_proration_date, tax, total_tax_amounts, and transfer_data on Invoice
  • Remove support for discount on Invoice and Subscription
  • Remove support for invoice_item, proration_details, proration, tax_rates, and type on InvoiceLineItem
  • Remove support for plan, price, and subscription_item on InvoiceItem and InvoiceLineItem
  • Remove support for subscription, unit_amount_decimal, and unit_amount on InvoiceItem
  • Remove support for aggregate_usage on Plan
  • Remove support for billing_thresholds on SubscriptionItem and Subscription
  • Remove support for current_period_end and current_period_start on Subscription

  ⚠️ Other Breaking changes in the SDK

  • #1826 configure max_nextwork_retries at the client level
    • Allow setting maxNetworkRetries at the StripeClient level via a new argument to the RequestOptions constructor
      • ⚠️ (potentially breaking) a client's configuration for maxNetworkRetries is set during client initialization. Subsequent calls to Stripe::setMaxNetworkRetries() after client creation won't affect that client.
    • Allow setting maxNetworkRetries per-request via the max_network_retries config argument. This works for both the service and resource based patterns. In both cases, an explicitly passed value takes precedence over the global (or client) value.
  • #1835 Removed the protected method _searchResource as it is no longer used
    • ⚠️ Removed _searchResource method and Search trait. Use the public search method on Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription resource.
  • #1832 Added requestCollection and requestSearchResult to StripeClientInterface
    • ⚠️ Added requestSearchResult, requestCollection to StripeClientInterface. Developers building custom StripeClient will now have to implement these new methods.
      • Refer to our implementation in BaseStripeClient for guidance.

  Additions

  • Add support for new resource InvoicePayment
  • Add support for all and retrieve methods on resource InvoicePayment
  • Add support for new values forwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for new values stripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.type
  • Add support for new value last on enum Billing.Meter.default_aggregation.formula
  • Add support for presentment_details on Charge, Checkout.Session, PaymentIntent, and Refund
  • Add support for optional_items on Checkout.Session and PaymentLink
  • Add support for permissions on Checkout.Session
  • Add support for new value custom on enum Checkout.Session.ui_mode
  • Add support for new values billie, nz_bank_account, and satispay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for refunds on CreditNote
  • Add support for total_taxes on CreditNote and Invoice
  • Add support for taxes on CreditNoteLineItem and InvoiceLineItem
  • Add support for checkout_session on CustomerBalanceTransaction
  • Add support for new values checkout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.type
  • Add support for new value invoice.overpaid on enum Event.type
  • Add support for amount_overpaid, confirmation_secret, and payments on Invoice
  • Add support for parent on InvoiceItem, InvoiceLineItem, and Invoice
  • Add support for new values klarna and nz_bank_account on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for pricing on InvoiceItem and InvoiceLineItem
  • Add support for new value network_fallback on enum Issuing.Authorization.request_history[].reason
  • Add support for new value expired on enum Issuing.Authorization.status
  • Add support for new value expired on enum PaymentIntent.cancellation_reason
  • Add support for new values billie and satispay on enum PaymentLink.payment_method_types
  • Add support for billie, nz_bank_account, and satispay on PaymentMethodConfiguration and PaymentMethod
  • Add support for new value canceled on enum Review.closed_reason
  • Add support for current_period_end and current_period_start on SubscriptionItem
  • Add support for wifi on Terminal.Configuration

• #1809 Update generated code
  • Add support for priority on Billing.CreditGrant
  • Add support for collected_information on Checkout.Session
• #1816 add codeowners file

• #1811 Include a useful error message when a null byte is found in the URL path
• #1810 Make httpClient() a public, static method

• #1804 Update generated code
  • Add support for close method on resource Treasury.FinancialAccount
  • Add support for discounts on Checkout.Session
  • Add support for new value pay_by_bank on enum PaymentLink.payment_method_types[]
  • Add support for pay_by_bank on PaymentMethodConfiguration and PaymentMethod
  • Add support for new value pay_by_bank on enum PaymentMethod.type
  • Add support for is_default and nickname on Treasury.FinancialAccount
• #1805 Restore testCoreEventsGet generated test
• #1807 minor justfile fixes
• #1806 Added CONTRIBUTING.md file
• #1802 ensure dependencies are installed for format and test recipes
• #1801 Add justfile, remove coveralls, and fix AUTOLOAD in CI
• #1797 Added pull request template

• #1793 This release changes the pinned API version to 2024-12-18.acacia.
  • Add support for new values payout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.type
  • Add support for allow_redisplay on Card and Source
  • Add support for regulated_status on Card
  • Add support for new value request_signature on enum Forwarding.Request.replacements[]
  • Change type of LineItem.description from string to nullable(string)
  • Add support for new values al_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enum TaxId.type

• #1786 This release changes the pinned API version to 2024-11-20.acacia.
  • Add support for respond test helper method on resource Issuing.Authorization
  • Add support for adaptive_pricing on Checkout.Session
  • Add support for new value subscribe on enums Checkout.Session.submit_type and PaymentLink.submit_type
  • Add support for new value financial_account_statement on enum File.purpose
  • Add support for fraud_challenges and verified_by_fraud_challenge on Issuing.Authorization
  • Add support for trace_id on Payout
  • Add support for new value li_vat on enum TaxId.type
  • Add support for new value service_tax on enum TaxRate.tax_type
  • Change type of Treasury.InboundTransfer.origin_payment_method from string to nullable(string)

• #1772 This release changes the pinned API version to 2024-10-28.acacia.
  • Add support for new resource V2.EventDestinations
  • Add support for create, retrieve, update, list, delete, disable, enable and ping methods on resource V2.EventDestinations
  • Add support for submit_card test helper method on resource Issuing.Card
  • Add support for groups on Account
  • Add support for enhanced_eligibility_types on Dispute
  • Add support for new values issuing_transaction.purchase_details_receipt_updated and refund.failed on enum Event.type
  • Add support for metadata on Forwarding.Request
  • Add support for new value alma on enum PaymentLink.payment_method_types[]
  • Add support for alma on PaymentMethodConfiguration and PaymentMethod
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethod
  • Add support for new values alma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enum PaymentMethod.type
  • Add support for amazon_pay on PaymentMethodDomain
  • Add support for new values by_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enum TaxId.type
  • Add support for flat_amount and rate_type on TaxRate
  • Add support for new value retail_delivery_fee on enum TaxRate.tax_type

• #1775 Deserialize into correct v2 EventData types

  • Fixes a bug where v2 EventData was not being deserialized into the appropriate type for V1BillingMeterErrorReportTriggeredEvent and V1BillingMeterNoMeterFoundEvent

• #1776 update object tags for meter-related classes

  • fixes a bug where the object property of the MeterEvent, MeterEventAdjustment, and MeterEventSession didn't match the server.

• #1773 Clean up examples

• #1771 Renamed example file names

• #1765 Update generated code
  • Remove the support for resource Margin that was accidentally made public in the last release

• #1756 Support for APIs in the new API version 2024-09-30.acacia

  This release changes the pinned API version to 2024-09-30.acacia. Please read the API Changelog and carefully review the API changes before upgrading.

  ⚠️ Breaking changes

  • Rename usage_threshold_config to usage_threshold on Billing.Alert
  • Remove support for filter on Billing.Alert. Use the filters on the usage_threshold instead

  Additions

  • Add support for new value international_transaction on enum Treasury.ReceivedCredit.failure_code
  • Add support for new Usage Billing APIs Billing.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events under the v2 namespace
  • Add new method parseThinEvent() on the StripeClient class to parse thin events.
  • Add a new method rawRequest() on the StripeClient class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.

• #1747 Update generated code
  • Add support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code
• #1745 Update generated code
  • Add support for new value terminal_reader_invalid_location_for_activation on enum StripeError.code
  • Add support for automatically_finalizes_at on Invoice

• #1737 Update generated code
  • Add support for new resource InvoiceRenderingTemplate
  • Add support for all, archive, retrieve, and unarchive methods on resource InvoiceRenderingTemplate

• #1742 Generate SDK for OpenAPI spec version 1230
  • Add support for new value issuing_regulatory_reporting on enum File.purpose
  • Add support for new value hr_oib on enum TaxId.type
  • Add support for status_details on TestHelpers.TestClock

• #1736 Update generated code

• #1729 Update generated code
  • Add support for activate, all, archive, create, deactivate, and retrieve methods on resource Billing.Alert
  • Add support for retrieve method on resource Tax.Calculation
  • Add support for new value invalid_mandate_reference_prefix_format on enum StripeError.code
  • Add support for related_customer on Identity.VerificationSession
  • Add support for new value financial_addresses.aba.forwarding on enums Treasury.FinancialAccount.active_features[], Treasury.FinancialAccount.pending_features[], and Treasury.FinancialAccount.restricted_features[]

• #1727 Update generated code
  • Add support for new resources Billing.AlertTriggered and Billing.Alert
  • Add support for new value charge_exceeds_transaction_limit on enum StripeError.code
  • Add support for new value billing.alert.triggered on enum Event.type

• #1726 Update generated code
  • Add support for update method on resource Checkout.Session
  • Add support for new values invoice.overdue and invoice.will_be_due on enum Event.type
  • Add support for twint on PaymentMethodConfiguration

• #1724 Update generated code
  • Add support for new value issuing_dispute.funds_rescinded on enum Event.type
  • Add support for new value stripe_s700 on enum Terminal.Reader.device_type
• #1722 Update changelog

• #1721 Update generated code
  • ⚠️ Remove support for values billing_policy_remote_function_response_invalid, billing_policy_remote_function_timeout, billing_policy_remote_function_unexpected_status_code, and billing_policy_remote_function_unreachable from enum StripeError.code.
  • ⚠️ Remove support for value payment_intent_fx_quote_invalid from enum StripeError.code. The was mistakenly released last week.
  • Add support for payment_method_options on ConfirmationToken

• #1718 Update generated code
  • Add support for add_lines, remove_lines, and update_lines methods on resource Invoice
  • Add support for new value payment_intent_fx_quote_invalid on enum StripeError.code
  • Add support for new values multibanco, twint, and zip on enum PaymentLink.payment_method_types[]
  • Add support for posted_at on Tax.Transaction
  • Add support for reboot_window on Terminal.Configuration

• #1714

  This release changes the pinned API version to 2024-06-20. Please read the API Changelog and carefully review the API changes before upgrading.

  ⚠️ Breaking changes

  • Remove the unused resource PlatformTaxFee
  • Remove the protected method _searchResource on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription as it is no longer used.

  Additions

  • Add support for finalize_amount test helper method on resource Issuing.Authorization
  • Add support for fleet and fuel on Issuing.Authorization
  • Add support for new value ch_uid on enum TaxId.type

• #1706 Update generated code
  • Add support for multibanco on PaymentMethodConfiguration and PaymentMethod
  • Add support for twint on PaymentMethod
  • Add support for new values multibanco and twint on enum PaymentMethod.type
  • Add support for invoice_settings on Subscription
  • Add support for new value de_stn on enum TaxId.type

• #1702 Update generated code
  • Add support for new values issuing_personalization_design.activated, issuing_personalization_design.deactivated, issuing_personalization_design.rejected, and issuing_personalization_design.updated on enum Event.type
• #1701 Added PHPDocs for create, update, delete, all, retrieve methods after moving them out of traits.
• #1700 Add optional appInfo to StripeClient config
  • StripeClient can now accept $appInfo as a $config option, so AppInfo can be set per-client. If not passed in, will fall back on the global AppInfo set by Stripe::setAppInfo().
    • The config expects $appInfo to be of type array{name: string, version?: string, url?: string, partner_id?: string}

• #1698 Update generated code
  • Add support for new value terminal_reader_invalid_location_for_payment on enum StripeError.code
• #1697 Rename section for object type generation

• #1694 Update generated code
  • Add support for fee_source on ApplicationFee
  • Add support for loss_reason on Issuing.Dispute
  • Add support for application_fee_amount and application_fee on Payout
  • Add support for stripe_s700 on Terminal.Configuration

• #1692 Update generated code
  • Add support for update test helper method on resources Treasury.OutboundPayment and Treasury.OutboundTransfer
  • Add support for new values treasury.outbound_payment.tracking_details_updated and treasury.outbound_transfer.tracking_details_updated on enum Event.type
  • Add support for allow_redisplay on PaymentMethod
  • Add support for tracking_details on Treasury.OutboundPayment and Treasury.OutboundTransfer

• #1688 Update generated code
  • Add support for new value shipping_address_invalid on enum StripeError.code
  • Add support for ship_from_details on Tax.Calculation and Tax.Transaction

• #1684 Update generated code
  • Change type of Entitlements.ActiveEntitlement.feature from string to expandable($Entitlements.Feature)
  • Add support for mobilepay on PaymentMethodConfiguration

• #1681 Update generated code
  • Add support for create_preview method on resource Invoice
  • Add support for saved_payment_method_options on Checkout.Session
• #1682 Added @throws to autoPagingIterator. Fixes #1678

• #1680 Update generated code
  • Add support for new resource Entitlements.ActiveEntitlementSummary
  • Add support for new value entitlements.active_entitlement_summary.updated on enum Event.type
  • Remove support for config on Forwarding.Request. This field is no longer used by the Forwarding Request API.
  • Add support for swish on PaymentMethodConfiguration

• #1677 Update generated code
  • Add support for new values billing_policy_remote_function_response_invalid, billing_policy_remote_function_timeout, billing_policy_remote_function_unexpected_status_code, and billing_policy_remote_function_unreachable on enum StripeError.code
  • Change type of Billing.MeterEventAdjustment.cancel from BillingMeterResourceBillingMeterEventAdjustmentCancel to nullable(BillingMeterResourceBillingMeterEventAdjustmentCancel)
  • Add support for amazon_pay on PaymentMethodConfiguration and PaymentMethod
  • Add support for new value amazon_pay on enum PaymentMethod.type
  • Add support for new values bh_vat, kz_bin, ng_tin, and om_vat on enum TaxId.type

• #1673

  • This release changes the pinned API version to 2024-04-10. Please read the API Changelog and carefully review the API changes before upgrading.

  ⚠️ Breaking changes

  • Rename features to marketing_features on Product
  • Do not force resolution to IPv4 - Forcing IPv4 was causing hard-to-understand failures for users in IPv6-only environments. If you want to force IPv4 yourself, you can do so by telling the API client to use a CurlClient other than the default

  $curl = new \Stripe\HttpClient\CurlClient([
    CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4
  ]);
  \Stripe\ApiRequestor::setHttpClient($curl);
  

  ⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API

  • Remove the below deprecated values on the enum BalanceTransaction.Type
    • obligation_inbound
    • obligation_payout
    • obligation_payout_failure
    • obligation_reversal_outbound
  • Remove the deprecated value various on the enum Climate.Supplier.RemovalPathway
  • Remove deprecated events
    • invoiceitem.updated
    • order.created
    • recipient.created
    • recipient.deleted
    • recipient.updated
    • sku.created
    • sku.deleted
    • sku.updated
  • Remove the deprecated value service_tax on the enum TaxRate.TaxType
  • Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration
  • Remove the legacy field rendering_options in Invoice. Use rendering instead.

• #1675 Update generated code
  • Add support for new resources Entitlements.ActiveEntitlement and Entitlements.Feature
  • Add support for all and retrieve methods on resource ActiveEntitlement
  • Add support for all, create, retrieve, and update methods on resource Feature
  • Add support for new value none on enum Account.type
  • Add support for cancel, event_name, and type on Billing.MeterEventAdjustment

• #1670 Update generated code
  • Add support for subscription_item on Discount
  • Add support for email and phone on Identity.VerificationReport
  • Add support for verification_flow on Identity.VerificationReport and Identity.VerificationSession
  • Add support for new value verification_flow on enums Identity.VerificationReport.type and Identity.VerificationSession.type
  • Add support for provided_details on Identity.VerificationSession
  • Change type of Invoice.discounts from nullable(array(expandable(deletable($Discount)))) to array(expandable(deletable($Discount)))
  • Add support for zip on PaymentMethodConfiguration
  • Add support for discounts on SubscriptionItem and Subscription
  • Add support for new value mobile_phone_reader on enum Terminal.Reader.device_type

• #1666 Update generated code
  • Add support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
  • Add support for all, create, deactivate, reactivate, retrieve, and update methods on resource Meter
  • Add support for create method on resources MeterEventAdjustment and MeterEvent
  • Add support for meter on Plan

• #1664 Update generated code
  • Add support for new resources ConfirmationToken and Forwarding.Request
  • Add support for retrieve method on resource ConfirmationToken
  • Add support for all, create, and retrieve methods on resource Request
  • Add support for new values forwarding_api_inactive, forwarding_api_invalid_parameter, forwarding_api_upstream_connection_error, and forwarding_api_upstream_connection_timeout on enum StripeError.code
  • Add support for mobilepay on PaymentMethod
  • Add support for new value mobilepay on enum PaymentMethod.type
  • Add support for name on Terminal.Configuration

• #1660 Update generated code
  • Add support for new resources Issuing.PersonalizationDesign and Issuing.PhysicalBundle
  • Add support for all, create, retrieve, and update methods on resource PersonalizationDesign
  • Add support for all and retrieve methods on resource PhysicalBundle
  • Add support for personalization_design on Issuing.Card

• #1654 Update generated code
  • Change type of Identity.VerificationSession.type from nullable(enum('document'|'id_number')) to enum('document'|'id_number')
  • Add resources Application, ConnectCollectionTransfer, PlatformTaxFee, ReserveTransaction, SourceMandateNotification, and TaxDeductedAtSource. These classes have no methods on them, and are used to provide more complete types for PHPDocs.
• #1657 Update readme to use addBetaVersion

• #1651 Update generated code
  • Add support for client_reference_id on Identity.VerificationReport and Identity.VerificationSession
  • Remove support for value service_tax from enum TaxRate.tax_type
• #1650 Add TaxIds API
  • Add support for all, create, delete, and retrieve methods on resource TaxId
  • The instanceUrl function on TaxId now returns the top-level /v1/tax_ids/{id} path instead of the /v1/customers/{customer}/tax_ids/{id} path.

• #1639 Update generated code
  • Add support for networks on Card
  • Add support for new value financial_connections.account.refreshed_ownership on enum Event.type
• #1648 Remove broken methods on CustomerCashBalanceTransaction
  • Bugfix: remove support for CustomerCashBalanceTransaction::all and CustomerCashBalanceTransaction::retrieve. These methods were included in the library unintentionally and never functioned.
• #1647 Fix \Stripe\Tax\Settings::update
• #1646 Add more specific PHPDoc and Psalm type for RequestOptions arrays on services

• #1636 Update generated code
  • Add support for new value swish on enum PaymentLink.payment_method_types[]
  • Add support for swish on PaymentMethod
  • Add support for new value swish on enum PaymentMethod.type
  • Add support for jurisdiction_level on TaxRate
  • Change type of Terminal.Reader.status from string to enum('offline'|'online')
• #1633 Update generated code
  • Add support for issuer on Invoice
  • Add support for customer_balance on PaymentMethodConfiguration
• #1630 Add paginated requests helper function and use in Search and All

• #1629 Update generated code
  • Add support for new resource CustomerSession
  • Add support for create method on resource CustomerSession
  • Remove support for values obligation_inbound, obligation_payout_failure, obligation_payout, and obligation_reversal_outbound from enum BalanceTransaction.type
  • Add support for billing_cycle_anchor_config on Subscription

• #1627 Update generated code
  • Add support for retrieve method on resource Tax.Registration

• #1621 Update generated code
  • Add support for new resource FinancialConnections.Transaction
  • Add support for all and retrieve methods on resource Transaction
  • Add support for subscribe and unsubscribe methods on resource FinancialConnections.Account
  • Add support for new value financial_connections.account.refreshed_transactions on enum Event.type
  • Add support for subscriptions and transaction_refresh on FinancialConnections.Account
  • Add support for new value transactions on enum FinancialConnections.Session.prefetch[]
  • Add support for revolut_pay on PaymentMethodConfiguration
  • Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration
  • Change type of Quote.invoice_settings from nullable(InvoiceSettingQuoteSetting) to InvoiceSettingQuoteSetting
  • Add support for destination_details on Refund

• #1613 Update generated code
  • Add support for new values customer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enum StripeError.code
  • Add support for new values payment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.type
  • Remove support for value various from enum Climate.Supplier.removal_pathway
  • Add support for inactive_message and restrictions on PaymentLink
• #1612 Report usage of .save and StripeClient
  • Reports uses of the deprecated .save and of StripeClient in X-Stripe-Client-Telemetry. (You can disable telemetry via \Stripe\Stripe::setEnableTelemetry(false);, see the README.)

• #1611 Update generated code
  • Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
  • Add support for all, cancel, create, retrieve, and update methods on resource Order
  • Add support for all and retrieve methods on resources Product and Supplier
  • Add support for new value financial_connections_account_inactive on enum StripeError.code
  • Add support for new values climate_order_purchase and climate_order_refund on enum BalanceTransaction.type
  • Add support for new values climate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enum Event.type

• #1608 Update generated code Add support for transferred_to_balance to CustomerCashBalanceTransaction
• #1605 Update generated code
  • Add support for network_data on Issuing.Transaction

• #1603 Update generated code
  • Add support for new value terminal_reader_hardware_fault on enum StripeError.code

• #1602 Fix error when "id" is not a string.

• #1599 Update generated code
  • Add support for new resource Tax.Registration
  • Add support for all, create, and update methods on resource Registration
  • Add support for new value token_card_network_invalid on enum StripeError.code
  • Add support for new value payment_unreconciled on enum BalanceTransaction.type
  • Add support for revolut_pay on PaymentMethod
  • Add support for new value revolut_pay on enum PaymentMethod.type

• #1595 Update generated code
  • Add support for new value balance_invalid_parameter on enum StripeError.code

• This release changes the pinned API version to 2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-php package.
• #1593 Update generated code
  • Added additional_tos_acceptances field on Person

• #1590 Update generated code
  • Add support for new values issuing_token.created and issuing_token.updated on enum Event.type

• #1589 Update generated code
  • Add support for client_secret, redirect_on_completion, return_url, and ui_mode on Checkout.Session
  • Add support for offline on Terminal.Configuration

• #1586 Update generated code
  • Add support for new resource Issuing.Token
  • Add support for all, retrieve, and update methods on resource Token
  • Add support for token on Issuing.Authorization and Issuing.Transaction
• #1569 Fix: Do not bother removing friendsofphp/php-cs-fixer

• #1582 Generate Discount, SourceTransaction and use sections in more places
• #1584 Update generated code
  • Add support for rendering on Invoice

• #1579 Update generated code
  • Add back constant for invoiceitem.updated webhook event. This was mistakenly removed in v12.2.0.
• #1566 Fix: Remove squizlabs/php_codesniffer
• #1568 Enhancement: Reference phpunit.xsd as installed with composer
• #1565 Enhancement: Use PHP 8.2 as leading PHP version

• #1577 Update generated code
  • Add support for new resource PaymentMethodConfiguration
  • Add support for all, create, retrieve, and update methods on resource PaymentMethodConfiguration
  • Add support for payment_method_configuration_details on Checkout.Session, PaymentIntent, and SetupIntent
• #1573 Update generated code
  • Add support for capture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorization
  • Add support for create_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.Transaction
  • Add support for new value stripe_tax_inactive on enum StripeError.code

• #1571 Update generated code
  • Add support for new resource PaymentMethodDomain
  • Add support for all, create, retrieve, update, and validate methods on resource PaymentMethodDomain
  • Add support for new values treasury.credit_reversal.created, treasury.credit_reversal.posted, treasury.debit_reversal.completed, treasury.debit_reversal.created, treasury.debit_reversal.initial_credit_granted, treasury.financial_account.closed, treasury.financial_account.created, treasury.financial_account.features_status_updated, treasury.inbound_transfer.canceled, treasury.inbound_transfer.created, treasury.inbound_transfer.failed, treasury.inbound_transfer.succeeded, treasury.outbound_payment.canceled, treasury.outbound_payment.created, treasury.outbound_payment.expected_arrival_date_updated, treasury.outbound_payment.failed, treasury.outbound_payment.posted, treasury.outbound_payment.returned, treasury.outbound_transfer.canceled, treasury.outbound_transfer.created, treasury.outbound_transfer.expected_arrival_date_updated, treasury.outbound_transfer.failed, treasury.outbound_transfer.posted, treasury.outbound_transfer.returned, treasury.received_credit.created, treasury.received_credit.failed, treasury.received_credit.succeeded, and treasury.received_debit.created on enum Event.type
  • Remove support for value invoiceitem.updated from enum Event.type
  • Add support for features on Product

• #1560 Update generated code
  • Add support for new resource AccountSession
  • Add support for create method on resource AccountSession
  • Add support for new values obligation_inbound, obligation_outbound, obligation_payout_failure, obligation_payout, obligation_reversal_inbound, and obligation_reversal_outbound on enum BalanceTransaction.type
  • Change type of Event.type from string to enum
  • Add support for application on PaymentLink
• #1562 Nicer ApiErrorException::__toString()
• #1558 Update generated code
  • Add support for payment_method_details on Dispute
  • Add support for prefetch on FinancialConnections.Session

⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️

Version pinning

In this release, Stripe API Version 2023-08-16 (the latest at time of release) will be sent by default on all requests. This is a significant change with wide ramifications. The API version affects the properties you see on responses, the parameters you are allowed to send on requests, and so on. The previous default was to use your Stripe account's default API version.

To successfully upgrade to stripe-php v12, you must either

1. (Recommended) Upgrade your integration to be compatible with API Version 2023-08-16.

   Please read the API Changelog carefully for each API Version from 2023-08-16 back to your Stripe account's default API version. Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe Test Mode before deploying them to production.

   You can read the v12 migration guide for more detailed instructions.

2. (Alternative option) Specify a version other than 2023-08-16 when initializing stripe-php.

   If you were previously initializing stripe-php without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your Stripe account's default API version. For example:

     // if using StripeClient
   - $stripe = new \Stripe\StripeClient('sk_test_xyz');
   + $stripe = new \Stripe\StripeClient([
   +   'api_key' => 'sk_test_xyz',
       'stripe_version' => '2020-08-27',
   + ]);
   
     // if using the global client
     Stripe.apiKey = "sk_test_xyz";
   + Stripe::setApiVersion('2020-08-27');
   

   If you were already initializing stripe-php with an explicit API Version, upgrading to v12 will not affect your integration.

   Read the v12 migration guide for more details.

   Going forward, each major release of this library will be pinned by default to the latest Stripe API Version at the time of release.

   That is, instead of upgrading stripe-php and separately upgrading your Stripe API Version through the Stripe Dashboard, whenever you upgrade major versions of stripe-php, you should also upgrade your integration to be compatible with the latest Stripe API version.

Other changes

" ⚠️" symbol highlights breaking changes.

• #1553⚠️ Remove deprecated enum value Invoice.STATUS_DELETE

• #1550 PHPDoc changes

  • Remove support for alternate_statement_descriptors, destination, and dispute on Charge
  • Remove support for value charge_refunded from enum Dispute.status
  • Remove support for rendering on Invoice
  • Remove support for attributes, caption, and deactivate_on on Product

Please do not use stripe-php v11. It did not correctly apply the pinning behavior and was removed from packagist

• #1546 Update generated code
  • Add support for new value payment_reversal on enum BalanceTransaction.type
  • Add support for new value adjusted_for_overdraft on enum CustomerBalanceTransaction.type

• #1539 Update generated code
  • Add support for subscription_details on Invoice
  • Add support for new values sepa_debit_fingerprint and us_bank_account_fingerprint on enum Radar.ValueList.item_type

• #1534 Update generated code
  • Improve PHPDoc type for ApplicationFee.refunds
  • Add support for deleted on Apps.Secret
• #1526 Add constants for payment intent cancellation reasons
• #1533 Update generated code
  • Add support for new value service_tax on enum TaxRate.tax_type
• #1487 PHPDoc: use union of literals for $method parameter throughout

• #1533 Update generated code
  • Add support for new value service_tax on enum TaxRate.tax_type
• #1526 Add constants for payment intent cancellation reasons
• #1487 PHPDoc: use union of literals for $method parameter throughout

• #1525 Update generated code
  • Add support for new resource Tax.Settings
  • Add support for retrieve and update methods on resource Settings
  • Add support for new value invalid_tax_location on enum StripeError.code
  • Add support for product on Tax.TransactionLineItem
  • Add constant for tax.settings.updated webhook event
• #1520 Update generated code
  • Release specs are identical.

• #1517 Update generated code
  • Add support for new value application_fees_not_allowed on enum StripeError.code
  • Add support for effective_at on CreditNote and Invoice
  • Add support for on_behalf_of on Mandate
• #1514 Update generated code
  • Release specs are identical.
• #1512 Update generated code
  • Change type of Checkout.Session.success_url from string to nullable(string)

• #1506 Update generated code
  • Add support for preferred_locales on Issuing.Cardholder

• #1503 Update generated code

  • Add support for zip on PaymentMethod
  • Add support for new value zip on enum PaymentMethod.type

• #1502 Generate error codes

• #1501 Update generated code

• #1499 Update generated code

  • Add support for new values amusement_tax and communications_tax on enum TaxRate.tax_type

• #1490 Update generated code

  • Add support for paypal on PaymentMethod
  • Add support for effective_percentage on TaxRate

• #1488 Increment PHPStan to strictness level 2

• #1483 Update generated code

• #1480 Update generated code

  • Change type of Identity.VerificationSession.options from VerificationSessionOptions to nullable(VerificationSessionOptions)
  • Change type of Identity.VerificationSession.type from enum('document'|'id_number') to nullable(enum('document'|'id_number'))

• #1478 Update generated code

  • Release specs are identical.

• #1475 Update generated code

• #1473 Update generated code
  • Add back deleted from Invoice.status.

• #1470 Update generated code
  • Remove support for create method on resource Tax.Transaction
    • This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the createFromCalculation method.
  • Remove support for value deleted from enum Invoice.status
    • This is not a breaking change, as the value was never returned or accepted as input.
• #1468 Trigger workflow for tags
• #1467 Update generated code (new)
  • Release specs are identical.

• #1458 Update generated code
  • Add support for new resources Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transaction
  • Add support for create and list_line_items methods on resource Calculation
  • Add support for create_from_calculation, create_reversal, create, list_line_items, and retrieve methods on resource Transaction
  • Add support for currency_conversion on Checkout.Session
  • Add support for new value automatic_async on enum PaymentIntent.capture_method
  • Add support for new value link on enum PaymentLink.payment_method_types[]
  • Add support for automatic_payment_methods on SetupIntent

• #1457 API Updates
  • Add support for future_requirements and requirements on BankAccount
  • Add support for new value automatic_async on enum PaymentIntent.capture_method
  • Add support for new value cashapp on enum PaymentLink.payment_method_types[]
  • Add support for cashapp on PaymentMethod
  • Add support for new value cashapp on enum PaymentMethod.type
• #1454 Update generated code (new)
  • Add support for new value cashapp on enum PaymentLink.payment_method_types[]
  • Add support for cashapp on PaymentMethod
  • Add support for new value cashapp on enum PaymentMethod.type

• #1453 Restore StripeClient.getService

• #1450 API Updates

  • Add support for cancellation_details on Subscription
  • Fix return types on custom methods (extends https://github.com/stripe/stripe-php/pull/1446)

• #1446 stripe->customers->retrievePaymentMethod returns the wrong class (type hint)

• #1447 API Updates
  • Add support for reconciliation_status on Payout
  • Add support for new value lease_tax on enum TaxRate.tax_type

• #1444 API Updates
  • Add support for new value igst on enum TaxRate.tax_type

• #1443 Remove init.php from the list of ignored files

• #1441 API Updates
  • Add support for refund_payment method on resource Terminal.Reader
  • Add support for custom_fields on Checkout.Session and PaymentLink
• #1236 subscription_proration_date not always presented in Invoice
• #1431 Fix: Do not use unbounded version constraint for actions/checkout
• #1436 Enhancement: Enable and configure visibility_required fixer
• #1432 Enhancement: Update actions/cache
• #1434 Fix: Remove parentheses
• #1433 Enhancement: Run tests on PHP 8.2
• #1438 Update .gitattributes

• #1439 API Updates
  • Add support for resume method on resource Subscription
  • Add support for amount_shipping and shipping_cost on CreditNote and Invoice
  • Add support for shipping_details on Invoice
  • Add support for invoice_creation on PaymentLink
  • Add support for trial_settings on Subscription
  • Add support for new value paused on enum Subscription.status

• #1381 Add getService methods to StripeClient and AbstractServiceFactory to allow mocking

• #1424 API Updates

  • Added REFUND_CREATED, REFUND_UPDATED event definitions.

• #1426 Ignore PHP version for formatting

• #1425 Fix Stripe::setAccountId parameter type

• #1418 Switch to mb_convert_encoding to fix utf8_encode deprecation warning

• #1413 API Updates Change CheckoutSession.cancel_url to be nullable.

• #1411 API Updates
  • Add support for new value invoice_overpaid on enum CustomerBalanceTransaction.type
• #1407 API Updates

• #1405 API Updates
  • Add support for flow on BillingPortal.Session
• #1404 API Updates
  • Remove support for resources Order and Sku
  • Remove support for all, cancel, create, list_line_items, reopen, retrieve, submit, and update methods on resource Order
  • Remove support for all, create, delete, retrieve, and update methods on resource Sku
  • Add support for custom_text on Checkout.Session and PaymentLink
  • Add support for invoice_creation and invoice on Checkout.Session
  • Remove support for product on LineItem
  • Add support for latest_charge on PaymentIntent
  • Remove support for charges on PaymentIntent

• #1392 Next major release changes

Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-11-15.

"⚠️" symbol highlights breaking changes.

Deprecated

• #1382 Mark resource.save as deprecated. Prefer the static update method that doesn't require retrieval of the resource to update it.

// before
$resource = Price::retrieve(self::TEST_RESOURCE_ID);
$resource->metadata['key'] = 'value';
$resource->save();

// after
$resource = Price::update('price_123', [
    'metadata' => ['key' => 'value'],
]);

⚠️ Removed

• #1377 Removed deprecated Sku resource and service
• #1375 Removed deprecated Orders resource and service
• #1375 Removed deprecated Product field from the LineItem
• #1388 Removed deprecated AlipayAccount resource
• #1396 Removed charges field on PaymentIntent and replace it with latest_charge.

• #1394 API Updates
  • Add support for new values eg_tin, ph_tin, and tr_tin on enum TaxId.type
• #1389 API Updates
  • Add support for on_behalf_of on Subscription
• #1379 Do not run Coveralls in PR-s

• #1383 API Updates
  • Add support for new values jp_trn and ke_pin on enum TaxId.type
• #1293 Install deps in the install step of CI
• #1291 Fix: Configure finder for friendsofphp/php-cs-fixer

• #1376 API Updates
  • Add support for network_data on Issuing.Authorization
• #1374 Add request_log_url on ErrorObject
• #1370 API Updates
  • Add support for created on Checkout.Session

• #1365 API Updates
  • Add support for from_invoice and latest_revision on Invoice
  • Add support for new value pix on enum PaymentLink.payment_method_types[]
  • Add support for pix on PaymentMethod
  • Add support for new value pix on enum PaymentMethod.type
  • Add support for created on Treasury.CreditReversal and Treasury.DebitReversal

• #1364 API Updates
  • Add support for new value terminal_reader_splashscreen on enum File.purpose
• #1363 chore: Update PHP tests to handle search methods.

• #1362 API Updates
  • Add support for login_page on BillingPortal.Configuration
• #1360 Add test coverage using Coveralls
• #1361 fix: Fix type hints for error objects.
  • Update Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error and SetupIntent.setup_error type to be StripeObject.
    • Addresses https://github.com/stripe/stripe-php/issues/1353. The library today does not actually return a ErrorObject for these fields, so the type annotation was incorrect.
• #1356 Add beta readme.md section

• #1355 API Updates
  • Change type of Treasury.OutboundTransfer.destination_payment_method from string to string | null
  • Change the return type of CustomerService.fundCashBalance test helper from CustomerBalanceTransaction to CustomerCashBalanceTransaction.
    • This would generally be considered a breaking change, but we've worked with all existing users to migrate and are comfortable releasing this as a minor as it is solely a test helper method. This was essentially broken prior to this change.

• #1352 API Updates
  • Add support for new resource CustomerCashBalanceTransaction
  • Add support for currency on PaymentLink
  • Add constant for customer_cash_balance_transaction.created webhook event.
• #1351 Add a support section to the readme
• #1304 Allow passing PSR-3 loggers to setLogger as they are compatible

• #1348 API Updates

  • Add support for payment_method_collection on Checkout.Session and PaymentLink

• #1346 API Updates

  • Add support for expires_at on Apps.Secret

Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-php/wiki/Migration-guide-for-v9. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-08-01.

"⚠️" symbol highlights breaking changes.

• #1344 API Updates
• #1337 API Updates
• #1273 Add some PHPDoc return types and fixes
• #1341 Next major release changes

Added

• Add alternate_statement_descriptors, authorization_code, and level3 properties to Charge resource.
• Add previewLines method to CreditNote resource.
• Add transfer_data property to Subscription resource.
• Add SOURCE_TYPE_FPX constant to Transfer resource.
• Add new error code constants to ErrorObject.
• Add support for shipping_cost and shipping_details on Checkout.Session

⚠️ Changed

• Updated certificate bundle (#1314)
• Add params parameter to close method in Dispute resource.

⚠️ Removed

• Remove deprecated AlipayAccount, BitcoinReceiver, BitcoinTransaction, Recipient, RecipientTransfer, and ThreeDSecure resources.
• Remove CAPABILITY_CARD_PAYMENTS, CAPABILITY_LEGACY_PAYMENTS, CAPABILITY_PLATFORM_PAYMENTS, CAPABILITY_TRANSFERS, CAPABILITY_STATUS_ACTIVE, CAPABILITY_STATUS_INACTIVE, and CAPABILITY_STATUS_PENDING constants from Account resource. Please use up-to-date values from https://stripe.com/docs/connect/account-capabilities.
• Remove AssociatedObjects array property from EphemeralKey resource. The field was undocumented and unsupported.
• Remove details method from Card resource. The endpoint was deprecated and no longer exists.
• Remove recipient property from Card resource. The property was deprecated.
• Remove ability to list Card resources for a particular Recipient.
• Remove sources property from Card resource. The property was deprecated.
• Remove FAILURE_REASON constant from Refund resource. The value was deprecated.
• Remove Recipient resource. The resource was deprecated.
• Remove OrderItem resource. The resource was deprecated.
• Remove all method from LineItem.
• Remove cancel method from Transfer and TransferService. This method is deprecated.
• Remove allTransactions method from SourceService service. Please use allSourceTransactions method instead.
• Remove persons method from Account resource. Please use allPersons method instead.
• Remove sourceTransactions method from Source resource. Please use allSourceTransactions method instead.
• Remove usageRecordSummaries method from SubscriptionItem resource. Please use allUsageRecordSummaries method instead.
• Remove SOURCE_TYPE_ALIPAY_ACCOUNT and SOURCE_TYPE_FINANCING constants from Transfer resource. The values were deprecated and are no longer in use.
• Remove deprecated error code constants from ErrorObject: CODE_ACCOUNT_ALREADY_EXISTS, CODE_ORDER_CREATION_FAILED, CODE_ORDER_REQUIRED_SETTINGS, CODE_ORDER_STATUS_INVALID, CODE_ORDER_UPSTREAM_TIMEOUT, and CODE_UPSTREAM_ORDER_CREATION_FAILED.
• Remove deprecated event constants from Webhook: ISSUER_FRAUD_RECORD_CREATED, ORDER_PAYMENT_FAILED, ORDER_PAYMENT_SUCCEEDED, ORDER_UPDATED, ORDER_RETURN_CREATED, PAYMENT_METHOD_CARD_AUTOMATICALLY_UPDATED, PING, PROMOTION_CODE_DELETED, and TREASURY_RECEIVED_CREDIT_REVERSED. The events are deprecated and no longer sent by Stripe.

• #1332 API Updates
  • Add support for default_currency and invoice_credit_balance on Customer

• #1324 API Updates
  • Add support for new value blik on enum PaymentLink.payment_method_types[]
  • Add support for blik on PaymentMethod
  • Add support for new value blik on enum PaymentMethod.type
  • Add Invoice.upcomingLines method.
  • Add SourceService.allSourceTransactions method.
• #1322 API Updates
  • Change type of source_type on Transfer from nullable string to string (comment-only change)

• #1319 API Updates
  • Add support for currency_options on Coupon and Price
  • Add support for currency on Subscription
• #1318 API Updates
  • Add support for new values financial_connections.account.created, financial_connections.account.deactivated, financial_connections.account.disconnected, financial_connections.account.reactivated, and financial_connections.account.refreshed_balance on Event.

• #1316 API Updates
  • Add support for deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Card
  • Add support for subtotal_excluding_tax on CreditNote and Invoice
  • Add support for amount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItem
  • Add support for total_excluding_tax on Invoice
  • Change type of PaymentLink.payment_method_types[] from literal('card') to enum
  • Add support for promptpay on PaymentMethod
  • Add support for new value promptpay on enum PaymentMethod.type
  • Add support for hosted_regulatory_receipt_url and reversal_details on Treasury.ReceivedCredit and Treasury.ReceivedDebit

• #1302 API Updates

  • Add support for custom_unit_amount on Price

• #1301 API Updates

  Documentation updates.

• #1306 API Updates

  • Add support for fund_cash_balance test helper method on resource Customer
  • Add support for total_excluding_tax on CreditNote
  • Add support for rendering_options on Invoice

• #1307 Support updating pre-release versions

• #1305 Trigger workflows on beta branches

• #1302 API Updates

  • Add support for custom_unit_amount on Price

• #1301 API Updates

  Documentation updates.

• #1300 API Updates
  • Add support for attach_to_self and flow_directions on SetupAttempt

• #1298 API Updates
  • Add support for radar_options on Charge and PaymentMethod
  • Add support for new value simulated_wisepos_e on enum Terminal.Reader.device_type

• #1296 API Updates
  • Add support for persons method on resource Account
  • Add support for balance_transactions method on resource Customer
  • Add support for id_number_secondary_provided on Person
• #1295 API Updates

• #1294 API Updates
  • Add support for new resource Apps.Secret
  • Add support for affirm and link on PaymentMethod
  • Add support for new values affirm and link on enum PaymentMethod.type
• #1289 fix: Update RequestOptions#redactedApiKey to stop exploding null.

• #1286 API Updates
  • Add support for new resources Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.FlowDetails, Treasury.InboundTransfer, Treasury.OutboundPayment, Treasury.OutboundTransfer, Treasury.ReceivedCredit, Treasury.ReceivedDebit, Treasury.TransactionEntry, and Treasury.Transaction
  • Add support for retrieve_payment_method method on resource Customer
  • Add support for all and list_owners methods on resource FinancialConnections.Account
  • Add support for treasury on Issuing.Authorization, Issuing.Dispute, and Issuing.Transaction
  • Add support for financial_account on Issuing.Card
  • Add support for client_secret on Order
  • Add support for attach_to_self and flow_directions on SetupIntent

• #1284 API Updates
  • Add support for consent_collection, customer_creation, payment_intent_data, shipping_options, submit_type, and tax_id_collection on PaymentLink
  • Add support for description on Subscription

• #1283 Major version release of v8.0.0. The migration guide contains more information. (⚠️ = breaking changes):
  • ⚠️ Replace the legacy Order API with the new Order API.
    • Resource modified: Order.
    • New methods: cancel, list_line_items, reopen, and submit
    • Removed methods: pay and return_order
    • Removed resources: OrderItem and OrderReturn
    • Removed references from other resources: Charge.order
  • ⚠️ Rename \FinancialConnections\Account.refresh method to \FinancialConnections\Account.refresh_account
  • Add support for amount_discount, amount_tax, and product on LineItem

• #1282 API Updates
  • Add support for default_price on Product
  • Add support for instructions_email on Refund

• #1281 API Updates
  • Add support for new resources FinancialConnections.AccountOwner, FinancialConnections.AccountOwnership, FinancialConnections.Account, and FinancialConnections.Session
• #1278 Pin setup-php action version.
• #1277 API Updates
  • Add support for registered_address on Person

• #1276 API Updates
  • Add support for new resource CashBalance
  • Change type of BillingPortal.Configuration.application from $Application to deletable($Application)
  • Add support for cash_balance on Customer
  • Add support for application on Invoice, Quote, SubscriptionSchedule, and Subscription
  • Add support for new value eu_oss_vat on enum TaxId.type
• #1274 Fix PHPDoc on Discount for nullable properties
• #1272 Allow users to pass a custom IPRESOLVE cURL option.

• #1270 API Updates
  • Add support for expire test helper method on resource Refund

• #1265 API Updates
  • Add support for new resources FundingInstructions and Terminal.Configuration
  • Add support for create_funding_instructions method on resource Customer
  • Add support for amount_details on PaymentIntent
  • Add support for customer_balance on PaymentMethod
  • Add support for new value customer_balance on enum PaymentMethod.type
  • Add support for configuration_overrides on Terminal.Location

• #1263 API Updates
  • Add support for increment_authorization method on resource PaymentIntent
• #1262 Add support for updating the version of the repo
• #1230 Add PHPDoc return types
• #1242 Fix some PHPDoc in tests

• #1261 API Updates

  • Add support for apply_customer_balance method on resource PaymentIntent

• #1259 API Updates

  • Add payment_intent.partially_funded, terminal.reader.action_failed, and terminal.reader.action_succeeded events.

• #1258 API Updates
  • Add support for cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.Reader
  • Add support for action on Terminal.Reader

• #1257 API Updates
  • Add support for Search API
    • Add support for search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription

• #1256 API Updates
  • Add support for PayNow and US Bank Accounts Debits payments
    • Add support for paynow and us_bank_account on PaymentMethod
    • Add support for new values paynow and us_bank_account on enum PaymentMethod.type
  • Add support for failure_balance_transaction on Charge

• #1255 API Updates
  • Add support for cancel method on resource Refund
  • Add support for new values bg_uic, hu_tin, and si_tin on enum TaxId.type
  • Add test_helpers.test_clock.advancing, test_helpers.test_clock.created, test_helpers.test_clock.deleted, test_helpers.test_clock.internal_failure, and test_helpers.test_clock.ready events.

• #1254 API Updates
  • Add support for status on Card
• #1251 Add support for SearchResult objects.
• #1249 Add missing constant for payment_behavior

• #1248 API Updates
  • Add support for proration_details on InvoiceLineItem

• #1245 #1247 API Updates
  • Add support for new resource TestHelpers.TestClock
  • Add support for test_clock on Customer, Invoice, InvoiceItem, Quote, Subscription, and SubscriptionSchedule
  • Add support for next_action on Refund
  • Add support for konbini on PaymentMethod
• #1244 API Updates
  • Add support for new values bbpos_wisepad3 and stripe_m2 on enum Terminal.Reader.device_type

• #1243 Add test
• #1240 API Updates
  • Add support for verify_microdeposits method on resources PaymentIntent and SetupIntent
• #1241 Add generic parameter to \Stripe\Collection usages

• #1239 API Updates
  • Add REASON_EXPIRED_UNCAPTURED_CHARGE enum value on Refund.

• #1235 API Updates
  • Add support for phone_number_collection on PaymentLink
  • Add support for new value is_vat on enum TaxId.type

• #1233 API Updates
  • Add support for new resource PaymentLink
  • Add support for payment_link on Checkout.Session

• #1232 API Updates
  • Add support for paid_out_of_band on Invoice

• #1231 API Updates
  • Add support for customer_creation on Checkout.Session
• #1227 Update docs URLs

• #1226 Upgrade php-cs-fixer to 3.4.0.
• #1222 API Updates
  • Add support for processing on PaymentIntent
• #1220 API Updates

• #1219 API Updates
  • Add support for metadata on BillingPortal.Configuration
  • Add support for wallets on Issuing.Card

• #1218 API Updates
  • Add support for new values ge_vat and ua_vat on enum TaxId.type
• #1216 Fix namespaced classes in @return PHPDoc.
• #1214 Announce PHP8 support in CHANGELOG.md

• #1213 PHP 8.1 missing ReturnTypeWillChange annotations.
• As of this version, PHP 8.1 is officially supported.

• #1211 PHPStan compatibility with PHP8.x
• #1209 PHPUnit compatibility with PHP 8.x

• #1206 API Updates
  • Add support for new value jct on enum TaxRate.tax_type

• #1205 API Updates
  • Add support for automatic_payment_methods on PaymentIntent

• #1203 API Updates
  • Add support for new resource ShippingRate
  • Add support for shipping_options and shipping_rate on Checkout.Session
  • Add support for expire method on resource Checkout.Session
  • Add support for status on Checkout.Session

• #1190 API Updates
  • Add support for klarna on PaymentMethod.

• #1188 API Updates
  • Add support for list_payment_methods method on resource Customer

• #1187 API Updates
  • Add support for phone_number_collection on Checkout.Session
  • Add support for new value customer_id on enum Radar.ValueList.item_type
  • Add support for new value bbpos_wisepos_e on enum Terminal.Reader.device_type

• #1181 API Updates
  • Add support for full_name_aliases on Person

• #1178 API Updates
  • Add support for livemode on Reporting.ReportType
  • Add support for new value rst on enum TaxRate.tax_type

• #1177 API Updates
  • Add support for future_requirements on Account, Capability, and Person
  • Add support for after_expiration, consent, consent_collection, expires_at, and recovered_from on Checkout.Session