Magento_Quote Version Compatibility

Overview

This document tracks verified API surface, deprecations, and compatibility information for the Magento_Quote module in version 2.4.7.

Module Version (2.4.7): 101.2.7 PHP Requirement: ~8.1.0||~8.2.0||~8.3.0

Key Facts

Interface Return Types

Magento 2.4.7 Quote API interfaces use docblock @return annotations only — they do NOT have PHP native return type declarations:

// Actual CartRepositoryInterface in 2.4.7
// NO PHP return type declarations — only @return docblocks
public function get($cartId);
public function getList(\Magento\Framework\Api\SearchCriteriaInterface $searchCriteria);
public function getForCustomer($customerId, array $sharedStoreIds = []);
public function getActive($cartId, array $sharedStoreIds = []);
public function getActiveForCustomer($customerId, array $sharedStoreIds = []);
public function save(\Magento\Quote\Api\Data\CartInterface $quote);
public function delete(\Magento\Quote\Api\Data\CartInterface $quote);

Similarly, CartManagementInterface has NO PHP return type declarations:

public function createEmptyCart();
public function createEmptyCartForCustomer($customerId);
public function getCartForCustomer($customerId);
public function assignCustomer($cartId, $customerId, $storeId);
public function placeOrder($cartId, \Magento\Quote\Api\Data\PaymentInterface $paymentMethod = null);

When implementing these interfaces, match the interface signature exactly — do NOT add PHP return types or typed parameters that don't exist in the interface.

Quote Model Properties

The Quote model in 2.4.7 uses traditional untyped properties (e.g., protected $_customer, protected $_addresses). It does NOT use PHP typed property declarations.

Some newer classes in the module (e.g., QuoteAddressValidator) do use typed properties like protected AddressRepositoryInterface $addressRepository, but the core Quote model does not.

Composer Dependencies (2.4.7)

API Interfaces

Management Interfaces (Api/ — 21 interfaces)

• BillingAddressManagementInterface
• CartItemRepositoryInterface
• CartManagementInterface
• CartRepositoryInterface
• CartTotalManagementInterface
• CartTotalRepositoryInterface
• ChangeQuoteControlInterface
• CouponManagementInterface
• GuestBillingAddressManagementInterface
• GuestCartItemRepositoryInterface
• GuestCartManagementInterface
• GuestCartRepositoryInterface
• GuestCartTotalManagementInterface
• GuestCartTotalRepositoryInterface
• GuestCouponManagementInterface
• GuestPaymentMethodManagementInterface
• GuestShipmentEstimationInterface
• GuestShippingMethodManagementInterface
• PaymentMethodManagementInterface
• ShipmentEstimationInterface
• ShippingMethodManagementInterface

Data Interfaces (Api/Data/ — 17 interfaces)

• AddressAdditionalDataInterface
• AddressInterface
• CartInterface
• CartItemInterface
• CartSearchResultsInterface
• CurrencyInterface
• EstimateAddressInterface
• PaymentInterface
• PaymentMethodInterface
• ProductOptionInterface
• ShippingAssignmentInterface
• ShippingInterface
• ShippingMethodInterface
• TotalsAdditionalDataInterface
• TotalSegmentInterface
• TotalsInterface
• TotalsItemInterface

Verified Deprecations (from @deprecated annotations in source)

Deprecated Interface Methods

Deprecated Class Methods/Properties

Deprecated Classes

@since Version Tags

Most API interfaces are tagged @since 100.0.2. Key ones:

Upgrade Best Practices

Use Service Contracts

// Recommended — service contract (stable API)
public function __construct(
    private readonly \Magento\Quote\Api\CartRepositoryInterface $cartRepository
) {}

// Avoid — model direct (internal implementation)
public function __construct(
    private readonly \Magento\Quote\Model\QuoteFactory $quoteFactory
) {}

Plugin on Interfaces, Not Classes

<!-- Recommended — stable plugin target -->
<plugin name="vendor_plugin"
        type="Vendor\Module\Plugin\CartRepositoryPlugin"
        for="Magento\Quote\Api\CartRepositoryInterface"/>

<!-- Avoid — may break on internal refactoring -->
<plugin name="vendor_plugin"
        type="Vendor\Module\Plugin\QuotePlugin"
        for="Magento\Quote\Model\Quote"/>

Use Extension Attributes

<!-- etc/extension_attributes.xml -->
<extension_attributes for="Magento\Quote\Api\Data\CartInterface">
    <attribute code="custom_field" type="string"/>
</extension_attributes>

Disclaimer: This document covers the Magento_Quote module as found in magento/product-community-edition:2.4.7. Version-to-version change details could not be verified from source alone and have been removed. For version-specific changelogs, consult the official Adobe Commerce release notes.