This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

⚠️ Breaking change: #2038 Drop support for PHP < 7.2. This is also the last major version to support PHP 7.2 and 7.3. Please upgrade to 7.4+ before September 2026. See the versioning policy for more information.
⚠️ Breaking change: #2042 Preserve null values in v2 JSON request bodies
- The SDK now preserves and sends null when set in V2 API metadata and params, enabling you to clear metadata entries and some unsettable properties for V2 APIs.
- ⚠️ The Util::objectsToIds() method now has a required $serializeNull parameter to indicate if null values set in the object should be output in the resulting hash. This is relevant for V2 POST APIs to let callers clear emptyable values.
#1917 Avoid using func_get_args
#2011 Ensure that previous_attributes is always an instance of StripeObject
#2033 Add runtime support for V2 int64 string-encoded fields

⚠️ Breaking changes due to changes in the Stripe API

#2041 ⚠️ Throw an error when using the wrong webhook parsing method
Generated changes from #2046, #2044, #2025
- Add support for upi_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
- Add support for upi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout\Session.create().$params.payment_method_option, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_datum, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_option
- Add support for new value tempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
- Add support for integration_identifier on Checkout.Session and Checkout\Session.create().$params
- Add support for crypto on Checkout\Session.create().$params.payment_method_option
- Add support for pending_invoice_item_interval on Checkout\Session.create().$params.subscription_datum
- Add support for new values elements, embedded_page, form, and hosted_page on enum Checkout.Session.ui_mode
- Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
- Add support for new value upi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Add support for metadata on CreditNote.create().$params.line, CreditNote.preview().$params.line, CreditNote.preview_lines().$params.line, and CreditNoteLineItem
- Add support for quantity_decimal on Invoice.add_lines().$params.line, Invoice.create_preview().$params.invoice_item, Invoice.update_lines().$params.line, InvoiceItem.create().$params, InvoiceItem.update().$params, InvoiceItem, InvoiceLineItem.update().$params, and InvoiceLineItem
- ⚠️ Add support for level on Issuing\Authorization.create().$params.risk_assessment.card_testing_risk and Issuing\Authorization.create().$params.risk_assessment.merchant_dispute_risk
- ⚠️ Remove support for risk_level on Issuing\Authorization.create().$params.risk_assessment.card_testing_risk and Issuing\Authorization.create().$params.risk_assessment.merchant_dispute_risk
- Add support for lifecycle_controls on Issuing.Card and Issuing\Card.create().$params
- ⚠️ Change type of Issuing.Token.network_data.visa.card_reference_id from string to nullable(string)
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to nullable(enum)
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to nullable(longInteger)
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to nullable(longInteger)
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to nullable(string)
- ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to nullable(boolean)
- Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
- Add support for new value upi on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
- Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_action
- Add support for new value upi on enum PaymentLink.payment_method_types
- Add support for recommended_action and signals on Radar.PaymentEvaluation
- ⚠️ Remove support for insights on Radar.PaymentEvaluation
- Add support for new value crypto_fingerprint on enum Radar.ValueList.item_type
- Add support for new value canceled_by_retention_policy on enum Subscription.cancellation_details.reason
- ⚠️ Change type of V2.Core.EventDestination.events_from from enum('other_accounts'|'self') to string
- Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

19.4.1

#2024 Add Stripe-Request-Trigger header
#2022 Add agent information to UserAgent

19.4.0

This release changes the pinned API version to 2026-02-25.clover.

#2016 Update generated code
- Add support for new resources Reserve.Hold, Reserve.Plan, and Reserve.Release
- Add support for location and reader on Charge.payment_method_details.card_present, Charge.payment_method_details.interac_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.interac_present, PaymentMethod.card.generated_from.payment_method_details.card_present, PaymentRecord.payment_method_details.card_present, and PaymentRecord.payment_method_details.interac_present
- Add support for new value lk_vat on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
- Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
- Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum File.purpose
- Add support for new value pay_by_bank on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for display_name and service_user_number on Mandate.payment_method_details.bacs_debit
- Change type of PaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to nullable(string)
- Change type of PaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from nullable(string) to string
- Add support for transaction_purpose on PaymentIntent.confirm().$params.payment_method_option.us_bank_account, PaymentIntent.create().$params.payment_method_option.us_bank_account, PaymentIntent.payment_method_options.us_bank_account, and PaymentIntent.update().$params.payment_method_option.us_bank_account
- Add support for optional_items on PaymentLink.update().$params
- Remove support for unused card_issuer_decline on Radar.PaymentEvaluation.insights
- Add support for payment_behavior on SubscriptionItem.delete().$params
- Add support for lk on Tax.Registration.country_options and Tax\Registration.create().$params.country_option
- Add support for cellular and stripe_s710 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
- Add support for new values simulated_stripe_s710 and stripe_s710 on enum Terminal.Reader.device_type
- Add support for snapshot events RESERVE_HOLD_CREATED and RESERVE_HOLD_UPDATED with resource Reserve.Hold
- Add support for snapshot events RESERVE_PLAN_CREATED, RESERVE_PLAN_DISABLED, RESERVE_PLAN_EXPIRED, and RESERVE_PLAN_UPDATED with resource Reserve.Plan
- Add support for snapshot event RESERVE_RELEASE_CREATED with resource Reserve.Release
- Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

19.3.0

This release changes the pinned API version to 2026-01-28.clover.

#2001 Update generated code
- Add support for new resource Radar.PaymentEvaluation
- Add support for create method on resource Radar.PaymentEvaluation
- Add support for adjustable_quantity on LineItem
- Add support for new value risk_reserved on enum BalanceTransaction.balance_type
- Add support for new values reserve_hold and reserve_release on enum BalanceTransaction.type
- Add support for new values 2.3.0 and 2.3.1 on enums Charge.payment_method_details.card.three_d_secure.version and SetupAttempt.payment_method_details.card.three_d_secure.version
- Add support for new value adyen on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
- Add support for new value ADYBNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
- Add support for new value pl_nip on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
- Change Invoice.payment_settings.payment_method_options.payto and Subscription.payment_settings.payment_method_options.payto to be required
- Add support for enforce_arithmetic_validation on PaymentIntent.capture().$params.amount_detail, PaymentIntent.confirm().$params.amount_detail, PaymentIntent.create().$params.amount_detail, PaymentIntent.increment_authorization().$params.amount_detail, and PaymentIntent.update().$params.amount_detail
- Add support for error on PaymentIntent.amount_details
- Remove support for bgn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
- Add support for topup on Treasury.ReceivedDebit.linked_flows
- Add support for contact_phone on V2.Core.Account, V2\Core\Account.create().$params, V2\Core\Account.update().$params, and V2\Core\AccountToken.create().$params
- Add support for registration_date on V2.Core.Account.identity.business_details, V2\Core\Account.create().$params.identity.business_detail, V2\Core\Account.update().$params.identity.business_detail, and V2\Core\AccountToken.create().$params.identity.business_detail
- Add support for new value gb_vat on enum V2.Core.Account.identity.business_details.id_numbers[].type
- Add support for error code request_blocked on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
#2000 Add guidance for undocumented API parameters

19.2.0

#1997 Update generated code
- Add support for event notifications V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingDefaultsUpdatedEvent, V2CoreAccountIncludingFutureRequirementsUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, V2CoreAccountIncludingRequirementsUpdatedEvent, and V2CoreAccountUpdatedEvent with related object V2.Core.Account
- Add support for event notification V2CoreAccountLinkReturnedEvent
- Add support for event notifications V2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object V2.Core.AccountPerson
#1984 Improve webhook signature validation doc block

19.1.0

This release changes the pinned API version to 2025-12-15.clover.

#1975 Update generated code
- Add support for new resources V2.Core.AccountLink, V2.Core.AccountPersonToken, V2.Core.AccountPerson, V2.Core.AccountToken, and V2.Core.Account
- Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
- Add support for create method on resource V2.Core.AccountLink
- Add support for all, close, create, retrieve, and update methods on resource V2.Core.Account
- Add support for all, create, delete, retrieve, and update methods on resource V2.Core.AccountPerson
- Add support for customer_account on Billing.CreditBalanceSummary, Billing.CreditGrant, BillingPortal.Session, BillingPortal\Session.create().$params, Billing\CreditBalanceSummary.retrieve().$params, Billing\CreditBalanceTransaction.all().$params, Billing\CreditGrant.all().$params, Billing\CreditGrant.create().$params, CashBalance, Checkout.Session, Checkout\Session.all().$params, Checkout\Session.create().$params, ConfirmationToken.payment_method_preview, CreditNote.all().$params, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSession.create().$params, CustomerSession, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.Session.account_holder, FinancialConnections\Account.all().$params.account_holder, FinancialConnections\Session.create().$params.account_holder, Invoice.all().$params, Invoice.create().$params, Invoice.create_preview().$params, InvoiceItem.all().$params, InvoiceItem.create().$params, InvoiceItem, Invoice, PaymentIntent.all().$params, PaymentIntent.create().$params, PaymentIntent.update().$params, PaymentIntent, PaymentMethod.all().$params, PaymentMethod.attach().$params, PaymentMethod, PromotionCode.all().$params, PromotionCode.create().$params, PromotionCode, Quote.all().$params, Quote.create().$params, Quote.update().$params, Quote, SetupAttempt, SetupIntent.all().$params, SetupIntent.create().$params, SetupIntent.update().$params, SetupIntent, Subscription.all().$params, Subscription.create().$params, SubscriptionSchedule.all().$params, SubscriptionSchedule.create().$params, SubscriptionSchedule, Subscription, TaxId.all().$params.owner, TaxId.create().$params.owner, TaxId.owner, and TaxId
- Add support for metadata on Checkout\Session.create().$params.line_item and LineItem
- Add support for payto_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
- Add support for signer on Account.create().$params.document.proof_of_registration, Account.create().$params.document.proof_of_ultimate_beneficial_ownership, Account.update().$params.document.proof_of_registration, and Account.update().$params.document.proof_of_ultimate_beneficial_ownership
- Change BillingPortal\Session.create().$params.customer, Billing\CreditBalanceSummary.retrieve().$params.customer, Billing\CreditBalanceTransaction.all().$params.customer, Billing\CreditGrant.create().$params.customer, CustomerSession.create().$params.customer, InvoiceItem.create().$params.customer, PaymentMethod.attach().$params.customer, and Subscription.create().$params.customer to be optional
- Add support for billing_cycle_anchor on BillingPortal.Configuration.features.subscription_update, BillingPortal\Configuration.create().$params.feature.subscription_update, and BillingPortal\Configuration.update().$params.feature.subscription_update
- Add support for payto on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout\Session.create().$params.payment_method_option, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, Invoice.create().$params.payment_setting.payment_method_option, Invoice.payment_settings.payment_method_options, Invoice.update().$params.payment_setting.payment_method_option, Mandate.payment_method_details, PaymentAttemptRecord.payment_method_details, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethod.update().$params, PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_datum, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, SetupIntent.update().$params.payment_method_datum, SetupIntent.update().$params.payment_method_option, Subscription.create().$params.payment_setting.payment_method_option, Subscription.payment_settings.payment_method_options, and Subscription.update().$params.payment_setting.payment_method_option
- Add support for expected_debit_date on Charge.payment_method_details.acss_debit, Charge.payment_method_details.au_becs_debit, Charge.payment_method_details.bacs_debit, Charge.payment_method_details.nz_bank_account, Charge.payment_method_details.sepa_debit, Charge.payment_method_details.us_bank_account, PaymentAttemptRecord.payment_method_details.acss_debit, PaymentAttemptRecord.payment_method_details.au_becs_debit, PaymentAttemptRecord.payment_method_details.bacs_debit, PaymentAttemptRecord.payment_method_details.nz_bank_account, PaymentAttemptRecord.payment_method_details.sepa_debit, PaymentAttemptRecord.payment_method_details.us_bank_account, PaymentRecord.payment_method_details.acss_debit, PaymentRecord.payment_method_details.au_becs_debit, PaymentRecord.payment_method_details.bacs_debit, PaymentRecord.payment_method_details.nz_bank_account, PaymentRecord.payment_method_details.sepa_debit, and PaymentRecord.payment_method_details.us_bank_account
- Add support for new value mollie on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
- Add support for new value MLLENL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
- Add support for line_items on Checkout\Session.update().$params
- Add support for new value payto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Add support for invoice on CustomerBalanceTransaction.all().$params
- Add support for related_customer_account on Identity.VerificationSession, Identity\VerificationSession.all().$params, and Identity\VerificationSession.create().$params
- Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable($Price)
- Add support for new value payto on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for subtotal on InvoiceLineItem
- Add support for authorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
- Add support for new value payto on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
- Change PaymentIntent.transfer_data to be optional
- Add support for new value payto on enum PaymentLink.payment_method_types
- Add support for allow_redisplay on PaymentMethod.all().$params
- Add support for reported_by on PaymentRecord
- Change Product.tax_code to be optional
- Add support for changes on V2.Core.Event
- Add support for error code account_token_required_for_v2_account on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
#1976 Updated bundled CA certs
#1973 Remove deprecated usage of curl_close() for PHP versions > 8.0

19.0.0

This release changes the pinned API version to 2025-11-17.clover.

