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 6 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 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 MandateOne column per quarter.
Add support for new resource CustomerSession
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* #1500 Update generated code for beta * #1505 Handle developer message in preview error responses * #1504 Add default values for preview and raw_requ
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 TaxRate#1490 Update generated code
paypal on PaymentMethodeffective_percentage on TaxRate#1488 Increment PHPStan to strictness level 2
#1483 Update generated code
#1480 Update generated code
Identity.VerificationSession.options from VerificationSessionOptions to nullable(VerificationSessionOptions)Identity.VerificationSession.type from enum('document'|'id_number') to nullable(enum('document'|'id_number'))#1478 Update generated code
#1475 Update generated code
Add 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.ReaderUpdated stable APIs to the latest version
Add support for new value ioss on enum Tax.Registration.type
ioss on enum Tax.Registration.typeAdd back deleted from Invoice.status.
deleted from Invoice.status.This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the createFromCalculation method…
create method on resource Tax.Transaction
createFromCalculation method.deleted from enum Invoice.status
Add support for new resources Tax.CalculationLineItem and Tax.TransactionLineItem
Tax.CalculationLineItem and Tax.TransactionLineItemcollect_inputs method on resource Terminal.Readerfinancing_offer on Capital.FinancingSummarylink on enum PaymentLink.payment_method_types[]automatic_payment_methods on SetupIntentAdd support for new resources Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transaction
Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transactioncreate and list_line_items methods on resource Calculationcreate_from_calculation, create_reversal, create, list_line_items, and retrieve methods on resource Transactioncurrency_conversion on Checkout.Sessionautomatic_async on enum PaymentIntent.capture_methodlink on enum PaymentLink.payment_method_types[]automatic_payment_methods on SetupIntentAdd support for create_from_calculation method on resource Tax.Transaction
create_from_calculation method on resource Tax.TransactionInvoice.applies_to from nullable(QuotesResourceQuoteLinesAppliesTo) to QuotesResourceQuoteLinesAppliesToshipping_cost on Tax.Calculation and Tax.Transactiontax_breakdown on Tax.Calculationtax_summary on Tax.CalculationAdd support for new value cashapp on enum PaymentLink.payment_method_types[]
cashapp on enum PaymentLink.payment_method_types[]cashapp on PaymentMethodcashapp on enum PaymentMethod.typefuture_requirements and requirements on BankAccountautomatic_async on enum PaymentIntent.capture_methodcashapp on enum PaymentLink.payment_method_types[]cashapp on PaymentMethodcashapp on enum PaymentMethod.typeUpdated stable APIs to the latest version
list_transactions method on resource Tax.TransactionSubscriptionSchedule.applies_to from nullable(QuotesResourceQuoteLinesAppliesTo) to QuotesResourceQuoteLinesAppliesTotax_summary on Tax.Calculationtax_breakdown on Tax.Calculation* #1453 Restore StripeClient.getService
Add support for cancellation_details on Subscription
Updated stable APIs to the latest version
Issuing.CardBundle and Issuing.CardDesignall and retrieve methods on resource CardBundleall, retrieve, and update methods on resource CardDesigncard_design on Issuing.CardAdd support for reconciliation_status on Payout
reconciliation_status on Payoutlease_tax on enum TaxRate.tax_typeUpdated stable APIs to the latest version
Add support for new value igst on enum TaxRate.tax_type
igst on enum TaxRate.tax_typeUpdated stable APIs to the latest version
currency_conversion on Checkout.Sessionlimits on FinancialConnections.Sessionreference on Tax.Calculation* #1443 Remove init.php from the list of ignored files
Add support for refund_payment method on resource Terminal.Reader
visibility_required fixeractions/cacheactions/checkoutrefund_payment method on resource Terminal.Readercustom_fields on Checkout.Session and PaymentLinkrefund_payment method on resource Terminal.Readercustom_fields on Checkout.Session and PaymentLinkactions/checkoutvisibility_required fixeractions/cacheUpdated stable APIs to the latest version
all method on resource Transactioninferred_balances_refresh, subscriptions, and transaction_refresh on FinancialConnections.Accountmanual_entry, prefetch, status_details, and status on FinancialConnections.SessionFinancialConnections.TransactionAdd support for resume method on resource Subscription
resume method on resource Subscriptionamount_shipping and shipping_cost on CreditNote and Invoiceshipping_details on Invoiceinvoice_creation on PaymentLinktrial_settings on Subscriptionpaused on enum Subscription.statusUpdated stable APIs to the latest version
list_transactions method on resource Tax.TransactionUpdated stable APIs to the latest version
Tax.Settings resource.Added REFUND_CREATED, REFUND_UPDATED event definitions.
REFUND_CREATED, REFUND_UPDATED event definitions.#1381 Add getService methods to StripeClient and AbstractServiceFactory to allow mocking
#1424 API Updates
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
Updated stable APIs to the latest version
Tax.Registration resource.draft_quote method implementation from hitting /v1/quotes/{quotes}/draft to /v1/quotes/{quotes}/mark_draftUpdated stable APIs to the latest version
mark_stale_quote method on resource QuoteUpdated stable APIs to the latest version
$stripe->taxCalculations to $stripe->tax->calculations and $stripe->taxTransactions to $stripe->tax->transactions* #1413 API Updates Change CheckoutSession.cancel_url to be nullable.
CheckoutSession.cancel_url to be nullable.Updated stable APIs to the latest version
QuoteLine, TaxCalculation, and TaxTransactioncreate and list_line_items methods on resource TaxCalculationcreate_reversal, create, and retrieve methods on resource TaxTransactionAdd support for new value invoice_overpaid on enum CustomerBalanceTransaction.type
Updated stable APIs to the latest version
Add support for flow on BillingPortal.Session
flow on BillingPortal.SessionOrder and Skuall, cancel, create, list_line_items, reopen, retrieve, submit, and update methods on resource Orderall, create, delete, retrieve, and update methods on resource Skucustom_text on Checkout.Session and PaymentLinkinvoice_creation and invoice on Checkout.Sessionproduct on LineItemlatest_charge on PaymentIntentcharges on PaymentIntentBreaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, re…
This release changes the pinned API version to 2022-11-15.
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://docs.stripe.com/changelog/2022-11-15.
"⚠️" symbol highlights breaking changes.
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'],
]);
Orders resource and serviceProduct field from the LineItemSku resource and serviceAlipayAccount resourcecharges field on PaymentIntent and replace it with latest_charge.Add support for on_behalf_of on Subscription
Updated beta APIs to the latest stable version
Updated stable APIs to the latest version
network_data on Issuing.Transactionpaypal on Sourcepaypal on enum Source.typeAdd support for new values jp_trn and ke_pin on enum TaxId.type
Add support for created on Checkout.Session
Updated stable APIs to the latest version
Updated stable APIs to the latest version
FinancingOffer, FinancingSummary and FinancingTransaction resources.Add support for from_invoice and latest_revision on Invoice
from_invoice and latest_revision on Invoicepix on enum PaymentLink.payment_method_types[]pix on PaymentMethodpix on enum PaymentMethod.typecreated on Treasury.CreditReversal and Treasury.DebitReversalAdd support for new value terminal_reader_splashscreen on enum File.purpose
Update Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error and SetupIntent.setup_error type to be StripeObject
Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error and SetupIntent.setup_error type to be StripeObject.
ErrorObject for these fields, so the type annotation was incorrect.login_page on BillingPortal.ConfigurationUpdated stable APIs to the latest version
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 mino…
Treasury.OutboundTransfer.destination_payment_method from string to string | nullCustomerService.fundCashBalance test helper from CustomerBalanceTransaction to CustomerCashBalanceTransaction.
Updated stable APIs to the latest version
Stripe-Version beta headers are not pinned by-default and need to be manually specified, please refer to beta SDKs README sectionAdd support for new resource CustomerCashBalanceTransaction
CustomerCashBalanceTransactioncurrency on PaymentLinkcustomer_cash_balance_transaction.created webhook event.Updated stable APIs to the latest version
refundPayment method to Terminal resourceAdd support for expires_at on Apps.Secret
Your coding agent can read these notes before it upgrades. Set up the MCP server →