Add Item to Cart

ShopSynch.2/7/25Less than 1 minute

Add Item to Cart

Description

The Add Item to Cart API allows customers to add products to their cart.

Authenticated Users: Must provide a valid JWT token.
Guest Users: Must provide a sessionId to track the cart (Generate Session Id).
The X-MerchantApiKey header is mandatory for all requests.
The X-SessionId header is mandatory for adding item to cart for none authenticated customers.

Endpoint

POST /v1/carts/add

Required Headers

{
  "Authorization": "Bearer JWT_TOKEN", // For authenticated users
  "X-MerchantApiKey": "MERCHANT_API_KEY",
  "Content-Type": "application/json"
}

📥 Request Body

Parameter	Type	Required	Description
`productId`	string	Yes	The unique ID of the product.
`variationId`	string	No	The variation ID of the product, if applicable.
`variationPriceId`	string	No	The variation price ID, if applicable.
`quantity`	integer	Yes	The number of items to add. Must be at least 1.
`sessionId`	string	Yes (for guest users)	The session ID for tracking guest user carts.

Example API Call (Fetch or Axios)

fetch('https://api.shopsynch.com/v1/carts/add', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer JWT_TOKEN',
    'X-MerchantApiKey': 'MERCHANT_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    productId: "679f8f5a3b5f2173201c2582",
    quantity: 1,
    sessionId: "ee5bfa88-56a2-4551-ae1d-d753984ae1d9"
  })
})
.then(response => response.json())
.then(data => console.log(data));

📤 Sample 200 Response (Success)

{
    "data": {
        "id": "67a6261a320f3f7368dfec35",
        "productId": "679f8f5a3b5f2173201c2582",
        "variationId": null,
        "variationPriceId": null,
        "userId": null,
        "name": "LG 45 Inch Signature OLed R Class Rollable 4K Smart Tv",
        "image": "https://m.media-amazon.com/images/I/51ObdXZHQTL._AC_UY1100_.jpg",
        "price": 20000.0,
        "newPrice": 16200.0,
        "ramSize": null,
        "size": "Large",
        "sku": null,
        "quantityInStock": 13,
        "discount": 10.0,
        "color": "RedBlack",
        "rating": null,
        "sessionId": "ee5bfa88-56a2-4551-ae1d-d753984ae1d9",
        "quantity": 1,
        "storage": null
    },
    "message": "Success",
    "status": true
}