NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #216 most downloaded on Packagist
Stripe PHP Library
Last release 2 days ago
01 Oct 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
693 releases · first in 2012
Add support for new values jp_trn and ke_pin on enum TaxId.type
One column per quarter.
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
Updated stable APIs to the latest version
Order resource supportBreaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more deta…
This release changes the pinned API version to 2022-08-01.
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://docs.stripe.com/changelog/2022-08-01.
"⚠️" symbol highlights breaking changes.
alternate_statement_descriptors, authorization_code, and level3 properties to Charge resource.ErrorObject.previewLines method to CreditNote resource.SOURCE_TYPE_FPX constant to Transfer resource.shipping_cost and shipping_details on Checkout.Sessiontransfer_data property to Subscription resource.params parameter to close method in Dispute resource.Card resources for a particular Recipient.all method from LineItem.allTransactions method from SourceService service. Please use allSourceTransactions method instead.AssociatedObjects array property from EphemeralKey resource. The field was undocumented and unsupported.cancel method from Transfer and TransferService. This method is deprecated.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.AlipayAccount, BitcoinReceiver, BitcoinTransaction, Recipient, RecipientTransfer, and ThreeDSecure resources.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.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.details method from Card resource. The endpoint was deprecated and no longer exists.FAILURE_REASON constant from Refund resource. The value was deprecated.OrderItem resource. The resource was deprecated.persons method from Account resource. Please use allPersons method instead.recipient property from Card resource. The property was deprecated.Recipient resource. The resource was deprecated.sources property from Card resource. The property was deprecated.sourceTransactions method from Source resource. Please use allSourceTransactions method instead.SOURCE_TYPE_ALIPAY_ACCOUNT and SOURCE_TYPE_FINANCING constants from Transfer resource. The values were deprecated and are no longer in use.usageRecordSummaries method from SubscriptionItem resource. Please use allUsageRecordSummaries method instead.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://docs.stripe.com/changelog/2022-08-01.
"⚠️" symbol highlights breaking changes.
Nothing published for this version
Add support for default_currency and invoice_credit_balance on Customer
default_currency and invoice_credit_balance on CustomerUpdated stable APIs to the latest version
server_side_confirmation_beta=v1 betasecretKeyConfirmation to PaymentIntentQuotePhaseConfiguration service.Price.migrate_to propertySubscriptionSchedule.amend method.Discount.subscription_item property.Quote.subscription_data.billing_behavior, billing_cycle_anchor, end_behavior, from_schedule, from_subscription, prebilling, proration_behavior properties.phases parameter to Quote.createSubscription.discounts, prebilling properties.QuotePhase resourceChange type of source_type on Transfer from nullable string to string (comment-only change)
source_type on Transfer from nullable string to string (comment-only change)blik on enum PaymentLink.payment_method_types[]blik on PaymentMethodblik on enum PaymentMethod.typeInvoice.upcomingLines method.SourceService.allSourceTransactions method.Add support for new values financial_connections.account.created, financial_connections.account.deactivated, financial_connections.account.disconnecte
Event.currency_options on Coupon and Pricecurrency on SubscriptionAdd support for deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Card
deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Cardsubtotal_excluding_tax on CreditNote and Invoiceamount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItemtotal_excluding_tax on InvoicePaymentLink.payment_method_types[] from literal('card') to enumpromptpay on PaymentMethodpromptpay on enum PaymentMethod.typehosted_regulatory_receipt_url and reversal_details on Treasury.ReceivedCredit and Treasury.ReceivedDebitAdd support for custom_unit_amount on Price
Add support for custom_unit_amount on Price
#1307 Support updating pre-release versions
#1305 Trigger workflows on beta branches
#1302 API Updates
custom_unit_amount on Price#1301 API Updates
Documentation updates.
#1306 API Updates
fund_cash_balance test helper method on resource Customertotal_excluding_tax on CreditNoterendering_options on InvoiceAdd support for attach_to_self and flow_directions on SetupAttempt
attach_to_self and flow_directions on SetupAttemptAdd support for radar_options on Charge and PaymentMethod
radar_options on Charge and PaymentMethodsimulated_wisepos_e on enum Terminal.Reader.device_typeAdd support for persons method on resource Account
Add support for new resource Apps.Secret
Add support for new resources Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.
Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.FlowDetails, Treasury.InboundTransfer, Treasury.OutboundPayment, Treasury.OutboundTransfer, Treasury.ReceivedCredit, Treasury.ReceivedDebit, Treasury.TransactionEntry, and Treasury.Transactionretrieve_payment_method method on resource Customerall and list_owners methods on resource FinancialConnections.Accounttreasury on Issuing.Authorization, Issuing.Dispute, and Issuing.Transactionfinancial_account on Issuing.Cardclient_secret on Orderattach_to_self and flow_directions on SetupIntentAdd support for consent_collection, customer_creation, payment_intent_data, shipping_options, submit_type, and tax_id_collection on PaymentLink
consent_collection, customer_creation, payment_intent_data, shipping_options, submit_type, and tax_id_collection on PaymentLinkdescription on Subscription⚠️ #1283 Major version release of v8.0.0. The migration guide contains more information.
⚠️ #1283 Major version release of v8.0.0. The migration guide contains more information.
(⚠️ = breaking changes):
Order API with the new Order API.
Order.cancel, list_line_items, reopen, and submitpay and return_orderOrderItem and OrderReturnCharge.order\FinancialConnections\Account.refresh method to \FinancialConnections\Account.refresh_accountamount_discount, amount_tax, and product on LineItemAdd support for default_price on Product
default_price on Productinstructions_email on RefundAdd support for registered_address on Person
Add support for new resource CashBalance
CashBalanceBillingPortal.Configuration.application from $Application to deletable($Application)cash_balance on Customerapplication on Invoice, Quote, SubscriptionSchedule, and Subscriptioneu_oss_vat on enum TaxId.typeAdd support for expire test helper method on resource Refund
expire test helper method on resource RefundNothing published for this version
Add support for new resources FundingInstructions and Terminal.Configuration
FundingInstructions and Terminal.Configurationcreate_funding_instructions method on resource Customeramount_details on PaymentIntentcustomer_balance on PaymentMethodcustomer_balance on enum PaymentMethod.typeconfiguration_overrides on Terminal.LocationNothing published for this version
Add support for increment_authorization method on resource PaymentIntent
Nothing published for this version
Add payment_intent.partially_funded, terminal.reader.action_failed, and terminal.reader.action_succeeded events.
Add support for cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.Reader
cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.Readeraction on Terminal.ReaderAdd support for search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription
search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and SubscriptionAdd support for PayNow and US Bank Accounts Debits payments
paynow and us_bank_account on PaymentMethodpaynow and us_bank_account on enum PaymentMethod.typefailure_balance_transaction on ChargeAdd support for cancel method on resource Refund
cancel method on resource Refundbg_uic, hu_tin, and si_tin on enum TaxId.typetest_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.* #1249 Add missing constant for payment_behavior * #1251 Add support for SearchResult objects. * #1254 API Updates * Add support for status on Card
Add support for proration_details on InvoiceLineItem
proration_details on InvoiceLineItemAdd support for new values bbpos_wisepad3 and stripe_m2 on enum Terminal.Reader.device_type
bbpos_wisepad3 and stripe_m2 on enum Terminal.Reader.device_typeTestHelpers.TestClocktest_clock on Customer, Invoice, InvoiceItem, Quote, Subscription, and SubscriptionSchedulenext_action on Refundkonbini on PaymentMethodAdd support for verify_microdeposits method on resources PaymentIntent and SetupIntent
Add REASON_EXPIRED_UNCAPTURED_CHARGE enum value on Refund.
REASON_EXPIRED_UNCAPTURED_CHARGE enum value on Refund.Add support for phone_number_collection on PaymentLink
phone_number_collection on PaymentLinkis_vat on enum TaxId.typeAdd support for new resource PaymentLink
PaymentLinkpayment_link on Checkout.SessionAdd support for paid_out_of_band on Invoice
paid_out_of_band on InvoiceAdd support for customer_creation on Checkout.Session
Add support for processing on PaymentIntent
Add support for metadata on BillingPortal.Configuration
metadata on BillingPortal.Configurationwallets on Issuing.CardAdd support for new values ge_vat and ua_vat on enum TaxId.type
As of this version, PHP 8.1 is officially supported.
* #1211 PHPStan compatibility with PHP8.x * #1209 PHPUnit compatibility with PHP 8.x
Add support for new value jct on enum TaxRate.tax_type
jct on enum TaxRate.tax_typeAdd support for automatic_payment_methods on PaymentIntent
automatic_payment_methods on PaymentIntentYour coding agent can read these notes before it upgrades. Set up the MCP server →