cart.create

This method is used to create a Cart.

Version

v1

Arguments

This method has the path /cart/<version>/cart.create and follows the MicroBase API calling conventions.

Argument Required Type Example Description
customerId yes String A21afRq1 The User identifier. Mandatory in the Cart, defaults to 'ANON'.
currency yes String USD Cart Currency. Mandatory in the Cart, defaults to a config property.
country no String US Country to be asociated to the Cart. Defaults to a config property.
channel no String WEB Dsitribution Channel to be asociated to the Cart. Defaults to a config property.

Response

Returns a Cart object:

{
  "ok": true,
  "cart": {
    "id": "H19PRsec",
    "customerId": "ANON",
    "expirationTime": "2016-08-23T15:16:50.407Z",
    "tax": 0,
    "beforeTax": 0,
    "items": []
  }
}

Errors

Expected errors that this method could return. Some errors return additional data.

Error Data Description
validation_error The data causing the error Some validation error
invalid_country The country code The country code is invalid
invalid_currency The currency code The currency code is not invalid

Example

curl --request POST \
  --url http://localhost:3000/services/cart/v1/cart.create \
  --header 'authorization: Bearer xxxxx...' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{}'