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 resources Billing.MeterErrorReport and Terminal.ReaderCollectedData
Billing.MeterErrorReport and Terminal.ReaderCollectedDataretrieve method on resource ReaderCollectedDataterminal_reader_collected_data_invalid on enum StripeError.codebilling.meter_error_report.triggered on enum Event.typeregulatory_reporting_file on Issuing.CreditUnderwritingRecordmb_way on enum PaymentLink.payment_method_types[]mb_way on PaymentMethodmb_way on enum PaymentMethod.typeAdd support for new value issuing_regulatory_reporting on enum File.purpose
issuing_regulatory_reporting on enum File.purposehr_oib on enum TaxId.typestatus_details on TestHelpers.TestClockYour coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for collected_information and permissions on Checkout.Session
collected_information and permissions on Checkout.Session* #1736 Update generated code
Add support for new value custom on enum Checkout.Session.ui_mode
custom on enum Checkout.Session.ui_modepayto on enum PaymentLink.payment_method_types[]Add support for activate, all, archive, create, deactivate, and retrieve methods on resource Billing.Alert
activate, all, archive, create, deactivate, and retrieve methods on resource Billing.Alertretrieve method on resource Tax.Calculationinvalid_mandate_reference_prefix_format on enum StripeError.coderelated_customer on Identity.VerificationSessionfinancial_addresses.aba.forwarding on enums Treasury.FinancialAccount.active_features[], Treasury.FinancialAccount.pending_features[], and Treasury.FinancialAccount.restricted_features[]Add support for attach_payment method on resource Invoice
attach_payment method on resource Invoicelast_price_migration_error on SubscriptionSchedule and SubscriptionAdd support for new resources Billing.AlertTriggered and Billing.Alert
Billing.AlertTriggered and Billing.Alertcharge_exceeds_transaction_limit on enum StripeError.codebilling.alert.triggered on enum Event.typeAdd support for new resources Billing.AlertTriggered, Billing.Alert, and Tax.Association
Billing.AlertTriggered, Billing.Alert, and Tax.Associationactivate, all, archive, create, deactivate, and retrieve methods on resource Alertfind method on resource Associationissuing.account_closed_for_not_providing_business_model_clarification, issuing.account_closed_for_not_providing_url_clarification, and issuing.account_closed_for_not_providing_use_case_clarification on enum AccountNotice.reasonasync_workflows on PaymentIntentpayto on PaymentMethodConfigurationdisplay_name on Treasury.FinancialAccountAdd support for update method on resource Checkout.Session
update method on resource Checkout.Sessioninvoice.overdue and invoice.will_be_due on enum Event.typetwint on PaymentMethodConfigurationAdd support for new value issuing_dispute.funds_rescinded on enum Event.type
* #1720 Update generated code for beta
⚠️ Remove support for values billing_policy_remote_function_response_invalid, billing_policy_remote_function_timeout, billing_policy_remote_function_u
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.payment_intent_fx_quote_invalid from enum StripeError.code. The was mistakenly released last week.payment_method_options on ConfirmationTokenThis release changes the pinned API version to 2024-06-20.
This release changes the pinned API version to 2024-06-20.
Add support for add_lines, remove_lines, and update_lines methods on resource Invoice
add_lines, remove_lines, and update_lines methods on resource Invoicepayment_intent_fx_quote_invalid on enum StripeError.codemultibanco, twint, and zip on enum PaymentLink.payment_method_types[]posted_at on Tax.Transactionreboot_window on Terminal.ConfigurationThis release changes the pinned API version to 2024-06-20.
This release changes the pinned API version to 2024-06-20.
#1714 Please read the API Changelog and carefully review the API changes before upgrading.
PlatformTaxFee_searchResource on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription as it is no longer used.finalize_amount test helper method on resource Issuing.Authorizationfleet and fuel on Issuing.Authorizationch_uid on enum TaxId.type* #1705 Syncing changes from 14.10.0 release
Replace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Add support for multibanco on PaymentMethodConfiguration and PaymentMethod
multibanco on PaymentMethodConfiguration and PaymentMethodtwint on PaymentMethodmultibanco and twint on enum PaymentMethod.typeinvoice_settings on Subscriptionde_stn on enum TaxId.typeKeeping up with the changes from version 14.9.0
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
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().
$appInfo to be of type array{name: string, version?: string, url?: string, partner_id?: string}create, update, delete, all, retrieve methods after moving them out of traits.issuing_personalization_design.activated, issuing_personalization_design.deactivated, issuing_personalization_design.rejected, and issuing_personalization_design.updated on enum Event.type* #1696 Update generated code for beta
Add support for new value terminal_reader_invalid_location_for_payment on enum StripeError.code
* #1693 Update generated code for beta
Add support for fee_source on ApplicationFee
fee_source on ApplicationFeeloss_reason on Issuing.Disputeapplication_fee_amount and application_fee on Payoutstripe_s700 on Terminal.ConfigurationNo new beta features. Merging changes from the main branch.
Add support for update test helper method on resources Treasury.OutboundPayment and Treasury.OutboundTransfer
update test helper method on resources Treasury.OutboundPayment and Treasury.OutboundTransfertreasury.outbound_payment.tracking_details_updated and treasury.outbound_transfer.tracking_details_updated on enum Event.typeallow_redisplay on PaymentMethodtracking_details on Treasury.OutboundPayment and Treasury.OutboundTransferAdd support for rechnung on PaymentMethod
rechnung on PaymentMethodrechnung on enum PaymentMethod.typeAdd support for new value shipping_address_invalid on enum StripeError.code
shipping_address_invalid on enum StripeError.codeship_from_details on Tax.Calculation and Tax.TransactionAdd support for cancel_subscription_schedule on QuoteLine
cancel_subscription_schedule on QuoteLineChange type of Entitlements.ActiveEntitlement.feature from string to expandable($Entitlements.Feature)
Entitlements.ActiveEntitlement.feature from string to expandable($Entitlements.Feature)mobilepay on PaymentMethodConfiguration* #1679 Update generated code for beta
Add support for create_preview method on resource Invoice
Add support for new resource Entitlements.ActiveEntitlementSummary
Entitlements.ActiveEntitlementSummaryentitlements.active_entitlement_summary.updated on enum Event.typeconfig on Forwarding.Request. This field is no longer used by the Forwarding Request API.swish on PaymentMethodConfigurationThis release changes the pinned API version to 2024-04-10.
This release changes the pinned API version to 2024-04-10.
Add support for new values billing_policy_remote_function_response_invalid, billing_policy_remote_function_timeout, billing_policy_remote_function_une
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.codeBilling.MeterEventAdjustment.cancel from BillingMeterResourceBillingMeterEventAdjustmentCancel to nullable(BillingMeterResourceBillingMeterEventAdjustmentCancel)amazon_pay on PaymentMethodConfiguration and PaymentMethodamazon_pay on enum PaymentMethod.typebh_vat, kz_bin, ng_tin, and om_vat on enum TaxId.typeRemove the below deprecated values on the enum BalanceTransaction.Type
This release changes the pinned API version to 2024-04-10.
#1673 Update generated code
2024-04-10. Please read the API Changelog and carefully review the API changes before upgrading.features to marketing_features on Product$curl = new \Stripe\HttpClient\CurlClient([
CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4
]);
\Stripe\ApiRequestor::setHttpClient($curl);
BalanceTransaction.Type
obligation_inboundobligation_payoutobligation_payout_failureobligation_reversal_outboundvarious on the enum Climate.Supplier.RemovalPathwayinvoiceitem.updatedorder.createdrecipient.createdrecipient.deletedrecipient.updatedsku.createdsku.deletedsku.updatedservice_tax on the enum TaxRate.TaxTypeid_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfigurationrendering_options in Invoice. Use rendering instead.Replace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Add support for new resources Entitlements.ActiveEntitlement and Entitlements.Feature
Entitlements.ActiveEntitlement and Entitlements.Featureall and retrieve methods on resource ActiveEntitlementall, create, retrieve, and update methods on resource Featurenone on enum Account.typecancel, event_name, and type on Billing.MeterEventAdjustmentAdd support for update method on resource Entitlements.Feature
update method on resource Entitlements.Featurerisk_controls on AccountSubscription.discounts and SubscriptionItem.discounts from nullable(array(expandable($Discount))) to array(expandable($Discount))Add support for subscription_item on Discount
subscription_item on Discountemail and phone on Identity.VerificationReportverification_flow on Identity.VerificationReport and Identity.VerificationSessionverification_flow on enums Identity.VerificationReport.type and Identity.VerificationSession.typeprovided_details on Identity.VerificationSessionInvoice.discounts from nullable(array(expandable(deletable($Discount)))) to array(expandable(deletable($Discount)))zip on PaymentMethodConfigurationdiscounts on SubscriptionItem and Subscriptionmobile_phone_reader on enum Terminal.Reader.device_typeAdd support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meterall, create, deactivate, reactivate, retrieve, and update methods on resource Metercreate method on resources MeterEventAdjustment and MeterEventmeter on PlanAdd support for new resources Entitlements.ActiveEntitlementSummary and Entitlements.ActiveEntitlement
Entitlements.ActiveEntitlementSummary and Entitlements.ActiveEntitlementall method on resource ActiveEntitlementuse_stripe_sdk on ConfirmationTokenpayment_method on ConfirmationTokenConfirmationToken.mandate_data from ConfirmationTokensResourceMandateData to nullable(ConfirmationTokensResourceMandateData)active and metadata on Entitlements.Featureentitlements.active_entitlement_summary.updated on enum Event.typecustomer.entitlement_summary.updated from enum Event.typeAdd support for new resources ConfirmationToken and Forwarding.Request
ConfirmationToken and Forwarding.Requestretrieve method on resource ConfirmationTokenall, create, and retrieve methods on resource Requestforwarding_api_inactive, forwarding_api_invalid_parameter, forwarding_api_upstream_connection_error, and forwarding_api_upstream_connection_timeout on enum StripeError.codemobilepay on PaymentMethodmobilepay on enum PaymentMethod.typename on Terminal.ConfigurationAdd support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meterall, create, deactivate, reactivate, retrieve, and update methods on resource Metercreate method on resources MeterEventAdjustment and MeterEventcreate test helper method on resource ConfirmationTokenadd_lines, remove_lines, and update_lines methods on resource Invoicemultibanco on PaymentMethodConfiguration and PaymentMethodmultibanco on enum PaymentMethod.typemeter on PlanAdd 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.PersonalizationDesignChange 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* #1626 Update generated code for beta * #1628 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.RegistrationOne column per quarter.