NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #219 most downloaded on Packagist
Stripe PHP Library
Latest stable
v23.1.0
Last release 3 days ago
19 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 54 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
721 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Add support for new value shipping_address_invalid on enum StripeError.code
shipping_address_invalid on enum StripeError.codeInvoice.issuer from nullable(ConnectAccountReference) to ConnectAccountReferenceship_from_details on Tax.Calculation and Tax.TransactionAdd support for new resource FinancialConnections.Transaction
FinancialConnections.Transactionall and retrieve methods on resource Transactionsubscribe and unsubscribe methods on resource FinancialConnections.Accountfinancial_connections.account.refreshed_transactions on enum Event.typesubscriptions and transaction_refresh on FinancialConnections.Accounttransactions on enum FinancialConnections.Session.prefetch[]revolut_pay on PaymentMethodConfigurationid_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfigurationQuote.invoice_settings from nullable(InvoiceSettingQuoteSetting) to InvoiceSettingQuoteSettingdestination_details on RefundYour coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for retrieve method on resource FinancialConnections.Transaction
retrieve method on resource FinancialConnections.TransactionReports uses of the deprecated .save and of StripeClient in X-Stripe-Client-Telemetry. (You can disable telemetry via \Stripe\Stripe::setEnableTelemet…
.save and of StripeClient in X-Stripe-Client-Telemetry. (You can disable telemetry via \Stripe\Stripe::setEnableTelemetry(false);, see the README.)customer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enum StripeError.codepayment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.typevarious from enum Climate.Supplier.removal_pathwayinactive_message and restrictions on PaymentLink* #1610 Update generated code for beta
Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
Climate.Order, Climate.Product, and Climate.Supplierall, cancel, create, retrieve, and update methods on resource Orderall and retrieve methods on resources Product and Supplierfinancial_connections_account_inactive on enum StripeError.codeclimate_order_purchase and climate_order_refund on enum BalanceTransaction.typeclimate.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.typeAdd support for new value quote.reestimate_failed on enum Event.type
Add support for network_data on Issuing.Transaction
Add support for new value quote.reestimate_failed on enum Event.type
quote.reestimate_failed on enum Event.typemetadata on QuotePhaseAdd support for new value terminal_reader_hardware_fault on enum StripeError.code
terminal_reader_hardware_fault on enum StripeError.codeAdd support for attach_payment_intent method on resource Invoice
attach_payment_intent method on resource Invoicepost_payment_amount, pre_payment_amount, and refunds on CreditNoteinvoice.payment.overpaid on enum Event.typeamounts_due and payments on Invoicecreated on Issuing.PersonalizationDesign* #1602 Fix error when "id" is not a string.
Add support for new resource Tax.Registration
Tax.Registrationall, create, and update methods on resource Registrationtoken_card_network_invalid on enum StripeError.codepayment_unreconciled on enum BalanceTransaction.typerevolut_pay on PaymentMethodrevolut_pay on enum PaymentMethod.typeAdd support for new resource Margin
Marginall, create, retrieve, and update methods on resource Margindefault_margins and total_margin_amounts on Invoicemargins on InvoiceItemAdd support for new value balance_invalid_parameter on enum StripeError.code
balance_invalid_parameter on enum StripeError.codeThis release changes the pinned API version to 2023-10-16.
This release changes the pinned API version to 2023-10-16.
2023-10-16This release changes the pinned API version to 2023-10-16.
This release changes the pinned API version to 2023-10-16.
stripe-php package.additional_tos_acceptances field on Person* #1591 Update generated code for beta
Nothing published for this version
Add support for new values issuing_token.created and issuing_token.updated on enum Event.type
issuing_token.created and issuing_token.updated on enum Event.typeAdd support for new resources AccountNotice and Issuing.CreditUnderwritingRecord
AccountNotice and Issuing.CreditUnderwritingRecordall, retrieve, and update methods on resource AccountNoticeall, correct, create_from_application, create_from_proactive_review, report_decision, and retrieve methods on resource CreditUnderwritingRecordaccount_notice.created and account_notice.updated on enum Event.typeAdd support for client_secret, redirect_on_completion, return_url, and ui_mode on Checkout.Session
client_secret, redirect_on_completion, return_url, and ui_mode on Checkout.Sessionoffline on Terminal.ConfigurationAdd support for mark_draft and mark_stale methods on resource Quote
mark_draft and mark_stale methods on resource Quotedraft_quote and mark_stale_quote methods on resource Quoteallow_backdated_lines on QuotepreviewInvoiceLines to allPreviewInvoiceLines on resource QuoteAdd support for new resource Issuing.Token
Rename resources Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundle
Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundlereason on EventAdd support for rendering on Invoice
Remove support for customer on ConfirmationToken
customer on ConfirmationTokenissuer on InvoiceAdd back constant for invoiceitem.updated webhook event. This was mistakenly removed in v12.2.0.
Add support for new resource ConfirmationToken
ConfirmationTokenretrieve method on resource ConfirmationTokencreate method on resource Issuing.CardDesignreject_testmode test helper method on resource Issuing.CardDesignissuing_card_design.rejected on enum Event.typefeatures on Issuing.CardBundlecard_logo, carrier_text, preferences, and rejection_reasons on Issuing.CardDesignpreference on Issuing.CardDesignAdd support for capture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorization
capture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorizationcreate_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.Transactionstripe_tax_inactive on enum StripeError.codePaymentMethodConfigurationall, create, retrieve, and update methods on resource PaymentMethodConfigurationpayment_method_configuration_details on Checkout.Session, PaymentIntent, and SetupIntentRemove support for submit_card test helper method on resource Issuing.Card
Add support for new resource PaymentMethodDomain
PaymentMethodDomainall, create, retrieve, update, and validate methods on resource PaymentMethodDomaintreasury.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.typeinvoiceitem.updated from enum Event.typefeatures on ProductRename Quote.previewInvoices to Quote.allPreviewInvoices and Quote.previewSubscriptionSchedules to Quote.allSubscriptionSchedules
Quote.previewInvoices to Quote.allPreviewInvoices and Quote.previewSubscriptionSchedules to Quote.allSubscriptionSchedulesAdd support for payment_method_details on Dispute
payment_method_details on Disputeprefetch on FinancialConnections.SessionAccountSessioncreate method on resource AccountSessionobligation_inbound, obligation_outbound, obligation_payout_failure, obligation_payout, obligation_reversal_inbound, and obligation_reversal_outbound on enum BalanceTransaction.typeEvent.type from string to enumapplication on PaymentLink⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️
⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️
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
(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.
(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.
" ⚠️" symbol highlights breaking changes.
Invoice.STATUS_DELETEalternate_statement_descriptors, destination, and dispute on Chargecharge_refunded from enum Dispute.statusrendering on Invoiceattributes, caption, and deactivate_on on ProductThis release changes the pinned API version to 2023-08-16.
This release changes the pinned API version to 2023-08-16.
QuotePreviewInvoice and QuotePreviewScheduleapplies_to on Invoice and SubscriptionScheduleNothing published for this version
This release changes the pinned API version to 2023-08-16.
This release changes the pinned API version to 2023-08-16.
Please do not use stripe-php v11. It did not correctly apply the pinning behavior and was removed from packagist
Add support for paypal on PaymentMethodConfiguration
paypal on PaymentMethodConfigurationNothing published for this version
Add support for new value payment_reversal on enum BalanceTransaction.type
payment_reversal on enum BalanceTransaction.typeadjusted_for_overdraft on enum CustomerBalanceTransaction.typeAdd support for submit_card test helper method on resource Issuing.Card
submit_card test helper method on resource Issuing.CardAdd support for subscription_details on Invoice
subscription_details on Invoicesepa_debit_fingerprint and us_bank_account_fingerprint on enum Radar.ValueList.item_typeAdd support for new resource Tax.Form
Tax.Formall, pdf, and retrieve methods on resource Formpayment_method_configuration_details on Checkout.Session and SetupIntentUpdated stable APIs to the latest version
Add support for new value service_tax on enum TaxRate.tax_type
service_tax on enum TaxRate.tax_typeApplicationFee.refundsdeleted on Apps.SecretAdd support for new value service_tax on enum TaxRate.tax_type
Rename Tax.SettingsService -> Tax.SettingService
#1519 Update generated code for beta
Tax.SettingsService -> Tax.SettingService#1527 Update generated code for beta
Release specs are identical.
#1524 Update generated code for beta
PaymentMethodConfigurationall, create, retrieve, and update methods on resource PaymentMethodConfigurationpayment_method_configuration_details on PaymentIntentTax.SettingService -> Tax.SettingsService (parity with main release)Add support for new resource Tax.Settings
Tax.Settingsretrieve and update methods on resource Settingsinvalid_tax_location on enum StripeError.codeproduct on Tax.TransactionLineItemtax.settings.updated webhook eventChange type of Checkout.Session.success_url from string to nullable(string)
Checkout.Session.success_url from string to nullable(string)application_fees_not_allowed on enum StripeError.codeeffective_at on CreditNote and Invoiceon_behalf_of on MandateAdd support for payment_details on PaymentIntent
Add support for preferred_locales on Issuing.Cardholder
preferred_locales on Issuing.CardholderAdd support for subscription_details on Invoice
subscription_details on Invoiceset_pause_collection on QuoteLinelocations on Tax.Settings* #1504 Add default values for preview and raw_request parameters * #1505 Handle developer message in preview error responses * #1500 Update generated
Add support for new values amusement_tax and communications_tax on enum TaxRate.tax_type
Add support for subscribe and unsubscribe methods on resource FinancialConnections.Account
Add support for head_office on Tax.Settings
Change type of Identity.VerificationSession.options from VerificationSessionOptions to nullable(VerificationSessionOptions)
Identity.VerificationSession.options from VerificationSessionOptions to nullable(VerificationSessionOptions)Identity.VerificationSession.type from enum('document'|'id_number') to nullable(enum('document'|'id_number'))paypal on PaymentMethodeffective_percentage on TaxRateAdd support for country_options on Tax.Registration
country_options on Tax.Registrationstate and type on Tax.RegistrationAdd support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
collect_payment_method and confirm_payment_intent methods on resource Terminal.ReaderOne column per quarter.