#1961 Update generated code
- ⚠️ Remove gt, gte, lt, and lte on V2\Core\Event.all().$params in favor of created.
#1958 Update v2 array parameter serialization to use indexed format
- Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
#1956 Update generated code
- Add support for new resources Tax.Association and Terminal.OnboardingLink
- Add support for find method on resource Tax.Association
- Add support for create method on resource Terminal.OnboardingLink
- Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
- Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
- Add support for new value finom on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
- Add support for new value FNOMNL22 on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
- Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
- Add support for created on CustomerBalanceTransaction.all().$params and InvoicePayment.all().$params
- Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.type
- Add support for account_numbers on FinancialConnections.Account
- Change type of FinancialConnections.Session.client_secret from string to nullable(string)
- Add support for fraud_risk on Issuing\Authorization.create().$params.risk_assessment
- Add support for latest_fraud_warning on Issuing.Card
- Add support for hooks on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, PaymentIntent.update().$params, and PaymentIntent
- Add support for mb_way and twint on Refund.destination_details
- Add support for snapshot events FINANCIAL_CONNECTIONS_ACCOUNT_ACCOUNT_NUMBERS_UPDATED and FINANCIAL_CONNECTIONS_ACCOUNT_UPCOMING_ACCOUNT_NUMBER_EXPIRY with resource FinancialConnections.Account

18.2.0

#1953 Update generated code
- Add support for capture_method on PaymentIntent.confirm().$params.payment_method_option.card_present, PaymentIntent.create().$params.payment_method_option.card_present, PaymentIntent.payment_method_options.card_present, and PaymentIntent.update().$params.payment_method_option.card_present

18.1.0

This release changes the pinned API version to 2025-10-29.clover.

#1946 Update generated code
- Improve docs for PaymentIntent related endpoints
#1942 Update generated code
- Add support for new resources PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecord
- Add support for all and retrieve methods on resource PaymentAttemptRecord
- Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt_informational, report_payment_attempt, report_payment, report_refund, and retrieve methods on resource PaymentRecord
- Add support for all method on resource PaymentIntentAmountDetailsLineItem
- Add support for representative_declaration on Account.company, Account.create().$params.company, Account.update().$params.company, and Token.create().$params.account.company
- Change Billing\CreditGrant.create().$params.category to be optional
- Add support for payment_method_configuration on BillingPortal\Configuration.create().$params.feature.payment_method_update and BillingPortal\Configuration.update().$params.feature.payment_method_update
- Add support for new value solana on enum Charge.payment_method_details.crypto.network
- Add support for twint on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_option
- Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Add support for payment_record_refund and type on CreditNote.create().$params.refund, CreditNote.preview().$params.refund, CreditNote.preview_lines().$params.refund, and CreditNote.refunds[]
- Add support for customer_sheet and mobile_payment_element on CustomerSession.components and CustomerSession.create().$params.component
- Add support for provider on Customer.tax
- Add support for new values balance_settings.updated and invoice.payment_attempt_required on enum Event.type
- Add support for new value platform_terms_of_service on enum File.purpose
- Add support for payment_record on Invoice.attach_payment().$params, InvoicePayment.all().$params.payment, and InvoicePayment.payment
- Change type of InvoicePayment.all().$params.payment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
- Add support for new value custom on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for amount_details on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, and PaymentIntent.update().$params
- Add support for payment_details on PaymentIntent.capture().$params, PaymentIntent.confirm().$params, PaymentIntent.create().$params, PaymentIntent.increment_authorization().$params, PaymentIntent.update().$params, and PaymentIntent
- Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.amount_details
- Add support for name_collection on PaymentLink.create().$params, PaymentLink.update().$params, and PaymentLink
- Add support for new value mb_way on enum PaymentLink.payment_method_types
- Add support for crypto on PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, PaymentMethodConfiguration, and Refund.destination_details
- Add support for mb_way on PaymentMethodConfiguration.create().$params, PaymentMethodConfiguration.update().$params, and PaymentMethodConfiguration
- Add support for custom on PaymentMethod.create().$params and PaymentMethod
- Add support for excluded_payment_method_types on SetupIntent.create().$params, SetupIntent.update().$params, and SetupIntent
- Add support for tw on Tax.Registration.country_options and Tax\Registration.create().$params.country_option
- Add support for gip on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
- Add support for last_seen_at on Terminal.Reader
- Add support for gt, gte, lt, lte, and types on V2\Core\Event.all().$params
- Change V2\Core\Event.all().$params.object_id to be optional
- Add support for snapshot event BALANCE_SETTINGS_UPDATED with resource BalanceSettings
- Add support for snapshot event INVOICE_PAYMENT_ATTEMPT_REQUIRED with resource Invoice
- Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

18.0.0

This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)

#1903 ⚠️ Add strongly typed EventNotifications We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
- Added matching EventNotification classes for every v2 Event. For example, there's now a V1BillingMeterErrorReportTriggeredEventNotification to match the existing V1BillingMeterErrorReportTriggeredEvent. Each of these interfaces defines a fetchEvent() method to retrieve its corresponding event. For events with related objects, there's a fetchRelatedObject() method that performs the API call and casts the response to the correct type.
- ⚠️ Rename function StripeClient->parseThinEvent to StripeClient->parseEventNotification and remove the ThinEvent class.
  - This function now returns a Stripe\V2\Core\EventNotification (which is the shared base class that all of the more specific Stripe\*EventNotifications classes share) instead of ThinEvent. When applicable, these event notifications will have the relatedObject property and a fetchRelatedObject() function. They also have a fetchEvent() method to retrieve their corresponding Stripe\Event\*Event instance.
  - If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of Stripe\Events\UnknownEventNotification instead of a more specific type. It has both the relatedObject property and the FetchRelatedObject() function (but they may be/return null)
