NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #214 most downloaded on Packagist
Stripe PHP Library
Last release 5 days ago
16 Sep 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
689 releases · first in 2012
Add support for new resources Issuing.PersonalizationDesign and Issuing.PhysicalBundle
Issuing.PersonalizationDesign and Issuing.PhysicalBundleall, create, retrieve, and update methods on resource PersonalizationDesignall and retrieve methods on resource PhysicalBundlepersonalization_design on Issuing.CardRemove support for resource Entitlements.Event
Entitlements.EventConfirmationToken.mandate_data from nullable(ConfirmationTokensResourceMandateData) to ConfirmationTokensResourceMandateDataquantity and type on Entitlements.Featurelivemode on Issuing.PersonalizationDesignOne column per quarter.
Change type of Identity.VerificationSession.type from nullable(enum('document'|'id_number')) to enum('document'|'id_number')
Identity.VerificationSession.type from nullable(enum('document'|'id_number')) to enum('document'|'id_number')Application, ConnectCollectionTransfer, PlatformTaxFee, ReserveTransaction, SourceMandateNotification, and TaxDeductedAtSource. These classes have no methods on them, and are used to provide more complete types for PHPDocs.* #1652 Update generated code for beta
Add support for all, create, delete, and retrieve methods on resource TaxId
all, create, delete, and retrieve methods on resource TaxIdinstanceUrl function on TaxId now returns the top-level /v1/tax_ids/{id} path instead of the /v1/customers/{customer}/tax_ids/{id} path.client_reference_id on Identity.VerificationReport and Identity.VerificationSessionservice_tax from enum TaxRate.tax_typeAdd support for decrement_authorization method on resource PaymentIntent
decrement_authorization method on resource PaymentIntentpayment_method_options on ConfirmationTokenpayto and twint on PaymentMethodpayto and twint on enum PaymentMethod.typeBugfix: remove support for CustomerCashBalanceTransaction::all and CustomerCashBalanceTransaction::retrieve. These methods were included in the librar
CustomerCashBalanceTransaction::all and CustomerCashBalanceTransaction::retrieve. These methods were included in the library unintentionally and never functioned.networks on Cardfinancial_connections.account.refreshed_ownership on enum Event.typeAdd support for new resources Entitlements.Event and Entitlements.Feature
Entitlements.Event and Entitlements.Featurecreate method on resource Eventall and create methods on resource Featurecustomer.entitlement_summary.updated on enum Event.typeAdd support for issuer on Invoice
issuer on Invoicecustomer_balance on PaymentMethodConfigurationswish on enum PaymentLink.payment_method_types[]swish on PaymentMethodswish on enum PaymentMethod.typejurisdiction_level on TaxRateTerminal.Reader.status from string to enum('offline'|'online')Add support for create_preview method on resource Invoice
create_preview method on resource Invoicecharged_off_at on Capital.FinancingOfferenhanced_eligibility_types on Dispute* #1632 Beta: report usage of rawRequest
rawRequest* #1628 Update generated code for beta * #1626 Update generated code for beta
Add support for new resource CustomerSession
CustomerSessioncreate method on resource CustomerSessionobligation_inbound, obligation_payout_failure, obligation_payout, and obligation_reversal_outbound from enum BalanceTransaction.typebilling_cycle_anchor_config on SubscriptionUpdated stable APIs to the latest version
Add support for retrieve method on resource Tax.Registration
retrieve method on resource Tax.RegistrationAdd 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 RefundAdd support for retrieve method on resource FinancialConnections.Transaction
Reports 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 components and created on CustomerSession
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.codeUpdate 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
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 ProductAdd support for new resources QuotePreviewInvoice and QuotePreviewSchedule
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 PaymentMethodConfigurationAdd 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
Add support for new resource PaymentMethodConfiguration
PaymentMethodConfigurationall, create, retrieve, and update methods on resource PaymentMethodConfigurationpayment_method_configuration_details on PaymentIntentTax.SettingService -> Tax.SettingsService (parity with main release)Tax.SettingsService -> Tax.SettingServiceYour coding agent can read these notes before it upgrades. Set up the MCP server →