WP Adverts - Stripe Integration

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

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

• #1673

  • This release changes the pinned API version to 2024-04-10. Please read the API Upgrade Guide 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

⚠️ 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

1. (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.

2. (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

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

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

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

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

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

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

• #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)

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

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

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

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

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

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

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

• #1453 Restore StripeClient.getService

• #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)

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

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

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

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

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

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

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

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

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

• #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://stripe.com/docs/upgrades#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.

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

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

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

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

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

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

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

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

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

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://stripe.com/docs/upgrades#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.

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

• #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)

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

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

• #1302 API Updates

  • Add support for custom_unit_amount on Price

• #1301 API Updates

  Documentation updates.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• #1248 API Updates
  • Add support for proration_details on InvoiceLineItem

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

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

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

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

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

• #1232 API Updates
  • Add support for paid_out_of_band on Invoice

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

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

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

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

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

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

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

• #1205 API Updates
  • Add support for automatic_payment_methods on PaymentIntent

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

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

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

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

• #1181 API Updates
  • Add support for full_name_aliases on Person

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

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

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

• #1172 API Updates

  • Add support for locale on BillingPortal.Session

• #1171 Fix typo in docblock CurlClient::executeStreamingRequestWithRetries

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

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

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

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

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

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

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

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

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

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

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

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

• #1130 Update PHPDocs

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

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

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

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

• #1094 Add support for Billing Portal Configuration API

• #1093 Update PHPDocs
  • Add support for on_behalf_of to Invoice

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

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

• #1087 Update PHPDocs
• #1086 Update CA cert bundle URL

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

• #1079 Update PHPDocs

• #1063 Multiple API changes
• #1061 Bump phpDocumentor to 3.0.0

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

• #1054 Improve error message for invalid keys in StripeClient

• #1053 Update PHPDocs

• #1050 Added constants for proration_behavior on Subscription

• #1049 Update PHPDocs

• #1048 Update PHPDocs
• #1046 Force IPv4 resolving

• #1041 Add missing constants on Event
• #1038 Update PHPDocs

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

• #1027 Warn if opts are in params

• #1026 Add support for the Payout Reverse API

• #1020 Add support for the SetupAttempt resource and List API

• #1019 Update PHPDocs

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

• #1017 Updated PHPDoc

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

• #1016 Updated PHPDocs

• #1010 Update PHPDocs

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

• #1005 Updated PHPDocs

• #998 PHPDocs updated

• #997 PHPDocs updated
• #996 Fixing telemetry

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

• #990 PHPdoc changes

• #989 Add support for the PromotionCode resource and APIs

• #981 PHPdoc updates

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

• #975 Add support for political_exposure on Person

• #974 Add new constants for purpose on File

• #973 Multiple PHPDoc fixes

• #971 Adds enum values for billing_address_collection on Checkout Session

• #964 Add OAuthService

• #960 Add constants for payment_behavior on Subscription

• #959 Add multiple constants missing for Event

• #957 Updated PHPDocs

• #952 Improve PHPDoc

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

• #946 Update PHPDoc

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

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

• #936 Add anticipation_repayment as a type on BalanceTransaction

• #934 Add support for issuing_dispute as a type on BalanceTransaction

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

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

• #932 Fix multiple PHPDoc

• #931 Add support for the LineItem resource and APIs

• #927 Add support for new tax IDs

• #924 Add support for the Price resource and APIs

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

• #915 Improve PHPdocs for many classes

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

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

• #894 Multiple PHPDocs changes

• #890 Update PHPdoc

• #889 Add new constants for type on TaxId

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

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

• #862 Better PHPDoc
• #865 Get closer to @PhpCsFixer standard ruleset

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

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

• #840 Update phpdocs across multiple resources.

• #839 Add support for TYPE_ES_CIF on TaxId

• #836 Add new type values for TaxId

• #831 Fix incorrect UnexpectedValueException instantiation

• #830 Add support for CreditNoteLineItem

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

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

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

• #824 Add constant TYPE_SG_UEN to TaxId

• #816 Disable autoloader when checking for Throwable

• #812 Fix invalid PHPdoc on Subscription

• #811 Add support for CreditNote preview.

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

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

• #797 Add support for reverse pagination

• #795 Add support for Mandate

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

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

• #781 Fix telemetry header
• #780 Contributor Convenant

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

• #770 Add missing constants for Customer's TaxId

• #768 Redact API key in RequestOptions debug info

• #764 Add support for HTTP request monitoring callback

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

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

• #746 Add missing decline codes

• #744 Added new PHPDoc

• #738 Added missing constants for SetupIntent events

• #737 Added new PHPDoc

• #736 Make CaseInsensitiveArray countable and traversable

• #729 Fix usage of SignatureVerificationException in PHPDoc blocks

• #728 Clean up Collection

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)

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

• #694 Add SubscriptionItem::createUsageRecord method

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

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

• #675 Add support for SetupIntent resource and APIs

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

• #674 Add new constants for collection_method on Invoice

• #673 Enable request latency telemetry by default

• #649 Add support for CustomerBalanceTransaction resource and APIs

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

• #670 Add new PHPDoc

• #663 Add support for radar.early_fraud_warning resource

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

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

• #658 Use absolute value when checking timestamp tolerance

• #651 Add support for the Capability resource and APIs

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

• #647 Set the return type to static for more operations

• #650 Add missing constants for Event types

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

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

• #640 Add missing phpdocs

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

• #630 Add support for the TaxId resource and APIs

• #636 Correct type of $personId in PHPDoc

• #621 Add support for CreditNote

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

• #624 Fix encoding of nested parameters in multipart requests

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

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

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

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

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

• #602 Add subscription_schedule to Subscription for PHPDoc.

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

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

• #599 Fix PHPDoc for SubscriptionSchedule and SubscriptionScheduleRevision

• #590 Add support for SubscriptionSchedule and SubscriptionScheduleRevision

• #592 Some more PHPDoc fixes

• #591 Fix PHPDoc for nested resources

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

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

• #580 Properly serialize individual on Account objects

• #576 Add support for iterating directly over Collection instances

• #571 Add support for the CheckoutSession resource

• #568 Enable persistent connections

• #567 Add support for account links

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

• #542 Add support for ValueList and ValueListItem for Radar

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

• #549 Add support for client telemetry

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

• #537 Add new API endpoints for the Invoice resource.

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

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

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

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

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

• #531 Store HTTP response headers in case-insensitive array

• #526 Ignore null values in request parameters

• #523 Add support for Stripe Terminal

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

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

• #517 Integer-index encode all sequential arrays

• #514 Add support for reporting resources

• #509 Add support for usage record summaries

• #504 Add cancel support for topups

• #505 Add support for file links

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

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

• #500 Add support for Stripe Issuing

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

• #497 Use HTTP/2 only for HTTPS requests

• #494 Enable HTTP/2 support

• #493 Add PHPDoc for auto_advance on \Stripe\Invoice

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

• #487 Add support for payment intents

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

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

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

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

• #479 Fix unnecessary traits on \Stripe\InvoiceLineItem

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

• #468 Update fields in PHP docs for accuracy

• #466 Add support for issuer fraud records

• #460 Add support for flexible billing primitives

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

• #458 Add PHPDoc for account on \Stripe\Event

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

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

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

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

• #450 Add support for code attribute on all Stripe exceptions

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

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

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

• #431 Update PHPDoc @property tags for latest API version

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

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

• #403 Add __debugInfo() magic method to StripeObject

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

• #386 Support for exchange rates APIs

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

• #385 Support for listing source transactions

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