- ⚠️ removed the Util::json_decode_thin_event_object. Its functionality was folded into the new \Stripe\V2\EventNotification::fromJson method.
#1925 add version deprecation note to README
- NOTE: we'll be dropping support for PHP 5.6, 7.0, and 7.1 in the next major version (March 2026). The README has been updated with a link to our new language version support policy
#1921 Update generated code
- Change Invoice.id to be required.
#1923 Update generated code
- Remove support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component
#1920 Move V2.Event API resources to V2.Core.Events
- ⚠️ Move all V2 Event-related resources (Event, RelatedObject, etc) from Stripe\V2 to Stripe\V2\Core. They now correctly match their API path and are in line with all other resources. To update your code:
```
-Stripe\V2\Event
+Stripe\V2\Core\Event
```
#1916 Add StripeContext object
- Add the StripeContext class. Previously you could only send a string for stripe-context header.
- ⚠️ Change EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext
#1905 Added StripeContext, StripeAccount and StripeVersion to BaseStripeClientInterface
- ⚠️ Add getter methods getStripeContext, getStripeVersion and getStripeAccount to BaseStripeClientInterface. Users with custom StripeClient that implement StripeClientInterface, StripeStreamingClientInterface or BaseStripeClientInterface will have to add implementations for these methods.
#1898 ⚠️ Build SDK w/ V2 OpenAPI spec
- ⚠️ The delete methods for v2 APIs (the ones in the StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
- the generated types of some properties in EventDestination changed from something: null|string to something?: string
#1900, #1912 Update generated code based on incoming API changes in the 2025-09-30.clover API version.
- ⚠️ Remove support for link and pay_by_bank on PaymentMethod.update().$params
- ⚠️ Remove support for coupon on Discount, PromotionCode.create().$params, and PromotionCode. Use Discount.source.coupon, PromotionCode.create().$params.promotion.code, and PromotionCode.promotion.code instead.
- ⚠️ Remove support for values saturday and sunday from enum Account.settings.payouts.schedule.weekly_payout_days
- ⚠️ Remove support for iterations on Invoice.create_preview().$params.schedule_detail.phase, SubscriptionSchedule.create().$params.phase, and SubscriptionSchedule.update().$params.phase
- Add support for new value prevented on enum Dispute.status
- Add support for new resource BalanceSettings
- Add support for retrieve and update methods on resource BalanceSettings
- Add support for new values external_request and unsupported_business_type on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
- Add support for source on Discount
- Add support for mb_way_payments on Account.capabilities, Account.create().$params.capability, and Account.update().$params.capability
- Add support for trial_update_behavior on BillingPortal.Configuration.features.subscription_update, BillingPortal\Configuration.create().$params.feature.subscription_update, and BillingPortal\Configuration.update().$params.feature.subscription_update
- Add support for mb_way on Charge.payment_method_details, ConfirmationToken.create().$params.payment_method_datum, ConfirmationToken.payment_method_preview, PaymentIntent.confirm().$params.payment_method_datum, PaymentIntent.confirm().$params.payment_method_option, PaymentIntent.create().$params.payment_method_datum, PaymentIntent.create().$params.payment_method_option, PaymentIntent.payment_method_options, PaymentIntent.update().$params.payment_method_datum, PaymentIntent.update().$params.payment_method_option, PaymentMethod.create().$params, PaymentMethod, SetupIntent.confirm().$params.payment_method_datum, SetupIntent.create().$params.payment_method_datum, and SetupIntent.update().$params.payment_method_datum
- Add support for branding_settings and name_collection on Checkout.Session and Checkout\Session.create().$params
- Add support for excluded_payment_method_types on Checkout.Session, Checkout\Session.create().$params, PaymentIntent.confirm().$params, and PaymentIntent.update().$params
- Add support for unit_label on Checkout\Session.create().$params.line_item.price_datum.product_datum, Invoice.add_lines().$params.line.price_datum.product_datum, Invoice.update_lines().$params.line.price_datum.product_datum, InvoiceLineItem.update().$params.price_datum.product_datum, and PaymentLink.create().$params.line_item.price_datum.product_datum
- Add support for alma, billie, and satispay on Checkout.Session.payment_method_options and Checkout\Session.create().$params.payment_method_option
- Add support for demo_pay on Checkout\Session.create().$params.payment_method_option
- Add support for capture_method on Checkout.Session.payment_method_options.affirm, Checkout.Session.payment_method_options.afterpay_clearpay, Checkout.Session.payment_method_options.amazon_pay, Checkout.Session.payment_method_options.card, Checkout.Session.payment_method_options.cashapp, Checkout.Session.payment_method_options.klarna, Checkout.Session.payment_method_options.link, Checkout.Session.payment_method_options.mobilepay, Checkout.Session.payment_method_options.revolut_pay, Checkout\Session.create().$params.payment_method_option.affirm, Checkout\Session.create().$params.payment_method_option.afterpay_clearpay, Checkout\Session.create().$params.payment_method_option.amazon_pay, Checkout\Session.create().$params.payment_method_option.card, Checkout\Session.create().$params.payment_method_option.cashapp, Checkout\Session.create().$params.payment_method_option.klarna, Checkout\Session.create().$params.payment_method_option.link, Checkout\Session.create().$params.payment_method_option.mobilepay, and Checkout\Session.create().$params.payment_method_option.revolut_pay
- Add support for flexible on Checkout\Session.create().$params.subscription_datum.billing_mode, Invoice.create_preview().$params.schedule_detail.billing_mode, Invoice.create_preview().$params.subscription_detail.billing_mode, Quote.create().$params.subscription_datum.billing_mode, Quote.subscription_data.billing_mode, Subscription.billing_mode, Subscription.create().$params.billing_mode, Subscription.migrate().$params.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionSchedule.create().$params.billing_mode
- Add support for business_name and individual_name on Checkout.Session.collected_information, Checkout.Session.customer_details, Customer.create().$params, Customer.update().$params, and Customer
- Add support for new values mb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Add support for chargeback_loss_reason_code on Dispute.payment_method_details.klarna
- Add support for net_amount and proration_details on InvoiceItem
- Add support for fraud_disputability_likelihood and risk_assessment on Issuing\Authorization.create().$params
- Add support for second_line on Issuing.Card
- Add support for new values mb_way on enum PaymentIntent.excluded_payment_method_types
- Add support for fr_meal_voucher_conecs on PaymentMethodConfiguration.create().$params and PaymentMethodConfiguration.update().$params
- Add support for promotion on PromotionCode.create().$params and PromotionCode
- Add support for new values acknowledged and payment_never_settled on enum Review.closed_reason
- Add support for provider on Tax.Settings.defaults
- Add support for bbpos_wisepad3 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
- Add support for address_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.Location, Terminal\Location.create().$params, and Terminal\Location.update().$params
- Change Terminal\Location.create().$params.address to be optional
- Change Terminal\Location.create().$params.display_name to be optional
- Add support for error codes financial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

17.6.0

#1895 Add section on private preview SDKs in readme
#1890 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
- Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component
- Add support for name on BillingPortal.Configuration, BillingPortal\Configuration.create().$params, and BillingPortal\Configuration.update().$params
- Add support for installments on Charge.payment_method_details.alma
- Add support for transaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
- Add support for location and reader on Charge.payment_method_details.paynow
- Add support for amount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout\Session.create().$params.payment_method_option.pix, PaymentIntent.confirm().$params.payment_method_option.pix, PaymentIntent.create().$params.payment_method_option.pix, PaymentIntent.payment_method_options.pix, and PaymentIntent.update().$params.payment_method_option.pix
- Add support for new values block and resolution on enum Dispute.payment_method_details.card.case_type
- Add support for new value terminal_android_apk on enum File.purpose
- Add support for metadata and period on Invoice.create_preview().$params.schedule_detail.phase.add_invoice_item, Subscription.create().$params.add_invoice_item, Subscription.update().$params.add_invoice_item, SubscriptionSchedule.create().$params.phase.add_invoice_item, SubscriptionSchedule.phases[].add_invoice_items[], and SubscriptionSchedule.update().$params.phase.add_invoice_item
- Add support for exp_month and exp_year on Issuing\Card.create().$params
- Add support for excluded_payment_method_types on PaymentIntent.create().$params and PaymentIntent
- Add support for payout_method on Payout.create().$params and Payout
- Add support for mxn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
- Add support for card on Terminal\Reader.present_payment_method().$params
- Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
#1894 Add getter for Stripe Account on BaseStripeClient
- Add getStripeAccount method on BaseStripeClient to retrieve Stripe Account ID from a StripeClient instance.

17.5.0

This release changes the pinned API version to 2025-07-30.basil.

#1887 Update generated code
- Add support for origin_context on Checkout.Session
#1881 Ensure compatibility with POST on older versions of libcurl
- Fixes an issue with older versions of php/libcurl where certain SDK calls that have empty POST bodies will result in a 400 Bad Request returned from the server.

17.4.0

This release changes the pinned API version to 2025-06-30.basil.

#1880 Update generated code
- Add support for migrate method on resource Subscription
- Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
- Add support for new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
- Add support for new value terminal.reader.action_updated on enum Event.type
- Add support for related_person on Identity.VerificationSession
- Add support for new value crypto on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for crypto on PaymentMethod
- Add support for new value buut on enum PaymentMethod.ideal.bank
- Add support for new value BUUTNL2A on enum PaymentMethod.ideal.bic
- Add support for billing_mode on SubscriptionSchedule and Subscription
- Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.type
- Add support for snapshot event TERMINAL_READER_ACTION_UPDATED with resource Terminal.Reader
#1878 Update generated code
- Add constant CURRENT_MAJOR in ApiVersion

17.3.0

This release changes the pinned API version to 2025-05-28.basil.

#1871 Update generated code
- Add support for attach_payment method on resource Invoice
- Add support for collect_inputs method on resource Terminal.Reader
- Add support for succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.Reader
- Add support for refund_and_dispute_prefunding on Balance
- Add support for balance_type on BalanceTransaction
- Add support for post_payment_amount and pre_payment_amount on CreditNote
- Add support for new value mixed on enum CreditNote.type
- Add support for new value invoice_payment.paid on enum Event.type
- Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfiguration
- Add support for billing_thresholds on SubscriptionItem and Subscription
- Add support for metadata on Tax.CalculationLineItem
- Add support for new value collect_inputs on enum Terminal.Reader.action.type
- Add support for new value simulated_stripe_s700 on enum Terminal.Reader.device_type
- Add support for snapshot event INVOICE_PAYMENT_PAID with resource InvoicePayment
- Add support for error code forwarding_api_upstream_error on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

17.2.1

#1869 Fixed type of map parameters(eg. metadata, currency_options) from StripeObject to array<KType, VType> in all methods.
#1866 Adds CONTRIBUTING.md

17.2.0

This release changes the pinned API version to 2025-04-30.basil.

#1839 Update generated code
- Add support for new value tax_id_prohibited on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
- Add support for wallet_options on Checkout.Session
- Add support for context on Event
- Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Invoice.customer_tax_ids[].type and TaxId.type
- Add support for new value affirm on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for pix on PaymentMethodConfiguration
- Add support for klarna on PaymentMethodDomain
- Add support for us_cfpb_data on Person
- Add support for pending_reason on Refund
- Change type of Tax.CalculationLineItem.reference from nullable(string) to string
#1857 Include new PHP 8.3 and 8.4 in CI
#1856 Faster parallel runner for PHP formatter

17.1.1

#1847 Remove stdClass from object shapes
- Remove intersection with stdClass in resource properties and fixed instanceof checks.

17.1.0

#1843 Add null type in resource fields to non required objects
- Fixes nullable resource properties that were incorrectly set as required in PHPDocs

17.0.0

#1837 Better type hints in your editor!!
- Added type hints for method parameters
- Improved type hints for resource properties that are not primitive types. Take for example, the invoice settings in Customer resource. Previously, you could not reference inner fields like custom_fields on customer->invoice_settings without PHPStan complaining. This is now fixed.
#1818 Support for APIs in the new API version 2025-03-31.basil

This release changes the pinned API version to 2025-03-31.basil.

⚠️ Breaking changes due to changes in the Stripe API

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
- Remove support for resources UsageRecordSummary and UsageRecord
- Remove support for create method on resource UsageRecord
- Remove support for all method on resource UsageRecordSummary
- Remove support for upcomingLines and upcoming methods on resource Invoice
- Remove support for invoice on Charge and PaymentIntent
- Remove support for shipping_details on Checkout.Session
- Remove support for refund on CreditNote
- Remove support for tax_amounts on CreditNoteLineItem, CreditNote, and InvoiceLineItem
- Remove support for amount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItem
- Remove support for application_fee_amount, charge, paid_out_of_band, paid, payment_intent, quote, subscription, subscription_details, subscription_proration_date, tax, total_tax_amounts, and transfer_data on Invoice
- Remove support for discount on Invoice and Subscription
- Remove support for invoice_item, proration_details, proration, tax_rates, and type on InvoiceLineItem
- Remove support for plan, price, and subscription_item on InvoiceItem and InvoiceLineItem
- Remove support for subscription, unit_amount_decimal, and unit_amount on InvoiceItem
- Remove support for aggregate_usage on Plan
- Remove support for billing_thresholds on SubscriptionItem and Subscription
- Remove support for current_period_end and current_period_start on Subscription
⚠️ Other Breaking changes in the SDK
- #1826 configure max_nextwork_retries at the client level
  - Allow setting maxNetworkRetries at the StripeClient level via a new argument to the RequestOptions constructor
    - ⚠️ (potentially breaking) a client's configuration for maxNetworkRetries is set during client initialization. Subsequent calls to Stripe::setMaxNetworkRetries() after client creation won't affect that client.
  - Allow setting maxNetworkRetries per-request via the max_network_retries config argument. This works for both the service and resource based patterns. In both cases, an explicitly passed value takes precedence over the global (or client) value.
- #1835 Removed the protected method _searchResource as it is no longer used
  - ⚠️ Removed _searchResource method and Search trait. Use the public search method on Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription resource.
- #1832 Added requestCollection and requestSearchResult to StripeClientInterface
  - ⚠️ Added requestSearchResult, requestCollection to StripeClientInterface. Developers building custom StripeClient will now have to implement these new methods.
    - Refer to our implementation in BaseStripeClient for guidance.
Additions
- Add support for new resource InvoicePayment
- Add support for all and retrieve methods on resource InvoicePayment
- Add support for new values forwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
- Add support for new values stripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.type
- Add support for new value last on enum Billing.Meter.default_aggregation.formula
- Add support for presentment_details on Charge, Checkout.Session, PaymentIntent, and Refund
- Add support for optional_items on Checkout.Session and PaymentLink
- Add support for permissions on Checkout.Session
- Add support for new value custom on enum Checkout.Session.ui_mode
- Add support for new values billie, nz_bank_account, and satispay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
- Add support for refunds on CreditNote
- Add support for total_taxes on CreditNote and Invoice
- Add support for taxes on CreditNoteLineItem and InvoiceLineItem
- Add support for checkout_session on CustomerBalanceTransaction
- Add support for new values checkout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.type
- Add support for new value invoice.overpaid on enum Event.type
- Add support for amount_overpaid, confirmation_secret, and payments on Invoice
- Add support for parent on InvoiceItem, InvoiceLineItem, and Invoice
- Add support for new values klarna and nz_bank_account on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
- Add support for pricing on InvoiceItem and InvoiceLineItem
- Add support for new value network_fallback on enum Issuing.Authorization.request_history[].reason
- Add support for new value expired on enum Issuing.Authorization.status
- Add support for new value expired on enum PaymentIntent.cancellation_reason
- Add support for new values billie and satispay on enum PaymentLink.payment_method_types
- Add support for billie, nz_bank_account, and satispay on PaymentMethodConfiguration and PaymentMethod
- Add support for new value canceled on enum Review.closed_reason
- Add support for current_period_end and current_period_start on SubscriptionItem
- Add support for wifi on Terminal.Configuration

16.6.0

#1809 Update generated code
- Add support for priority on Billing.CreditGrant
- Add support for collected_information on Checkout.Session
#1816 add codeowners file

16.5.1

#1811 Include a useful error message when a null byte is found in the URL path
#1810 Make httpClient() a public, static method

16.5.0

#1804 Update generated code
- Add support for close method on resource Treasury.FinancialAccount
- Add support for discounts on Checkout.Session
- Add support for new value pay_by_bank on enum PaymentLink.payment_method_types[]
- Add support for pay_by_bank on PaymentMethodConfiguration and PaymentMethod
- Add support for new value pay_by_bank on enum PaymentMethod.type
- Add support for is_default and nickname on Treasury.FinancialAccount
#1805 Restore testCoreEventsGet generated test
#1807 minor justfile fixes
#1806 Added CONTRIBUTING.md file
#1802 ensure dependencies are installed for format and test recipes
#1801 Add justfile, remove coveralls, and fix AUTOLOAD in CI
#1797 Added pull request template

16.4.0

#1793 This release changes the pinned API version to 2024-12-18.acacia.
- Add support for new values payout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.type
- Add support for allow_redisplay on Card and Source
- Add support for regulated_status on Card
- Add support for new value request_signature on enum Forwarding.Request.replacements[]
- Change type of LineItem.description from string to nullable(string)
- Add support for new values al_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enum TaxId.type

16.3.0

#1786 This release changes the pinned API version to 2024-11-20.acacia.
- Add support for respond test helper method on resource Issuing.Authorization
- Add support for adaptive_pricing on Checkout.Session
- Add support for new value subscribe on enums Checkout.Session.submit_type and PaymentLink.submit_type
- Add support for new value financial_account_statement on enum File.purpose
- Add support for fraud_challenges and verified_by_fraud_challenge on Issuing.Authorization
- Add support for trace_id on Payout
- Add support for new value li_vat on enum TaxId.type
- Add support for new value service_tax on enum TaxRate.tax_type
- Change type of Treasury.InboundTransfer.origin_payment_method from string to nullable(string)

16.2.0

#1772 This release changes the pinned API version to 2024-10-28.acacia.
- Add support for new resource V2.EventDestinations
- Add support for create, retrieve, update, list, delete, disable, enable and ping methods on resource V2.EventDestinations
- Add support for submit_card test helper method on resource Issuing.Card
- Add support for groups on Account
- Add support for enhanced_eligibility_types on Dispute
- Add support for new values issuing_transaction.purchase_details_receipt_updated and refund.failed on enum Event.type
- Add support for metadata on Forwarding.Request
- Add support for new value alma on enum PaymentLink.payment_method_types[]
- Add support for alma on PaymentMethodConfiguration and PaymentMethod
- Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethod
- Add support for new values alma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enum PaymentMethod.type
- Add support for amazon_pay on PaymentMethodDomain
- Add support for new values by_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enum TaxId.type
- Add support for flat_amount and rate_type on TaxRate
- Add support for new value retail_delivery_fee on enum TaxRate.tax_type

16.1.1

#1775 Deserialize into correct v2 EventData types
- Fixes a bug where v2 EventData was not being deserialized into the appropriate type for V1BillingMeterErrorReportTriggeredEvent and V1BillingMeterNoMeterFoundEvent
#1776 update object tags for meter-related classes
- fixes a bug where the object property of the MeterEvent, MeterEventAdjustment, and MeterEventSession didn't match the server.
#1773 Clean up examples
#1771 Renamed example file names

16.1.0

#1765 Update generated code
- Remove the support for resource Margin that was accidentally made public in the last release

16.0.0

#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.

⚠️ Breaking changes
- Rename usage_threshold_config to usage_threshold on Billing.Alert
- Remove support for filter on Billing.Alert. Use the filters on the usage_threshold instead
Additions
- Add support for new value international_transaction on enum Treasury.ReceivedCredit.failure_code
- Add support for new Usage Billing APIs Billing.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events under the v2 namespace
- Add new method parseThinEvent() on the StripeClient class to parse thin events.
- Add a new method rawRequest() on the 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.

15.10.0

#1747 Update generated code
- Add support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code
#1745 Update generated code
- Add support for new value terminal_reader_invalid_location_for_activation on enum StripeError.code
- Add support for automatically_finalizes_at on Invoice

15.9.0

#1737 Update generated code
- Add support for new resource InvoiceRenderingTemplate
- Add support for all, archive, retrieve, and unarchive methods on resource InvoiceRenderingTemplate

15.8.0

#1742 Generate SDK for OpenAPI spec version 1230
- Add support for new value issuing_regulatory_reporting on enum File.purpose
- Add support for new value hr_oib on enum TaxId.type
- Add support for status_details on TestHelpers.TestClock

15.7.0

#1736 Update generated code

15.6.0

#1729 Update generated code
- Add support for activate, all, archive, create, deactivate, and retrieve methods on resource Billing.Alert
- Add support for retrieve method on resource Tax.Calculation
- Add support for new value invalid_mandate_reference_prefix_format on enum StripeError.code
- Add support for related_customer on Identity.VerificationSession
- Add support for new value financial_addresses.aba.forwarding on enums Treasury.FinancialAccount.active_features[], Treasury.FinancialAccount.pending_features[], and Treasury.FinancialAccount.restricted_features[]

15.5.0

#1727 Update generated code
- Add support for new resources Billing.AlertTriggered and Billing.Alert
- Add support for new value charge_exceeds_transaction_limit on enum StripeError.code
- Add support for new value billing.alert.triggered on enum Event.type

15.4.0

#1726 Update generated code
- Add support for update method on resource Checkout.Session
- Add support for new values invoice.overdue and invoice.will_be_due on enum Event.type
- Add support for twint on PaymentMethodConfiguration

15.3.0

#1724 Update generated code
- Add support for new value issuing_dispute.funds_rescinded on enum Event.type
- Add support for new value stripe_s700 on enum Terminal.Reader.device_type
#1722 Update changelog

15.2.0

#1721 Update generated code
- ⚠️ Remove support for values 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.
- ⚠️ Remove support for value payment_intent_fx_quote_invalid from enum StripeError.code. The was mistakenly released last week.
- Add support for payment_method_options on ConfirmationToken

15.1.0

#1718 Update generated code
- Add support for add_lines, remove_lines, and update_lines methods on resource Invoice
- Add support for new value payment_intent_fx_quote_invalid on enum StripeError.code
- Add support for new values multibanco, twint, and zip on enum PaymentLink.payment_method_types[]
- Add support for posted_at on Tax.Transaction
- Add support for reboot_window on Terminal.Configuration

15.0.0

#1714

This release changes the pinned API version to 2024-06-20. Please read the API Changelog and carefully review the API changes before upgrading.

⚠️ Breaking changes
- Remove the unused resource PlatformTaxFee
- Remove the protected method _searchResource on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription as it is no longer used.
Additions
- Add support for finalize_amount test helper method on resource Issuing.Authorization
- Add support for fleet and fuel on Issuing.Authorization
- Add support for new value ch_uid on enum TaxId.type

14.10.0

#1706 Update generated code
- Add support for multibanco on PaymentMethodConfiguration and PaymentMethod
- Add support for twint on PaymentMethod
- Add support for new values multibanco and twint on enum PaymentMethod.type
- Add support for invoice_settings on Subscription
- Add support for new value de_stn on enum TaxId.type

14.9.0

#1702 Update generated code
- Add support for new values issuing_personalization_design.activated, issuing_personalization_design.deactivated, issuing_personalization_design.rejected, and issuing_personalization_design.updated on enum Event.type
#1701 Added PHPDocs for create, update, delete, all, retrieve methods after moving them out of traits.
#1700 Add optional appInfo to StripeClient config
- 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().
  - The config expects $appInfo to be of type array{name: string, version?: string, url?: string, partner_id?: string}

14.8.0

#1698 Update generated code
- Add support for new value terminal_reader_invalid_location_for_payment on enum StripeError.code
#1697 Rename section for object type generation

14.7.0

#1694 Update generated code
- Add support for fee_source on ApplicationFee
- Add support for loss_reason on Issuing.Dispute
- Add support for application_fee_amount and application_fee on Payout
- Add support for stripe_s700 on Terminal.Configuration

14.6.0

#1692 Update generated code
- Add support for update test helper method on resources Treasury.OutboundPayment and Treasury.OutboundTransfer
- Add support for new values treasury.outbound_payment.tracking_details_updated and treasury.outbound_transfer.tracking_details_updated on enum Event.type
- Add support for allow_redisplay on PaymentMethod
- Add support for tracking_details on Treasury.OutboundPayment and Treasury.OutboundTransfer

14.5.0

#1688 Update generated code
- Add support for new value shipping_address_invalid on enum StripeError.code
- Add support for ship_from_details on Tax.Calculation and Tax.Transaction

14.4.0

#1684 Update generated code
- Change type of Entitlements.ActiveEntitlement.feature from string to expandable($Entitlements.Feature)
- Add support for mobilepay on PaymentMethodConfiguration

14.3.0

#1681 Update generated code
- Add support for create_preview method on resource Invoice
- Add support for saved_payment_method_options on Checkout.Session
#1682 Added @throws to autoPagingIterator. Fixes #1678

14.2.0

#1680 Update generated code
- Add support for new resource Entitlements.ActiveEntitlementSummary
- Add support for new value entitlements.active_entitlement_summary.updated on enum Event.type
- Remove support for config on Forwarding.Request. This field is no longer used by the Forwarding Request API.
- Add support for swish on PaymentMethodConfiguration

14.1.0

#1677 Update generated code
- Add support for new values 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.code
- Change type of Billing.MeterEventAdjustment.cancel from BillingMeterResourceBillingMeterEventAdjustmentCancel to nullable(BillingMeterResourceBillingMeterEventAdjustmentCancel)
- Add support for amazon_pay on PaymentMethodConfiguration and PaymentMethod
- Add support for new value amazon_pay on enum PaymentMethod.type
- Add support for new values bh_vat, kz_bin, ng_tin, and om_vat on enum TaxId.type

14.0.0

#1673
- This release changes the pinned API version to 2024-04-10. Please read the API Changelog and carefully review the API changes before upgrading.
⚠️ Breaking changes
- Rename features to marketing_features on Product
- Do not force resolution to IPv4 - Forcing IPv4 was causing hard-to-understand failures for users in IPv6-only environments. If you want to force IPv4 yourself, you can do so by telling the API client to use a CurlClient other than the default
```
$curl = new \Stripe\HttpClient\CurlClient([
  CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4
]);
\Stripe\ApiRequestor::setHttpClient($curl);
```
⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API
- Remove the below deprecated values on the enum BalanceTransaction.Type
  - obligation_inbound
  - obligation_payout
  - obligation_payout_failure
  - obligation_reversal_outbound
- Remove the deprecated value various on the enum Climate.Supplier.RemovalPathway
- Remove deprecated events
  - invoiceitem.updated
  - order.created
  - recipient.created
  - recipient.deleted
  - recipient.updated
  - sku.created
  - sku.deleted
  - sku.updated
- Remove the deprecated value service_tax on the enum TaxRate.TaxType
- Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration
- Remove the legacy field rendering_options in Invoice. Use rendering instead.

13.18.0

#1675 Update generated code
- Add support for new resources Entitlements.ActiveEntitlement and Entitlements.Feature
- Add support for all and retrieve methods on resource ActiveEntitlement
- Add support for all, create, retrieve, and update methods on resource Feature
- Add support for new value none on enum Account.type
- Add support for cancel, event_name, and type on Billing.MeterEventAdjustment

13.17.0

#1670 Update generated code
- Add support for subscription_item on Discount
- Add support for email and phone on Identity.VerificationReport
- Add support for verification_flow on Identity.VerificationReport and Identity.VerificationSession
- Add support for new value verification_flow on enums Identity.VerificationReport.type and Identity.VerificationSession.type
- Add support for provided_details on Identity.VerificationSession
- Change type of Invoice.discounts from nullable(array(expandable(deletable($Discount)))) to array(expandable(deletable($Discount)))
- Add support for zip on PaymentMethodConfiguration
- Add support for discounts on SubscriptionItem and Subscription
- Add support for new value mobile_phone_reader on enum Terminal.Reader.device_type

13.16.0

#1666 Update generated code
- Add support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
- Add support for all, create, deactivate, reactivate, retrieve, and update methods on resource Meter
- Add support for create method on resources MeterEventAdjustment and MeterEvent
- Add support for meter on Plan

13.15.0

#1664 Update generated code
- Add support for new resources ConfirmationToken and Forwarding.Request
- Add support for retrieve method on resource ConfirmationToken
- Add support for all, create, and retrieve methods on resource Request
- Add support for new values forwarding_api_inactive, forwarding_api_invalid_parameter, forwarding_api_upstream_connection_error, and forwarding_api_upstream_connection_timeout on enum StripeError.code
- Add support for mobilepay on PaymentMethod
- Add support for new value mobilepay on enum PaymentMethod.type
- Add support for name on Terminal.Configuration

13.14.0

#1660 Update generated code
- Add support for new resources Issuing.PersonalizationDesign and Issuing.PhysicalBundle
- Add support for all, create, retrieve, and update methods on resource PersonalizationDesign
- Add support for all and retrieve methods on resource PhysicalBundle
- Add support for personalization_design on Issuing.Card

13.13.0

#1654 Update generated code
- Change type of Identity.VerificationSession.type from nullable(enum('document'|'id_number')) to enum('document'|'id_number')
- Add resources Application, ConnectCollectionTransfer, PlatformTaxFee, ReserveTransaction, SourceMandateNotification, and TaxDeductedAtSource. These classes have no methods on them, and are used to provide more complete types for PHPDocs.
#1657 Update readme to use addBetaVersion

13.12.0

#1651 Update generated code
- Add support for client_reference_id on Identity.VerificationReport and Identity.VerificationSession
- Remove support for value service_tax from enum TaxRate.tax_type
#1650 Add TaxIds API
- Add support for all, create, delete, and retrieve methods on resource TaxId
- The instanceUrl function on TaxId now returns the top-level /v1/tax_ids/{id} path instead of the /v1/customers/{customer}/tax_ids/{id} path.

13.11.0

#1639 Update generated code
- Add support for networks on Card
- Add support for new value financial_connections.account.refreshed_ownership on enum Event.type
#1648 Remove broken methods on CustomerCashBalanceTransaction
- Bugfix: remove support for CustomerCashBalanceTransaction::all and CustomerCashBalanceTransaction::retrieve. These methods were included in the library unintentionally and never functioned.
#1647 Fix \Stripe\Tax\Settings::update
#1646 Add more specific PHPDoc and Psalm type for RequestOptions arrays on services

13.10.0

#1636 Update generated code
- Add support for new value swish on enum PaymentLink.payment_method_types[]
- Add support for swish on PaymentMethod
- Add support for new value swish on enum PaymentMethod.type
- Add support for jurisdiction_level on TaxRate
- Change type of Terminal.Reader.status from string to enum('offline'|'online')
#1633 Update generated code
- Add support for issuer on Invoice
- Add support for customer_balance on PaymentMethodConfiguration
#1630 Add paginated requests helper function and use in Search and All

13.9.0

#1629 Update generated code
- Add support for new resource CustomerSession
- Add support for create method on resource CustomerSession
- Remove support for values obligation_inbound, obligation_payout_failure, obligation_payout, and obligation_reversal_outbound from enum BalanceTransaction.type
- Add support for billing_cycle_anchor_config on Subscription

13.8.0

#1627 Update generated code
- Add support for retrieve method on resource Tax.Registration

13.7.0

#1621 Update generated code
- Add support for new resource FinancialConnections.Transaction
- Add support for all and retrieve methods on resource Transaction
- Add support for subscribe and unsubscribe methods on resource FinancialConnections.Account
- Add support for new value financial_connections.account.refreshed_transactions on enum Event.type
- Add support for subscriptions and transaction_refresh on FinancialConnections.Account
- Add support for new value transactions on enum FinancialConnections.Session.prefetch[]
- Add support for revolut_pay on PaymentMethodConfiguration
- Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration
- Change type of Quote.invoice_settings from nullable(InvoiceSettingQuoteSetting) to InvoiceSettingQuoteSetting
- Add support for destination_details on Refund

13.6.0

#1613 Update generated code
- Add support for new values customer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enum StripeError.code
- Add support for new values payment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.type
- Remove support for value various from enum Climate.Supplier.removal_pathway
- Add support for inactive_message and restrictions on PaymentLink
#1612 Report usage of .save and StripeClient
- Reports uses of the deprecated .save and of StripeClient in X-Stripe-Client-Telemetry. (You can disable telemetry via \Stripe\Stripe::setEnableTelemetry(false);, see the README.)

13.5.0

#1611 Update generated code
- Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
- Add support for all, cancel, create, retrieve, and update methods on resource Order
- Add support for all and retrieve methods on resources Product and Supplier
- Add support for new value financial_connections_account_inactive on enum StripeError.code
- Add support for new values climate_order_purchase and climate_order_refund on enum BalanceTransaction.type
- Add support for new values climate.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.type

13.4.0

#1608 Update generated code Add support for transferred_to_balance to CustomerCashBalanceTransaction
#1605 Update generated code
- Add support for network_data on Issuing.Transaction

13.3.0

#1603 Update generated code
- Add support for new value terminal_reader_hardware_fault on enum StripeError.code

13.2.1

#1602 Fix error when "id" is not a string.

13.2.0

#1599 Update generated code
- Add support for new resource Tax.Registration
- Add support for all, create, and update methods on resource Registration
- Add support for new value token_card_network_invalid on enum StripeError.code
- Add support for new value payment_unreconciled on enum BalanceTransaction.type
- Add support for revolut_pay on PaymentMethod
- Add support for new value revolut_pay on enum PaymentMethod.type

13.1.0

#1595 Update generated code
- Add support for new value balance_invalid_parameter on enum StripeError.code

13.0.0

This release changes the pinned API version to 2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-php package.
#1593 Update generated code
- Added additional_tos_acceptances field on Person

12.8.0

#1590 Update generated code
- Add support for new values issuing_token.created and issuing_token.updated on enum Event.type

12.7.0

#1589 Update generated code
- Add support for client_secret, redirect_on_completion, return_url, and ui_mode on Checkout.Session
- Add support for offline on Terminal.Configuration

12.6.0

#1586 Update generated code
- Add support for new resource Issuing.Token
- Add support for all, retrieve, and update methods on resource Token
- Add support for token on Issuing.Authorization and Issuing.Transaction
#1569 Fix: Do not bother removing friendsofphp/php-cs-fixer

12.5.0

#1582 Generate Discount, SourceTransaction and use sections in more places
#1584 Update generated code
- Add support for rendering on Invoice

12.4.0

#1579 Update generated code
- Add back constant for invoiceitem.updated webhook event. This was mistakenly removed in v12.2.0.
#1566 Fix: Remove squizlabs/php_codesniffer
#1568 Enhancement: Reference phpunit.xsd as installed with composer
#1565 Enhancement: Use PHP 8.2 as leading PHP version

12.3.0

#1577 Update generated code
- Add support for new resource PaymentMethodConfiguration
- Add support for all, create, retrieve, and update methods on resource PaymentMethodConfiguration
- Add support for payment_method_configuration_details on Checkout.Session, PaymentIntent, and SetupIntent
#1573 Update generated code
- Add support for capture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorization
- Add support for create_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.Transaction
- Add support for new value stripe_tax_inactive on enum StripeError.code

12.2.0

#1571 Update generated code
- Add support for new resource PaymentMethodDomain
- Add support for all, create, retrieve, update, and validate methods on resource PaymentMethodDomain
- Add support for new values treasury.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.type
- Remove support for value invoiceitem.updated from enum Event.type
- Add support for features on Product

12.1.0

#1560 Update generated code
- Add support for new resource AccountSession
- Add support for create method on resource AccountSession
- Add support for new values obligation_inbound, obligation_outbound, obligation_payout_failure, obligation_payout, obligation_reversal_inbound, and obligation_reversal_outbound on enum BalanceTransaction.type
- Change type of Event.type from string to enum
- Add support for application on PaymentLink
#1562 Nicer ApiErrorException::__toString()
#1558 Update generated code
- Add support for payment_method_details on Dispute
- Add support for prefetch on FinancialConnections.Session

12.0.0

⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️

Version pinning

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.

Other changes

" ⚠️" symbol highlights breaking changes.

#1553⚠️ Remove deprecated enum value Invoice.STATUS_DELETE
#1550 PHPDoc changes
- Remove support for alternate_statement_descriptors, destination, and dispute on Charge
- Remove support for value charge_refunded from enum Dispute.status
- Remove support for rendering on Invoice
- Remove support for attributes, caption, and deactivate_on on Product

11.0.0

Please do not use stripe-php v11. It did not correctly apply the pinning behavior and was removed from packagist

10.21.0

#1546 Update generated code
- Add support for new value payment_reversal on enum BalanceTransaction.type
- Add support for new value adjusted_for_overdraft on enum CustomerBalanceTransaction.type

10.20.0

#1539 Update generated code
- Add support for subscription_details on Invoice
- Add support for new values sepa_debit_fingerprint and us_bank_account_fingerprint on enum Radar.ValueList.item_type

10.19.0

#1534 Update generated code
- Improve PHPDoc type for ApplicationFee.refunds
- Add support for deleted on Apps.Secret
#1526 Add constants for payment intent cancellation reasons
#1533 Update generated code
- Add support for new value service_tax on enum TaxRate.tax_type
#1487 PHPDoc: use union of literals for $method parameter throughout

10.18.0

#1533 Update generated code
- Add support for new value service_tax on enum TaxRate.tax_type
#1526 Add constants for payment intent cancellation reasons
#1487 PHPDoc: use union of literals for $method parameter throughout

10.17.0

#1525 Update generated code
- Add support for new resource Tax.Settings
- Add support for retrieve and update methods on resource Settings
- Add support for new value invalid_tax_location on enum StripeError.code
- Add support for product on Tax.TransactionLineItem
- Add constant for tax.settings.updated webhook event
#1520 Update generated code
- Release specs are identical.

10.16.0

#1517 Update generated code
- Add support for new value application_fees_not_allowed on enum StripeError.code
- Add support for effective_at on CreditNote and Invoice
- Add support for on_behalf_of on Mandate
#1514 Update generated code
- Release specs are identical.
#1512 Update generated code
- Change type of Checkout.Session.success_url from string to nullable(string)

10.15.0

#1506 Update generated code
- Add support for preferred_locales on Issuing.Cardholder

10.14.0

#1503 Update generated code
- Add support for zip on PaymentMethod
- Add support for new value zip on enum PaymentMethod.type
#1502 Generate error codes
#1501 Update generated code
#1499 Update generated code
- Add support for new values amusement_tax and communications_tax on enum TaxRate.tax_type

10.13.0

#1490 Update generated code
- Add support for paypal on PaymentMethod
- Add support for effective_percentage on TaxRate
#1488 Increment PHPStan to strictness level 2
#1483 Update generated code
#1480 Update generated code
- Change type of Identity.VerificationSession.options from VerificationSessionOptions to nullable(VerificationSessionOptions)
- Change type of Identity.VerificationSession.type from enum('document'|'id_number') to nullable(enum('document'|'id_number'))
#1478 Update generated code
- Release specs are identical.
#1475 Update generated code

10.12.1

#1473 Update generated code
- Add back deleted from Invoice.status.

10.12.0

#1470 Update generated code
- Remove support for create method on resource Tax.Transaction
  - This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the createFromCalculation method.
- Remove support for value deleted from enum Invoice.status
  - This is not a breaking change, as the value was never returned or accepted as input.
#1468 Trigger workflow for tags
#1467 Update generated code (new)
- Release specs are identical.

10.11.0

#1458 Update generated code
- Add support for new resources Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transaction
- Add support for create and list_line_items methods on resource Calculation
- Add support for create_from_calculation, create_reversal, create, list_line_items, and retrieve methods on resource Transaction
- Add support for currency_conversion on Checkout.Session
- Add support for new value automatic_async on enum PaymentIntent.capture_method
- Add support for new value link on enum PaymentLink.payment_method_types[]
- Add support for automatic_payment_methods on SetupIntent

10.10.0

#1457 API Updates
- Add support for future_requirements and requirements on BankAccount
- Add support for new value automatic_async on enum PaymentIntent.capture_method
- Add support for new value cashapp on enum PaymentLink.payment_method_types[]
- Add support for cashapp on PaymentMethod
- Add support for new value cashapp on enum PaymentMethod.type
#1454 Update generated code (new)
- Add support for new value cashapp on enum PaymentLink.payment_method_types[]
- Add support for cashapp on PaymentMethod
- Add support for new value cashapp on enum PaymentMethod.type

10.9.1

#1453 Restore StripeClient.getService

10.9.0

#1450 API Updates
- Add support for cancellation_details on Subscription
- Fix return types on custom methods (extends https://github.com/stripe/stripe-php/pull/1446)
#1446 stripe->customers->retrievePaymentMethod returns the wrong class (type hint)

10.8.0

#1447 API Updates
- Add support for reconciliation_status on Payout
- Add support for new value lease_tax on enum TaxRate.tax_type

10.7.0

#1444 API Updates
- Add support for new value igst on enum TaxRate.tax_type

10.6.1

#1443 Remove init.php from the list of ignored files

10.6.0

#1441 API Updates
- Add support for refund_payment method on resource Terminal.Reader
- Add support for custom_fields on Checkout.Session and PaymentLink
#1236 subscription_proration_date not always presented in Invoice
#1431 Fix: Do not use unbounded version constraint for actions/checkout
#1436 Enhancement: Enable and configure visibility_required fixer
#1432 Enhancement: Update actions/cache
#1434 Fix: Remove parentheses
#1433 Enhancement: Run tests on PHP 8.2
#1438 Update .gitattributes

10.5.0

#1439 API Updates
- Add support for resume method on resource Subscription
- Add support for amount_shipping and shipping_cost on CreditNote and Invoice
- Add support for shipping_details on Invoice
- Add support for invoice_creation on PaymentLink
- Add support for trial_settings on Subscription
- Add support for new value paused on enum Subscription.status

10.4.0

#1381 Add getService methods to StripeClient and AbstractServiceFactory to allow mocking
#1424 API Updates
- Added 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

10.3.0

#1413 API Updates Change CheckoutSession.cancel_url to be nullable.

10.2.0

#1411 API Updates
- Add support for new value invoice_overpaid on enum CustomerBalanceTransaction.type
#1407 API Updates

10.1.0

#1405 API Updates
- Add support for flow on BillingPortal.Session
#1404 API Updates
- Remove support for resources Order and Sku
- Remove support for all, cancel, create, list_line_items, reopen, retrieve, submit, and update methods on resource Order
- Remove support for all, create, delete, retrieve, and update methods on resource Sku
- Add support for custom_text on Checkout.Session and PaymentLink
- Add support for invoice_creation and invoice on Checkout.Session
- Remove support for product on LineItem
- Add support for latest_charge on PaymentIntent
- Remove support for charges on PaymentIntent

10.0.0

#1392 Next major release changes

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.

Deprecated

#1382 Mark 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'],
]);

