• Documentation >
• Commerce >
• Cart >
• Cart API

Cart API

Cart REST API

To learn how to manage carts with the REST API, see the REST API reference.

To get carts and work with them, use the Ibexa\Contracts\Cart\CartServiceInterface interface.

CartService uses two storage methods and handles switching between storages:

• carts of registered users use database-based storage
• anonymous user carts are stored in the PHP session

From the developer's perspective, carts and entries are referenced with a UUID identifier.

Get single cart by identifier

To access a single cart, use the CartServiceInterface::getCart method:

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $output->writeln($cart->getName());

Get multiple carts

To fetch multiple carts, use the CartServiceInterface::findCarts method. It follows the same search Query pattern as other APIs:

use Ibexa\Contracts\Cart\Value\CartQuery;

// ...

        $cartQuery = new CartQuery();
        $cartQuery->setOwnerId(14); // carts created by User ID: 14
        $cartQuery->setLimit(20); // fetch 20 carts

        $cartsList = $this->cartService->findCarts($cartQuery);

        $cartsList->getCarts(); // array of CartInterface objects
        $cartsList->getTotalCount(); // number of returned carts

Create cart

To create a cart, use the CartServiceInterface::createCart method and provide it with Ibexa\Contracts\Cart\Value\CartCreateStruct that contains metadata (name, currency, owner):

use Ibexa\Contracts\Cart\Value\CartCreateStruct;

// ...

        $cartCreateStruct = new CartCreateStruct(
            'Default cart',
            $currency // Ibexa\Contracts\ProductCatalog\Values\CurrencyInterface
        );

        $cart = $this->cartService->createCart($cartCreateStruct);

        $output->writeln($cart->getName()); // prints 'Default cart' to the console

Update cart metadata

You can update cart metadata after the cart is created. You could do it to support a scenario when, for example, the user changes a currency and the cart should recalculate all item prices to a new currency. To update cart metadata, use the CartServiceInterface::updateCartMetadata method:

use Ibexa\Contracts\Cart\Value\CartMetadataUpdateStruct;

// ...

        $cartUpdateMetadataStruct = new CartMetadataUpdateStruct();
        $cartUpdateMetadataStruct->setName('New name');
        $cartUpdateMetadataStruct->setCurrency($newCurrency);

        $updatedCart = $this->cartService->updateCartMetadata($cart, $cartUpdateMetadataStruct);

        $output->writeln($updatedCart->getName()); // prints 'New name' to the console

You can also use this method to change cart ownership:

use Ibexa\Contracts\Cart\Value\CartMetadataUpdateStruct;

// ...

$updateMetadataStruct = new CartMetadataUpdateStruct();
$updateMetadataStruct->setOwner($userService->loadUserByLogin('user'));

$cart = $cartService->updateCartMetadata($cart, $updateMetadataStruct);

Delete cart

To delete a cart permanently, use the CartServiceInterface::deleteCart method and pass the CartInterface object:

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $this->cartService->deleteCart($cart);

Empty cart

To remove all products from the cart in a single operation, use the CartServiceInterface::emptyCart method:

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $this->cartService->emptyCart($cart);

Check cart validity

Items in cart can become invalid, for example, when item price is unavailable in cart currency, or the product is no longer available. To prevent checking out a cart with invalid items, check cart validity first. To validate the cart, use the CartServiceInterface::validateCart method. Validation is done with help from the symfony/validator component, and the method returns a Symfony\Component\Validator\ConstraintViolationListInterface object.

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $violationList = $this->cartService->validateCart($cart); // Symfony\Component\Validator\ConstraintViolationListInterface

Add entry to cart

To add entries (products) to the cart, create an Ibexa\Contracts\Cart\Value\EntryAddStruct, where you specify the requested quantity of the product. Then pass it to the CartServiceInterface::addEntry method:

use Ibexa\Contracts\Cart\Value\EntryAddStruct;

// ...

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $entryAddStruct = new EntryAddStruct($product);
        $entryAddStruct->setQuantity(10);

        $cart = $this->cartService->addEntry($cart, $entryAddStruct);

        $entry = $cart->getEntries()->first();
        $output->writeln($entry->getProduct()->getName()); // prints product name to the console

Remove entry from cart

To remove an entry from the cart, use the CartServiceInterface::removeEntry method.

use Ibexa\Contracts\Cart\Value\EntryAddStruct;

// ...

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $entry = $cart->getEntries()->first();

        $cart = $this->cartService->removeEntry($cart, $entry); // updated Cart object

Update entry metadata

Entries have their own metadata, for example, quantity. To change entry metadata, use the CartServiceInterface::updateEntry method and provide it with Ibexa\Contracts\Cart\Value\EntryUpdateStruct.

use Ibexa\Contracts\Cart\Value\EntryUpdateStruct;

// ...

        $cart = $this->cartService->getCart('1844450e-61da-4814-8d82-9301a3df0054');

        $entry = $cart->getEntries()->first();

        $entryUpdateStruct = new EntryUpdateStruct(5);
        $entryUpdateStruct->setQuantity(10);

        $cart = $this->cartService->updateEntry(
            $cart,
            $entry,
            $entryUpdateStruct
        ); // updated Cart object