Cart
Represents a shopping cart that contains items from one or more stores, such as Amazon or Shopify. It is used to manage the shopping experience, track selected items, and store buyer information.
Fields
The unique identifier (ID) of the cart, used to reference and interact with the cart in subsequent API operations.
An array of Store objects (either AmazonStore or ShopifyStore), each representing a store with items in the cart. Each store object contains its own specific data, such as store name, cart lines, and offer information.
An object containing information about the buyer, such as first name, last name, email, phone, and address details. This information is used during the checkout process and for communication with the buyer.
The costs that the buyer will pay at checkout
If your cart only contains digital items, this will be false as there will be no shipping required.
Queries
Returns a Cart object by ID.
Mutations
createCart(input: CartCreateInput!)
Create a Cart with buyer identity details
updateCartItems(input: CartItemsUpdateInput!)
Updates only existing products in a Cart. Returns an error if prompted to update a non-existing product.
updateCartBuyerIdentity(input: CartBuyerIdentityUpdateInput!)
Updates buyer identity if not provided in createCart mutation
addCartItems(input: CartItemsAddInput!)
Adds only non-existing products in a Cart. Skips already existing products.
deleteCartItems(input: CartItemsDeleteInput!)
Removes existing products in a Cart. Returns an error if prompted to delete a non-existing product.
Note about expiration
Rye considers carts to be expired after 10 days. If you attempt an operation on an expired cart, you’ll receive an error message that looks like this:
{
"errors": [
{
"message": "Cart expired: someExpiredCartId",
"locations": [
{
"line": 2,
"column": 5
}
],
"path": [
"someOperationPath"
],
"extensions": {
"code": "CART_EXPIRED_ERROR"
}
}
],
"data": null
}
Related types
Was this page helpful?