⚠️ Removed

#1377 Removed deprecated Sku resource and service
#1375 Removed deprecated Orders resource and service
#1375 Removed deprecated Product field from the LineItem
#1388 Removed deprecated AlipayAccount resource
#1396 Removed charges field on PaymentIntent and replace it with latest_charge.

9.9.0

#1394 API Updates
- Add support for new values eg_tin, ph_tin, and tr_tin on enum TaxId.type
#1389 API Updates
- Add support for on_behalf_of on Subscription
#1379 Do not run Coveralls in PR-s

9.8.0

#1383 API Updates
- Add support for new values jp_trn and ke_pin on enum TaxId.type
#1293 Install deps in the install step of CI
#1291 Fix: Configure finder for friendsofphp/php-cs-fixer

9.7.0

#1376 API Updates
- Add support for network_data on Issuing.Authorization
#1374 Add request_log_url on ErrorObject
#1370 API Updates
- Add support for created on Checkout.Session

9.6.0

#1365 API Updates
- Add support for from_invoice and latest_revision on Invoice
- Add support for new value pix on enum PaymentLink.payment_method_types[]
- Add support for pix on PaymentMethod
- Add support for new value pix on enum PaymentMethod.type
- Add support for created on Treasury.CreditReversal and Treasury.DebitReversal

