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 4 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 values payout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.type
payout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.typeAdd support for network_advice_code and network_decline_code on StripeError
network_advice_code and network_decline_code on StripeErrorinvoice.overpaid on enum Event.typeadjustable_quantity, display, and metadata on LineItemLineItem.description from string to nullable(string)One column per quarter.
This release changes the pinned API version to 2024-11-20.acacia.
This release changes the pinned API version to 2024-11-20.acacia.
respond test helper method on resource Issuing.Authorizationadaptive_pricing on Checkout.Sessionsubscribe on enums Checkout.Session.submit_type and PaymentLink.submit_typefinancial_account_statement on enum File.purposefraud_challenges and verified_by_fraud_challenge on Issuing.Authorizationtrace_id on Payoutli_vat on enum TaxId.typeservice_tax on enum TaxRate.tax_typeTreasury.InboundTransfer.origin_payment_method from string to nullable(string)* #1784 Update generated code for beta
Add support for new resources Issuing.FraudLiabilityDebit, PaymentAttemptRecord, and PaymentRecord
Issuing.FraudLiabilityDebit, PaymentAttemptRecord, and PaymentRecordall and retrieve methods on resources FraudLiabilityDebit and PaymentAttemptRecordreport_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt, report_payment, and retrieve methods on resource PaymentRecordadaptive_pricing on Checkout.Sessioninvoice.payment_attempt_required and issuing_fraud_liability_debit.created on enum Event.typeamount_overpaid on Invoiceli_vat on enum TaxId.typeservice_tax on enum TaxRate.tax_typeTreasury.InboundTransfer.origin_payment_method from string to nullable(string)Add support for trigger_action method on resource PaymentIntent
trigger_action method on resource PaymentIntentpayout_statement_descriptor_profanity from enum StripeError.codeid_bank_transfer on PaymentMethodConfiguration and PaymentMethodgopay, qris, and shopeepay on PaymentMethodConfigurationThis release changes the pinned API version to 2024-10-28.acacia.
This release changes the pinned API version to 2024-10-28.acacia.
V2.EventDestinationscreate, retrieve, update, list, delete, disable, enable and ping methods on resource V2.EventDestinationssubmit_card test helper method on resource Issuing.Cardgroups on Accountenhanced_eligibility_types on Disputeissuing_transaction.purchase_details_receipt_updated and refund.failed on enum Event.typemetadata on Forwarding.Requestalma on enum PaymentLink.payment_method_types[]alma on PaymentMethodConfiguration and PaymentMethodkakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodalma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enum PaymentMethod.typeamazon_pay on PaymentMethodDomainby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enum TaxId.typeflat_amount and rate_type on TaxRateretail_delivery_fee on enum TaxRate.tax_typeRemove support for value expired from enum Issuing.Authorization.status
expired from enum Issuing.Authorization.statusalma, gopay, qris, and shopeepay on enum PaymentLink.payment_method_types[]alma on PaymentMethodConfiguration and PaymentMethodgopay, qris, and shopeepay on PaymentMethodalma, gopay, qris, and shopeepay on enum PaymentMethod.typeamazon_pay on PaymentMethodDomainau_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on Tax.Formau_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on enum Tax.Form.typeAdd support for submit_card test helper method on resource Issuing.Card
submit_card test helper method on resource Issuing.Cardgroups on Accountpayout_statement_descriptor_profanity on enum StripeError.coderefund.failed on enum Event.typemetadata on Forwarding.Requestexpired on enum Issuing.Authorization.statuskakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodkakao_pay, kr_card, naver_pay, payco, and samsung_pay on enum PaymentMethod.typeby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enum TaxId.typeflat_amount and rate_type on TaxRateretail_delivery_fee on enum TaxRate.tax_typethe http method as parameter instead of the dedicated methods in the Preview class
Preview class has been removed. Please use rawRequest instead which accepts
* the http method as parameter instead of the dedicated methods in the Preview class
* an apiMode of v1 instead of standard and v2 instead of preview.Fixes a bug where v2 EventData was not being deserialized into the appropriate type for V1BillingMeterErrorReportTriggeredEvent and V1BillingMeterNoMe
V1BillingMeterErrorReportTriggeredEvent and V1BillingMeterNoMeterFoundEventobject property of the MeterEvent, MeterEventAdjustment, and MeterEventSession didn't match the server.Remove the support for resource Margin that was accidentally made public in the last release
Margin that was accidentally made public in the last releaseThis release changes the pinned API version to 2024-09-30.acacia.
This release changes the pinned API version to 2024-09-30.acacia.
#1756 Support for APIs in the new API version 2024-09-30.acacia
This release changes the pinned API version to 2024-09-30.acacia. Please read the API Changelog and carefully review the API changes before upgrading.
usage_threshold_config to usage_threshold on Billing.Alertfilter on Billing.Alert. Use the filters on the usage_threshold insteadinternational_transaction on enum Treasury.ReceivedCredit.failure_codeBilling.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events under the v2 namespace parseThinEvent() on the StripeClient class to parse thin events.StripeClient class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.Remove support for resource QuotePhase
QuotePhaselist_line_items and retrieve methods on resource QuotePhaserechnung on enum PaymentLink.payment_method_types[]Add support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code
international_transaction on enum Treasury.ReceivedDebit.failure_codeterminal_reader_invalid_location_for_activation on enum StripeError.codeautomatically_finalizes_at on InvoiceAdd support for new resources Issuing.DisputeSettlementDetail and Issuing.Settlement
Issuing.DisputeSettlementDetail and Issuing.Settlementall and retrieve methods on resource DisputeSettlementDetailall method on resource QuotePhaseissuing_dispute_settlement_detail.created, issuing_dispute_settlement_detail.updated, issuing_settlement.created, and issuing_settlement.updated on enum Event.typesettlement on Issuing.TransactionAdd support for new resource InvoiceRenderingTemplate
InvoiceRenderingTemplateall, archive, retrieve, and unarchive methods on resource InvoiceRenderingTemplateAdd 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.TestClockAdd 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 ConfirmationTokenAdd support for new resource FinancialConnections.Institution
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
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 PaymentMethodConfiguration* #1674 Merged from master
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.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 PlanYour coding agent can read these notes before it upgrades. Set up the MCP server →