Carts

This API is used to submit Add to Cart Events.

POST

/ecommactivity/addtocart

REQUEST ELEMENTS

customer.accountId	String	No	Unique ID generated for the customer
customer.phone	String	No	Phone number of the customer
customer.email	String	No	Email ID of the customer
customer.first	String	No	First name of the customer
customer.last	String	No	Last name of the customer
items.type	String	Yes	Product/Service
items.sku	String	Yes	SKU of the Item
items.qty	String	Yes	Quantity of the Item
items.name	String	Yes	Name of the Item
items.currency	String	No	Currency of the Item Price
items.unitPrice	String	No	Unit Price of the Item
ecommerce.userAgent	String	No	User Agent of the customer
ecommerce.browserIdentifier	String	No	A unique custom Browser ID
ecommerce.time	String	Yes	Time of the request
ecommerce.sourceUrl	String	No	Url of the request
ecommerce.custom.fbp	String	No	_fbp value retrieved from browser
ecommerce.custom.fbc	String	No	_fbc value retrieved from browser

Error messages

Error Code	Error Message
1004	The following field is not unique
1006	The following fields are invalid
1002	Fields are empty

SAMPLE JSON PAYLOAD

{
  "customer": {
    "first": "First name",
    "last": "Last name",
    "email": "email",
    "phone": "phone"
  },
  "items": [
    {
      "type": "Product",
      "sku": "sku000",
      "qty": "1",
      "name": "Product name",
      "currency": "AED",
      "unitPrice": "10"
    }
  ],
  "ecommerce": {
    "ip": "199.199.199.199",
    "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
    "browserIdentifier": "6726e88e-b74a-11ed-afa1-0242ac120002",
    "time": "1677576591785",
    "sourceUrl": "https://www.worldshop.com/products/product1",
    "custom": {
      "fbp": "fb pixel data",
      "fbc": "fb click id data"
    }
  }


}