9.5.0

#1364 API Updates
- Add support for new value terminal_reader_splashscreen on enum File.purpose
#1363 chore: Update PHP tests to handle search methods.

9.4.0

#1362 API Updates
- Add support for login_page on BillingPortal.Configuration
#1360 Add test coverage using Coveralls
#1361 fix: Fix type hints for error objects.
- Update Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error and SetupIntent.setup_error type to be StripeObject.
  - Addresses https://github.com/stripe/stripe-php/issues/1353. The library today does not actually return a ErrorObject for these fields, so the type annotation was incorrect.
#1356 Add beta readme.md section

9.3.0

#1355 API Updates
- Change type of Treasury.OutboundTransfer.destination_payment_method from string to string | null
- Change the return type of CustomerService.fundCashBalance test helper from CustomerBalanceTransaction to CustomerCashBalanceTransaction.
  - 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 minor as it is solely a test helper method. This was essentially broken prior to this change.

9.2.0

#1352 API Updates
- Add support for new resource CustomerCashBalanceTransaction
- Add support for currency on PaymentLink
- Add constant for customer_cash_balance_transaction.created webhook event.
#1351 Add a support section to the readme
#1304 Allow passing PSR-3 loggers to setLogger as they are compatible

9.1.0

#1348 API Updates
- Add support for payment_method_collection on Checkout.Session and PaymentLink
#1346 API Updates
- Add support for expires_at on Apps.Secret

9.0.0

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.

#1344 API Updates
#1337 API Updates
#1273 Add some PHPDoc return types and fixes
#1341 Next major release changes

Added

Add alternate_statement_descriptors, authorization_code, and level3 properties to Charge resource.
Add previewLines method to CreditNote resource.
Add transfer_data property to Subscription resource.
Add SOURCE_TYPE_FPX constant to Transfer resource.
Add new error code constants to ErrorObject.
Add support for shipping_cost and shipping_details on Checkout.Session

⚠️ Changed

Updated certificate bundle (#1314)
Add params parameter to close method in Dispute resource.

⚠️ Removed

Remove deprecated AlipayAccount, BitcoinReceiver, BitcoinTransaction, Recipient, RecipientTransfer, and ThreeDSecure resources.
Remove 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.
Remove AssociatedObjects array property from EphemeralKey resource. The field was undocumented and unsupported.
Remove details method from Card resource. The endpoint was deprecated and no longer exists.
Remove recipient property from Card resource. The property was deprecated.
Remove ability to list Card resources for a particular Recipient.
Remove sources property from Card resource. The property was deprecated.
Remove FAILURE_REASON constant from Refund resource. The value was deprecated.
Remove Recipient resource. The resource was deprecated.
Remove OrderItem resource. The resource was deprecated.
Remove all method from LineItem.
Remove cancel method from Transfer and TransferService. This method is deprecated.
Remove allTransactions method from SourceService service. Please use allSourceTransactions method instead.
Remove persons method from Account resource. Please use allPersons method instead.
Remove sourceTransactions method from Source resource. Please use allSourceTransactions method instead.
Remove usageRecordSummaries method from SubscriptionItem resource. Please use allUsageRecordSummaries method instead.
Remove SOURCE_TYPE_ALIPAY_ACCOUNT and SOURCE_TYPE_FINANCING constants from Transfer resource. The values were deprecated and are no longer in use.
Remove deprecated error code constants from 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.
Remove deprecated event constants from 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.

8.12.0

#1332 API Updates
- Add support for default_currency and invoice_credit_balance on Customer

8.11.0

#1324 API Updates
- Add support for new value blik on enum PaymentLink.payment_method_types[]
- Add support for blik on PaymentMethod
- Add support for new value blik on enum PaymentMethod.type
- Add Invoice.upcomingLines method.
- Add SourceService.allSourceTransactions method.
#1322 API Updates
- Change type of source_type on Transfer from nullable string to string (comment-only change)

8.10.0

#1319 API Updates
- Add support for currency_options on Coupon and Price
- Add support for currency on Subscription
#1318 API Updates
- Add support for new values financial_connections.account.created, financial_connections.account.deactivated, financial_connections.account.disconnected, financial_connections.account.reactivated, and financial_connections.account.refreshed_balance on Event.

8.9.0

#1316 API Updates
- Add support for deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Card
- Add support for subtotal_excluding_tax on CreditNote and Invoice
- Add support for amount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItem
- Add support for total_excluding_tax on Invoice
- Change type of PaymentLink.payment_method_types[] from literal('card') to enum
- Add support for promptpay on PaymentMethod
- Add support for new value promptpay on enum PaymentMethod.type
- Add support for hosted_regulatory_receipt_url and reversal_details on Treasury.ReceivedCredit and Treasury.ReceivedDebit

8.8.0

#1302 API Updates
- Add support for custom_unit_amount on Price
#1301 API Updates

Documentation updates.

8.7.0

#1306 API Updates
- Add support for fund_cash_balance test helper method on resource Customer
- Add support for total_excluding_tax on CreditNote
- Add support for rendering_options on Invoice
#1307 Support updating pre-release versions
#1305 Trigger workflows on beta branches
#1302 API Updates
- Add support for custom_unit_amount on Price
#1301 API Updates

Documentation updates.

8.6.0

#1300 API Updates
- Add support for attach_to_self and flow_directions on SetupAttempt

8.5.0

#1298 API Updates
- Add support for radar_options on Charge and PaymentMethod
- Add support for new value simulated_wisepos_e on enum Terminal.Reader.device_type

8.4.0

#1296 API Updates
- Add support for persons method on resource Account
- Add support for balance_transactions method on resource Customer
- Add support for id_number_secondary_provided on Person
#1295 API Updates

8.3.0

#1294 API Updates
- Add support for new resource Apps.Secret
- Add support for affirm and link on PaymentMethod
- Add support for new values affirm and link on enum PaymentMethod.type
#1289 fix: Update RequestOptions#redactedApiKey to stop exploding null.

8.2.0

#1286 API Updates
- Add support for new resources Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.FlowDetails, Treasury.InboundTransfer, Treasury.OutboundPayment, Treasury.OutboundTransfer, Treasury.ReceivedCredit, Treasury.ReceivedDebit, Treasury.TransactionEntry, and Treasury.Transaction
- Add support for retrieve_payment_method method on resource Customer
- Add support for all and list_owners methods on resource FinancialConnections.Account
- Add support for treasury on Issuing.Authorization, Issuing.Dispute, and Issuing.Transaction
- Add support for financial_account on Issuing.Card
- Add support for client_secret on Order
- Add support for attach_to_self and flow_directions on SetupIntent

8.1.0

#1284 API Updates
- Add support for consent_collection, customer_creation, payment_intent_data, shipping_options, submit_type, and tax_id_collection on PaymentLink
- Add support for description on Subscription

8.0.0

#1283 Major version release of v8.0.0. The migration guide contains more information. (⚠️ = breaking changes):
- ⚠️ Replace the legacy Order API with the new Order API.
  - Resource modified: Order.
  - New methods: cancel, list_line_items, reopen, and submit
  - Removed methods: pay and return_order
  - Removed resources: OrderItem and OrderReturn
  - Removed references from other resources: Charge.order
- ⚠️ Rename \FinancialConnections\Account.refresh method to \FinancialConnections\Account.refresh_account
- Add support for amount_discount, amount_tax, and product on LineItem

7.128.0

#1282 API Updates
- Add support for default_price on Product
- Add support for instructions_email on Refund

7.127.0

#1281 API Updates
- Add support for new resources FinancialConnections.AccountOwner, FinancialConnections.AccountOwnership, FinancialConnections.Account, and FinancialConnections.Session
#1278 Pin setup-php action version.
#1277 API Updates
- Add support for registered_address on Person

7.126.0

#1276 API Updates
- Add support for new resource CashBalance
- Change type of BillingPortal.Configuration.application from $Application to deletable($Application)
- Add support for cash_balance on Customer
- Add support for application on Invoice, Quote, SubscriptionSchedule, and Subscription
- Add support for new value eu_oss_vat on enum TaxId.type
#1274 Fix PHPDoc on Discount for nullable properties
#1272 Allow users to pass a custom IPRESOLVE cURL option.

7.125.0

#1270 API Updates
- Add support for expire test helper method on resource Refund

7.124.0

#1265 API Updates
- Add support for new resources FundingInstructions and Terminal.Configuration
- Add support for create_funding_instructions method on resource Customer
- Add support for amount_details on PaymentIntent
- Add support for customer_balance on PaymentMethod
- Add support for new value customer_balance on enum PaymentMethod.type
- Add support for configuration_overrides on Terminal.Location

7.123.0

#1263 API Updates
- Add support for increment_authorization method on resource PaymentIntent
#1262 Add support for updating the version of the repo
#1230 Add PHPDoc return types
#1242 Fix some PHPDoc in tests

7.122.0

#1261 API Updates
- Add support for apply_customer_balance method on resource PaymentIntent
#1259 API Updates
- Add payment_intent.partially_funded, terminal.reader.action_failed, and terminal.reader.action_succeeded events.

7.121.0

#1258 API Updates
- Add support for cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.Reader
- Add support for action on Terminal.Reader

7.120.0

#1257 API Updates
- Add support for Search API
  - Add support for search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription

7.119.0

#1256 API Updates
- Add support for PayNow and US Bank Accounts Debits payments
  - Add support for paynow and us_bank_account on PaymentMethod
  - Add support for new values paynow and us_bank_account on enum PaymentMethod.type
- Add support for failure_balance_transaction on Charge

7.118.0

#1255 API Updates
- Add support for cancel method on resource Refund
- Add support for new values bg_uic, hu_tin, and si_tin on enum TaxId.type
- Add test_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.

7.117.0

#1254 API Updates
- Add support for status on Card
#1251 Add support for SearchResult objects.
#1249 Add missing constant for payment_behavior

7.116.0

#1248 API Updates
- Add support for proration_details on InvoiceLineItem

7.115.0

#1245 #1247 API Updates
- Add support for new resource TestHelpers.TestClock
- Add support for test_clock on Customer, Invoice, InvoiceItem, Quote, Subscription, and SubscriptionSchedule
- Add support for next_action on Refund
- Add support for konbini on PaymentMethod
#1244 API Updates
- Add support for new values bbpos_wisepad3 and stripe_m2 on enum Terminal.Reader.device_type

7.114.0

#1243 Add test
#1240 API Updates
- Add support for verify_microdeposits method on resources PaymentIntent and SetupIntent
#1241 Add generic parameter to \Stripe\Collection usages

7.113.0

#1239 API Updates
- Add REASON_EXPIRED_UNCAPTURED_CHARGE enum value on Refund.

7.112.0

#1235 API Updates
- Add support for phone_number_collection on PaymentLink
- Add support for new value is_vat on enum TaxId.type

7.111.0

#1233 API Updates
- Add support for new resource PaymentLink
- Add support for payment_link on Checkout.Session

7.110.0

#1232 API Updates
- Add support for paid_out_of_band on Invoice

7.109.0

#1231 API Updates
- Add support for customer_creation on Checkout.Session
#1227 Update docs URLs

7.108.0

#1226 Upgrade php-cs-fixer to 3.4.0.
#1222 API Updates
- Add support for processing on PaymentIntent
#1220 API Updates

7.107.0

#1219 API Updates
- Add support for metadata on BillingPortal.Configuration
- Add support for wallets on Issuing.Card

7.106.0

#1218 API Updates
- Add support for new values ge_vat and ua_vat on enum TaxId.type
#1216 Fix namespaced classes in @return PHPDoc.
#1214 Announce PHP8 support in CHANGELOG.md

7.105.0

#1213 PHP 8.1 missing ReturnTypeWillChange annotations.
As of this version, PHP 8.1 is officially supported.

7.104.0

#1211 PHPStan compatibility with PHP8.x
#1209 PHPUnit compatibility with PHP 8.x

7.103.0

#1206 API Updates
- Add support for new value jct on enum TaxRate.tax_type

7.102.0

#1205 API Updates
- Add support for automatic_payment_methods on PaymentIntent

7.101.0

#1203 API Updates
- Add support for new resource ShippingRate
- Add support for shipping_options and shipping_rate on Checkout.Session
- Add support for expire method on resource Checkout.Session
- Add support for status on Checkout.Session

7.99.0

#1188 API Updates
- Add support for list_payment_methods method on resource Customer

7.100.0

#1190 API Updates
- Add support for klarna on PaymentMethod.

7.98.0

#1187 API Updates
- Add support for phone_number_collection on Checkout.Session
- Add support for new value customer_id on enum Radar.ValueList.item_type
- Add support for new value bbpos_wisepos_e on enum Terminal.Reader.device_type

7.97.0

#1181 API Updates
- Add support for full_name_aliases on Person

7.96.0

#1178 API Updates
- Add support for livemode on Reporting.ReportType
- Add support for new value rst on enum TaxRate.tax_type

7.95.0

#1177 API Updates
- Add support for future_requirements on Account, Capability, and Person
- Add support for after_expiration, consent, consent_collection, expires_at, and recovered_from on Checkout.Session

7.94.0

#1173 API Updates
- Add support for new value fil on enum Checkout.Session.locale
- Add support for new value au_arn on enum TaxId.type

7.93.0

#1172 API Updates
- Add support for locale on BillingPortal.Session
#1171 Fix typo in docblock CurlClient::executeStreamingRequestWithRetries

7.92.0

#1167 API Updates
- Add support for account_type on BankAccount
- Add support for new value redacted on enum Review.closed_reason

7.91.0

#1164 API Updates
- Add support for new values hr, ko, and vi on enum Checkout.Session.locale
- Add support for payment_settings on Subscription

7.90.0

#1163 API Updates
- Add support for wallet on Issuing.Transaction
#1160 Remove unused API error types from docs.

7.89.0

#1158 API Updates
- Add support for list_computed_upfront_line_items method on resource Quote
#1157 Improve readme for old PHP versions

7.88.0

#1152 API Updates
- Add support for new resource Quote
- Add support for quote on Invoice
- Add support for new value quote_accept on enum Invoice.billing_reason
#1155 Add streaming methods to Service infra
- Add support for setStreamingHttpClient and streamingHttpClient to ApiRequestor
- Add support for getStreamingClient and requestStream to AbstractService
- Add support for requestStream to BaseStripeClient
- \Stripe\RequestOptions::parse now clones its input if it is already a RequestOptions object, to prevent accidental mutation.
#1151 Add mode constants into Checkout\Session

7.87.0

#1149 API Updates
- Add support for wechat_pay on PaymentMethod
#1143 Streaming requests
#1138 Deprecate travis

7.86.0

#1145 API Updates
- Add support for boleto on PaymentMethod.
- Add support for il_vat as a member of the TaxID.Type enum.

7.85.0

#1142 API Updates
- Add support for new TaxId types: ca_pst_mb, ca_pst_bc, ca_gst_hst, and ca_pst_sk.

7.84.0

#1141 Update PHPDocs
- Add support for url on Checkout\Session

7.83.0

#1140 API Updates
- Added support for tax_id_collection on Checkout\Session and Checkout\Session#create
- Update Location to be expandable on Terminal\Reader

7.82.0

#1136 Update PHPDocs
- Add support for controller on Account.

7.81.0

#1135 API Updates
- Add support for new resource TaxCode
- Add support for automatic_tax Invoice andCheckout.Session.
- Add support for tax_behavior on Price
- Add support for tax_code on Product
- Add support for tax on Customer
- Add support for tax_type enum on TaxRate

7.80.0

#1130 Update PHPDocs

7.79.0

#1126 API Updates
- Added support for new resource Identity.VerificationReport
- Added support for new resource Identity.VerificationSession
- File#list.purpose and File.purpose added new enum members: identity_document_downloadable and selfie.

7.78.0

#1120 Update PHPDocs
- Add support for Radar.EarlyFraudWarning.payment_intent

7.77.0

#1110 Update PHPDocs
- Add support for acss_debit on PaymentMethod
- Add support for payment_method_options on Checkout\Session
#1107 Remove duplicate object phpdoc

7.76.0

#1100 Update PHPDocs
- Added support for amount_shipping on Checkout.Session.total_details
#1088 Make possibility to extend CurlClient

7.75.0

#1094 Add support for Billing Portal Configuration API

7.74.0

#1093 Update PHPDocs
- Add support for on_behalf_of to Invoice

7.73.0

#1091 Update PHPDocs
- Add support for afterpay_clearpay on PaymentMethod.

7.72.0

#1089 Update PHPDocs
- Add support for afterpay_clearpay_payments on Account.capabilities
- Add support for payment_settings on Invoice

7.71.0

#1087 Update PHPDocs
#1086 Update CA cert bundle URL

7.70.0

#1085 Update PHPDocs
- Add support for nationality on Person
- Add member gb_vat of TaxID enum

7.69.0

#1079 Update PHPDocs

7.68.0

#1063 Multiple API changes
#1061 Bump phpDocumentor to 3.0.0

7.67.0

#1060 Improve PHPDocs for Discount
#1059 Upgrade PHPStan to 0.12.59
#1057 Bump PHP-CS-Fixer and update code

7.66.1

#1054 Improve error message for invalid keys in StripeClient

7.66.0

#1053 Update PHPDocs

7.65.0

#1050 Added constants for proration_behavior on Subscription

7.64.0

#1049 Update PHPDocs

7.63.0

#1048 Update PHPDocs
#1046 Force IPv4 resolving

7.62.0

#1041 Add missing constants on Event
#1038 Update PHPDocs

7.61.0

#1030 Add support for jp_rn and ru_kpp as a type on TaxId

7.60.0

#1027 Warn if opts are in params

7.58.0

#1026 Add support for the Payout Reverse API

7.57.0

#1020 Add support for the SetupAttempt resource and List API

7.56.0

#1019 Update PHPDocs

7.55.0

#1018 Multiple API changes
- Updated PHPDocs
- Added TYPE_CONTRIBUTION as a constant on BalanceTransaction

7.54.0

#1017 Updated PHPDoc

7.53.1

#1015 Bugfix: don't error on systems with php_uname in disablefunctions with whitespace

7.53.0

#1016 Updated PHPDocs

7.52.0

#1010 Update PHPDocs

7.51.0

#1007 Multiple API changes
- Add support for the Issuing Dispute Submit API
- Add constants for payment_status on Checkout Session
#1003 Add trim to getSignatures to allow for leading whitespace.

7.50.0

#1005 Updated PHPDocs

7.49.0

#998 PHPDocs updated

7.48.0

#997 PHPDocs updated
#996 Fixing telemetry

7.47.0

#994 Nullable balance_transactions on issuing disputes
#991 Fix invalid return types in OAuthService

7.46.1

#990 PHPdoc changes

7.46.0

#989 Add support for the PromotionCode resource and APIs

7.45.0

#981 PHPdoc updates

7.44.0

#948 Add first() and last() functions to Collection

7.43.0

#975 Add support for political_exposure on Person

7.42.0

#974 Add new constants for purpose on File

7.41.1

#973 Multiple PHPDoc fixes

7.41.0

#971 Adds enum values for billing_address_collection on Checkout Session

7.40.0

#964 Add OAuthService

7.39.0

#960 Add constants for payment_behavior on Subscription

7.38.0

#959 Add multiple constants missing for Event

7.37.2

#957 Updated PHPDocs

7.37.1

#952 Improve PHPDoc

7.37.0

#950 Add support for id_npwp and my_frp as type on TaxId

7.36.2

#946 Update PHPDoc

7.36.1

#938 Remove extra array_keys() call.
#942 fix autopagination for service methods

7.36.0

#937 Add support for ae_trn, cl_tin and sa_vat as type on TaxId

7.35.0

#936 Add anticipation_repayment as a type on BalanceTransaction

7.34.0

#934 Add support for issuing_dispute as a type on BalanceTransaction

7.33.1

#933 Services bugfix: convert nested null params to empty strings

7.33.0

#771 Introduce client/services API. The migration guide contains before & after examples of the backwards-compatible changes.

7.32.1

#932 Fix multiple PHPDoc

7.32.0

#931 Add support for the LineItem resource and APIs

7.31.0

#927 Add support for new tax IDs

7.30.0

#924 Add support for the Price resource and APIs

7.29.0

#920 Add support for the Session resource and APIs on the BillingPortal namespace

7.28.1

#915 Improve PHPdocs for many classes

7.28.0

#912 Preserve backwards compatibility for typoed TYPE_ADJUSTEMENT enum.
#911 Codegenerated PHPDoc for nested resources
#902 Update docstrings for nested resources

7.27.3

#899 Convert keys to strings in StripeObject::toArray()

7.27.2

#894 Multiple PHPDocs changes

7.27.1

#890 Update PHPdoc

7.27.0

#889 Add new constants for type on TaxId

7.26.0

#886 Add support for listing Checkout Session
#883 Add PHPDoc class descriptions

7.25.0

#879 Make \Stripe\Collection implement \Countable
#875 Last set of PHP-CS-Fixer updates
#874 Enable php_unit_internal_class rule
#873 Add support for phpDocumentor in Makefile
#872 Another batch of PHP-CS-Fixer rule updates
#871 Fix a few PHPDoc comments
#870 More PHP-CS-Fixer tweaks

7.24.0

#862 Better PHPDoc
#865 Get closer to [@PhpCsFixer](https://github.com/PhpCsFixer) standard ruleset

7.23.0

#860 Add PHPDoc types for expandable fields
#858 Use native_function_invocation PHPStan rule
#857 Update PHPDoc on nested resources
#855 PHPDoc: StripeObject -> ErrorObject where appropriate
#837 Autogen diff
#854 Upgrade PHPStan and fix settings
#850 Yet more PHPDoc updates

7.22.0

#849 Add new constants for type on TaxId
#843 Even more PHPDoc fixes
#841 More PHPDoc fixes

7.21.1

#840 Update phpdocs across multiple resources.

7.21.0

#839 Add support for TYPE_ES_CIF on TaxId

7.20.0

#836 Add new type values for TaxId

7.19.1

#831 Fix incorrect UnexpectedValueException instantiation

7.19.0

#830 Add support for CreditNoteLineItem

7.18.0

#829 Don't call php_uname function if disabled by php.ini

7.17.0

#821 Improve PHPDoc types for ApiErrorException.get/setJsonBody() methods

7.16.0

#826 Rename remaining $options to $opts
#825 Update PHPDoc

7.15.0

#824 Add constant TYPE_SG_UEN to TaxId

7.14.2

#816 Disable autoloader when checking for Throwable

7.14.1

#812 Fix invalid PHPdoc on Subscription

7.14.0

#811 Add support for CreditNote preview.

7.13.0

#808 Add support for listing lines on an Invoice directly via Invoice::allLines()

7.12.0

#805 Add Source::allSourceTransactions and SubscriptionItem::allUsageRecordSummaries
#798 The argument of array_key_exists cannot be null
#803 Removed unwanted got

7.11.0

#797 Add support for reverse pagination

7.9.0

#794 Add PHPDoc to ApiResponse
#792 Use single quotes for OBJECT_NAME constants

7.8.0

#790 Mark nullable fields in PHPDoc
#788 Early codegen fixes
#787 Use PHPStan in Travis CI

7.10.0

#795 Add support for Mandate

7.7.1

#781 Fix telemetry header
#780 Contributor Convenant

7.7.0

#776 Add CAPABILITY_TRANSFERS to Account
#778 Add support for TYPE_MX_RFC type on TaxId

7.6.0

#770 Add missing constants for Customer's TaxId

7.5.0

#768 Redact API key in RequestOptions debug info

7.4.0

#764 Add support for HTTP request monitoring callback

7.3.1

#755 Respect Stripe-Should-Retry and Retry-After headers

7.3.0

#752 Add payment_intent.canceled and setup_intent.canceled events
#749 Call toArray() on objects only

7.2.2

#746 Add missing decline codes

7.2.1

#744 Added new PHPDoc

7.2.0

#738 Added missing constants for SetupIntent events

7.1.1

#737 Added new PHPDoc

7.1.0

#736 Make CaseInsensitiveArray countable and traversable

7.0.2

#729 Fix usage of SignatureVerificationException in PHPDoc blocks

7.0.1

#728 Clean up Collection

7.0.0

Major version release. The migration guide contains a detailed list of backwards-incompatible changes with upgrade instructions.

Pull requests included in this release (cf. #552) (⚠️ = breaking changes):

⚠️ Drop support for PHP 5.4 (#551)
⚠️ Drop support for PHP 5.5 (#554)
Bump dependencies (#553)
Remove CURLFile check (#555)
Update constant definitions for PHP >= 5.6 (#556)
⚠️ Remove FileUpload alias (#557)
Remove curl_reset check (#570)
Use \Stripe\<class>::class constant instead of strings (#643)
Use array_column to flatten params (#686)
⚠️ Remove deprecated methods (#692)
⚠️ Remove IssuerFraudRecord (#696)
Update constructors of Stripe exception classes (#559)
Fix remaining TODOs (#700)
Use yield for autopagination (#703)
⚠️ Rename fake magic methods and rewrite array conversion (#704)
Add ErrorObject to Stripe exceptions (#705)
Start using PHP CS Fixer (#706)
Update error messages for nested resource operations (#708)
Upgrade retry logic (#707)
⚠️ Collection improvements / fixes (#715)
⚠️ Modernize exceptions (#709)
Add constants for error codes (#716)
Update certificate bundle (#717)
Retry requests on a 429 that's a lock timeout (#718)
Fix toArray() calls (#719)
Couple of fixes for PHP 7.4 (#725)

6.43.1

#722 Make LoggerInterface::error compatible with its PSR-3 counterpart
#714 Add pending_setup_intent property in Subscription
#713 Add typehint to ApiResponse
#712 Fix comment
#701 Start testing PHP 7.3

6.43.0

#694 Add SubscriptionItem::createUsageRecord method

6.42.0

#688 Remove SubscriptionScheduleRevision
- Note that this is technically a breaking change, however we've chosen to release it as a minor version in light of the fact that this resource and its API methods were virtually unused.

6.41.0

#683 Move the List Balance History API to /v1/balance_transactions

6.40.0

#675 Add support for SetupIntent resource and APIs

6.39.2

#676 Fix exception message in CustomerBalanceTransaction::update()

6.39.1

#674 Add new constants for collection_method on Invoice

6.39.0

#673 Enable request latency telemetry by default

6.38.0

#649 Add support for CustomerBalanceTransaction resource and APIs

6.37.2

#671 Add new PHPDoc
#672 Add constants for submit_type on Checkout Session

6.37.1

#670 Add new PHPDoc

6.37.0

#663 Add support for radar.early_fraud_warning resource

6.36.0

#661 Add constants for new TaxId types
#662 Add constants for BalanceTransaction types

6.35.2

#655 Add constants for payment intent statuses
#659 Fix PHPDoc for various nested Account actions
#660 Fix various PHPDoc

6.35.1

#658 Use absolute value when checking timestamp tolerance

6.35.0

#651 Add support for the Capability resource and APIs

6.34.6

#654 Fix typo in definition of Event::PAYMENT_METHOD_ATTACHED constant

6.34.5

#647 Set the return type to static for more operations

6.34.4

#650 Add missing constants for Event types

6.34.3

#644 Update return type to static to improve static analysis
#645 Fix constant for payment_intent.payment_failed

6.34.2

#642 Fix an issue where existing idempotency keys would be overwritten when using automatic retries

6.34.1

#640 Add missing phpdocs

6.34.0

#626 Add support for the TaxRate resource and APIs
#639 Fix multiple phpdoc issues

6.33.0

#630 Add support for the TaxId resource and APIs

6.32.1

#636 Correct type of $personId in PHPDoc

6.32.0

#621 Add support for CreditNote

6.31.5

#628 Add constants for person.* event types
#628 Add missing constants for Account and Person

6.31.4

#624 Fix encoding of nested parameters in multipart requests

6.31.3

#623 Only use HTTP/2 with curl >= 7.60.0

6.31.2

#619 Fix PHPDoc return types for list methods for nested resources

6.31.1

#612 Add a lot of constants
#614 Add missing subscription status constants

6.31.0

#600 Add support for the PaymentMethod resource and APIs
#606 Add support for retrieving a Checkout Session
#611 Add support for deleting a Terminal Location and Reader

6.30.5

#607 Correctly handle case where a metadata key is called metadata

6.30.4

#602 Add subscription_schedule to Subscription for PHPDoc.

6.30.3

#603 Improve PHPDoc on the Source object to cover all types of Sources currently supported.

6.30.2

#601 Fix PHPDoc across multiple resources and add support for new events.

6.30.1

#599 Fix PHPDoc for SubscriptionSchedule and SubscriptionScheduleRevision

6.30.0

#590 Add support for SubscriptionSchedule and SubscriptionScheduleRevision

6.29.3

#592 Some more PHPDoc fixes

6.29.2

#591 Fix PHPDoc for nested resources

6.29.1

#566 Fix dangling message contents
#586 Don't overwrite CURLOPT_HTTP_VERSION option

6.29.0

#579 Rename CheckoutSession to Session and move it under the Checkout namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.

6.28.1

#580 Properly serialize individual on Account objects

6.28.0

#576 Add support for iterating directly over Collection instances

6.27.0

#571 Add support for the CheckoutSession resource

6.26.0

#568 Enable persistent connections

6.25.0

#567 Add support for account links

6.24.0

#562 Add support for the Review resource
#564 Add event name constants for subscription schedule aborted/expiring

6.23.0

#542 Add support for ValueList and ValueListItem for Radar

6.22.1

#561 Add cast and some docs to telemetry introduced in 6.22.0/549

6.22.0

#549 Add support for client telemetry

6.21.1

#548 Don't mutate Exception class properties from OAuthBase error

6.21.0

#537 Add new API endpoints for the Invoice resource.

6.20.1

#546 Drop files from the Composer package that aren't needed in the release

6.20.0

#536 Add support for the Person resource
#541 Add support for the WebhookEndpoint resource

6.19.5

#539 Fix methods on \Stripe\PaymentIntent to properly pass arguments to the API.

6.19.4

#534 Fix PSR-4 autoloading for \Stripe\FileUpload class alias

6.19.3

#530 Add constants for flow (FLOW_*), status (STATUS_*) and usage (USAGE_*) on \Stripe\Source

6.19.2

#531 Store HTTP response headers in case-insensitive array

6.19.1

#526 Ignore null values in request parameters

6.19.0

#523 Add support for Stripe Terminal

6.18.0

#520 Rename \Stripe\FileUpload to \Stripe\File

6.17.2

#522 Fix warning when adding a new additional owner to an existing array

6.17.1

#517 Integer-index encode all sequential arrays

6.17.0

#514 Add support for reporting resources

6.16.0

#509 Add support for usage record summaries

6.15.0

#504 Add cancel support for topups

6.14.0

#505 Add support for file links

6.13.0

#502 Add isDeleted() method to \Stripe\StripeObject

6.12.0

#501 Add support for scheduled query runs (\Stripe\Sigma\ScheduledQueryRun) for Sigma

6.11.0

#500 Add support for Stripe Issuing

6.10.4

#498 Internal improvements to the \Stripe\ApiResource.classUrl() method

6.10.3

#497 Use HTTP/2 only for HTTPS requests

6.10.2

#494 Enable HTTP/2 support

6.10.1

#493 Add PHPDoc for auto_advance on \Stripe\Invoice

6.9.0

#487 Add support for payment intents

6.10.0

#488 Add support for $appPartnerId to Stripe::setAppInfo()

6.8.2

#486 Make Account.deauthorize() return the StripeObject from the API

6.8.1

#472 Added phpDoc for ApiRequestor and others, especially regarding thrown errors

6.8.0

#481 Add new \Stripe\Discount and \Stripe\OrderItem classes, add more PHPDoc describing object attributes

6.7.4

#480 PHPDoc changes for API version 2018-05-21 and the addition of the new CHARGE_EXPIRED event type

6.7.3

#479 Fix unnecessary traits on \Stripe\InvoiceLineItem

6.7.2

#471 Add OBJECT_NAME constant to all API resource classes, add \Stripe\InvoiceLineItem class

6.7.1

#468 Update fields in PHP docs for accuracy

6.7.0

#466 Add support for issuer fraud records

6.6.0

#460 Add support for flexible billing primitives

6.5.0

#461 Don't zero keys on non-metadata subobjects

6.4.2

#458 Add PHPDoc for account on \Stripe\Event

6.4.1

#455 Fix namespaces in PHPDoc
#456 Fix namespaces for some exceptions

6.4.0

#453 Add constants for reason (REASON_*) and status (STATUS_*) on \Stripe\Dispute

6.3.2

#452 Add PHPDoc for amount_paid and amount_remaining on \Stripe\Invoice

6.3.1

#443 Add event types as constants to \Stripe\Event class

6.3.0

#450 Add support for code attribute on all Stripe exceptions

6.2.0

#440 Add support for topups
#442 Fix PHPDoc for \Stripe\Error\SignatureVerification

6.1.0

#435 Fix header persistence on Collection objects
#436 Introduce new Idempotency error class

6.0.0

Major version release. List of backwards incompatible changes to watch out for:

The minimum PHP version is now 5.4.0. If you're using PHP 5.3 or older, consider upgrading to a more recent version.

\Stripe\AttachedObject no longer exists. Attributes that used to be instances of \Stripe\AttachedObject (such as metadata) are now instances of \Stripe\StripeObject.

Attributes that used to be PHP arrays (such as legal_entity->additional_owners on \Stripe\Account instances) are now instances of \Stripe\StripeObject, except when they are empty. \Stripe\StripeObject has array semantics so this should not be an issue unless you are actively checking types.

\Stripe\Collection now derives from \Stripe\StripeObject rather than from \Stripe\ApiResource.

Pull requests included in this release:

#410 Drop support for PHP 5.3
#411 Use traits for common API operations
#414 Use short array syntax
#404 Fix serialization logic
#417 Remove ExternalAccount class
#418 Increase test coverage
#421 Update CA bundle and add script for future updates
#422 Use vendored CA bundle for all requests
#428 Support for automatic request retries

5.9.2

#431 Update PHPDoc @property tags for latest API version

5.9.1

#427 Add and update PHPDoc @property tags on all API resources

5.9.0

#421 Updated bundled CA certificates
#423 Escape unsanitized input in OAuth example

5.8.0

#403 Add __debugInfo() magic method to StripeObject

5.7.0

#390 Remove some unsupported API methods
#391 Alphabetize the list of API resources in Util::convertToStripeObject() and add missing resources
#393 Fix expiry date update for card sources

5.6.0

#386 Support for exchange rates APIs

5.5.1

#387 Allow personal_address_kana and personal_address_kanji to be updated on an account

5.5.0

#385 Support for listing source transactions

5.4.0

#383 Add static methods to manipulate resources from parent
- Account gains methods for external accounts and login links (e.g. createExternalAccount, createLoginLink)
- ApplicationFee gains methods for refunds
- Customer gains methods for sources
- Transfer gains methods for reversals

5.3.0

#378 Rename source delete to detach (and deprecate the former)

5.2.3

Add PHPDoc for Card

5.2.2

Fix deserialization mapping of FileUpload objects

5.2.1

Serialized shipping nested attribute

5.2.0

Add support for InvalidClient OAuth error

5.1.3

Allow address_kana and address_kanji to be updated for custom accounts

5.1.2

Fix documented return type of autoPagingIterator() (was missing namespace)

5.1.1

Fix order returns to use the right URL /v1/order_returns

5.1.0

Add support for OAuth

5.0.0

pay on invoice now takes params as well as opts

4.13.0

Add support for ephemeral keys

4.12.0

Clients can implement getUserAgentInfo() to add additional user agent information

4.11.0

Implement Countable for AttachedObject (metadata and additional_owners)

4.10.0

Add support for login links

4.9.1

Fix docs to include arrays on $id parameter for retrieve methods

4.9.0

Support for checking webhook signatures

4.8.1

Allow nested field payout_schedule to be updated

4.8.0

Add \Stripe\Stripe::setLogger() to support an external PSR-3 compatible logger

4.7.0

Add support for payouts and recipient transfers

4.6.0

Please see 4.7.0 instead (no-op release)

4.5.1

Remove hard dependency on cURL

4.5.0

Support for detaching sources from customers

4.4.2

Correct handling of owner parameter when updating sources

4.4.1

Correct the error check on a bad JSON decoding

4.4.0

Add support for updating sources

4.3.0

Add support for verifying sources

4.2.0

Add retrieve method for 3-D Secure resources

4.1.1

Add docblock with model properties for Plan

4.1.0

Support for 403 status codes (permission denied)

4.0.1

Fix transfer reversal materialization
Fixes for some property definitions in docblocks

4.0.0

Support for subscription items
Drop attempt to force TLS 1.2: please note that this could be breaking if you're using old OS distributions or packages and upgraded recently (so please make sure to test your integration!)

3.23.0

Add support for Apple Pay domains

3.22.0

Add Stripe::setAppInfo to allow plugins to register user agent information

3.21.0

Add Source model for generic payment sources

3.20.0

Add getDeclineCode to card errors

3.19.0

Opt requests directly into TLS 1.2 where OpenSSL >= 1.0.1 (see #277 for context)

3.18.0

Add new STATUS_ constants for subscriptions

3.17.1

Fix auto-paging iterator so that it plays nicely with iterator_to_array

3.17.0

Add field annotations to model classes for better editor hinting

3.16.0

Add ThreeDSecure model for 3-D secure payments

3.15.0

Add static update method to all resources that can be changed.

3.14.3

Make sure that cURL never sends Expects: 100-continue, even on large request bodies

3.14.2

Add inventory under SKU to list of keys that have nested data and can be updated

3.14.1

Fix some inconsistencies in PHPDoc

3.14.0

Add support for returning Relay orders

3.13.0

Add list, create, update, retrieve, and delete methods to the Subscription class

3.12.1

Additional check on value arrays for some extra safety

3.12.0

Fix bug refreshFrom on StripeObject would not take an $opts array
Fix bug where $opts not passed to parent save method in Account
Fix bug where non-existent variable was referenced in reverse in Transfer
Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1

3.11.0

Allow CurlClient to be initialized with default CURLOPT_* options

3.10.1

Fix bug where request params and options were ignored in ApplicationFee's refund.

3.10.0

Add reject on Account to support the new API feature

3.9.2

Fix error when an object's metadata is set more than once

3.9.1

Fix encoding behavior of nested arrays for requests (see #227)

3.9.0

Add automatic pagination mechanism with autoPagingIterator()
Allow global account ID to be set with Stripe::setAccountId()

3.8.0

Add CountrySpec model for looking up country payment information

3.7.1

Update bundled CA certs

3.7.0

Support deleting Relay products and SKUs

3.6.0

Allow configuration of HTTP client timeouts

3.5.0

Add a verification routine for external accounts

3.4.0

Products, SKUs, and Orders -- https://stripe.com/relay

3.3.0

Add support for 429 Rate Limit response

3.2.0

Add refund listing and retrieval without an associated charge

3.1.0

Add dispute listing and retrieval
Add support for manage account deletion

3.0.0

Rename \Stripe\Object to \Stripe\StripeObject (PHP 7 compatibility)
Rename getCode and getParam in exceptions to getStripeCode and getStripeParam
Add support for calling json_encode on Stripe objects in PHP 5.4+
Start supporting/testing PHP 7

2.3.0

Add request ID to all Stripe exceptions

2.2.0

Add support for Alipay accounts as sources
Add support for bank accounts as sources (private beta)
Add support for bank accounts and cards as external_accounts on Account objects

2.1.4

Fix CA certificate file path (thanks @lphilps & @matthewarkin)

2.1.3

Fix to account updating to permit tos_acceptance and personal_address to be set properly
Fix to Transfer reversal creation (thanks @neatness!)
Network requests are now done through a swappable class for easier mocking

2.1.2

Remove SSL cert revokation checking (all pre-Heartbleed certs have expired)
Bug fixes to account updating

2.1.1

Support transfer reversals

2.1.0

Support new API version (2015-02-18)
Added Bitcoin Receiever update and delete actions
Edited tests to prefer "source" over "card" as per new API version

2.0.1

Fix to fetching endpoints that use a non-default baseUrl (FileUpload)

2.0.0

Bumped minimum version to 5.3.3
Switched to Stripe namespace instead of Stripe_ class name prefiexes (thanks @chadicus!)
Switched tests to PHPUnit (thanks @chadicus!)
Switched style guide to PSR2 (thanks @chadicus!)
Added $opts hash to the end of most methods: this permits passing 'idempotency_key', 'stripe_account', or 'stripe_version'. The last 2 will persist across multiple object loads.
Added support for retrieving Account by ID

1.18.0

Support making bitcoin charges through BitcoinReceiver source object

1.17.5

Adding support for creating file uploads.

1.17.4

Saving objects fetched with a custom key now works (thanks @JustinHook & @jpasilan)
Added methods for reporting charges as safe or fraudulent and for specifying the reason for refunds

1.17.3

Better handling of HHVM support for SSL certificate blacklist checking.

1.17.2

Coupons now are backed by a Stripe_Coupon instead of Stripe_Object, and support updating metadata
Running operations (create, retrieve, all) on upcoming invoice items now works

1.17.1

Requests now send Content-Type header

1.17.0

Application Fee refunds now a list instead of array
HHVM now works
Small bug fixes (thanks @bencromwell & @fastest963)
__toString now returns the name of the object in addition to its JSON representation

1.16.0

Add metadata for refunds and disputes

1.15.0

Support canceling transfers

1.14.1

Support cards for recipients.

1.13.1

Fix bug in account resource where id wasn't in the result

1.13.0

Add support for certificate blacklisting
Update ca bundle
Drop support for HHVM (Temporarily)

1.12.0

Add Stripe_RateLimitError for catching rate limit errors.
Update to Zend coding style (thanks, @jpiasetz)

1.11.0

Add support for multiple subscriptions per customer

1.10.1

Add new ApplicationFee

1.9.1

Fix a bug where a null nestable object causes warnings to fire.

1.9.0

Add support for metadata API.

1.8.4

Add support for closing disputes.

1.8.3

Add new Balance and BalanceTransaction

1.8.2

Add support for unsetting attributes by updating to NULL. Setting properties to a blank string is now an error.

1.8.1

Add support for multiple cards API (Stripe API version 2013-07-12: https://docs.stripe.com/changelog/2013-07-05)

1.8.0

Allow Transfers to be creatable
Add new Recipient resource

1.7.15

Add 'id' to the list of permanent object attributes

1.7.14

Don't re-encode strings that are already encoded in UTF-8. If you were previously using plan or coupon objects with UTF-8 IDs, they may have been treated as ISO-8859-1 (Latin-1) and encoded to UTF-8 a 2nd time. You may now need to pass the IDs to utf8_encode before passing them to Stripe_Plan::retrieve or Stripe_Coupon::retrieve.
Ensure that all input is encoded in UTF-8 before submitting it to Stripe's servers. (github issue #27)

1.7.13

Add support for passing options when retrieving Stripe objects e.g., Stripe_Charge::retrieve(array("id"=>"foo", "expand" => array("customer"))); Stripe_Charge::retrieve("foo") will continue to work

1.7.12

Add support for setting a Stripe API version override

1.7.11

Version bump to cleanup constants and such (fix issue #26)

1.7.9

Fix usage under autoloaders such as the one generated by composer (fix issue #22)

1.7.10

Add support for updating charge disputes.
Fix bug preventing retrieval of null attributes

1.7.8

Add support for creating invoices.
Add support for new invoice lines return format
Add support for new list objects

1.7.7

Get all of the various version numbers in the repo in sync (no other changes)

1.7.6

Add update and pay methods to Invoice resource

1.7.5

Change internal function names so that Stripe_SingletonApiRequest is E_STRICT-clean (github issue #16)

1.7.4

Bugfix so that Stripe objects (e.g. Customer, Charge objects) used in API calls are transparently converted to their object IDs

1.7.3

Add new Account resource

1.7.2

Make clearer that you should be including lib/Stripe.php, not test/Stripe.php (github issue #14)

1.7.1

Add missing argument to Stripe_InvalidRequestError constructor in Stripe_ApiResource::instanceUrl. Fixes a warning when Stripe_ApiResource::instanceUrl is called on a resource with no ID (fix issue #12)

1.7.0

Support Composer and Packagist (github issue #9)
Add new deleteDiscount method to Stripe_Customer
Add new Transfer resource
Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
Numerous test suite improvements

Stripe Php Laravel Package

⚠️ Breaking changes due to changes in the Stripe API

⚠️ Breaking changes due to changes in the Stripe API

⚠️ Other Breaking changes in the SDK

Additions

⚠️ Breaking changes

Additions

⚠️ Breaking changes

Additions

⚠️ Breaking changes

⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API

Version pinning

Other changes

Deprecated

⚠️ Removed

Added

⚠️ Changed

⚠️ Removed