Step 2. Create an empty cart
GraphQL checkout tutorial
The procedure for creating a cart varies for logged-in customers and guests.
The customerCart
query returns the active cart for the logged-in customer. If the cart does not exist, the query creates one. You must specify the customer’s authorization token in the headers. Otherwise, the query fails. “Get customer authorization token” describes describes these tokens.
For guests, use the createEmptyCart
mutation to create an empty shopping cart and generate a cart ID for a guest user. If the guest later logs in as a customer, use the mergeCarts
mutation to transfer the contents of the guest cart into the customer’s cart.
Create a customer cart
The customer created in the previous step does not have an active cart. The following query creates an empty cart and returns the cart ID. You must specify the customer’s authorization token in the headers of the call.
Request:
1
2
3
4
5
{
customerCart{
id
}
}
Response:
1
2
3
4
5
6
7
{
"data": {
"customerCart": {
"id": "pXVxnNg4PFcK1lD60O5evqF7f4SkiRR1"
}
}
}
In the subsequent tutorial steps, the unique shopping cart identifier pXVxnNg4PFcK1lD60O5evqF7f4SkiRR1
will be listed as { CART_ID }
.
Create a guest cart
The following example creates an empty cart for a guest. Do not include an authorization token on any call made on behalf of a guest.
Request:
1
2
3
mutation {
createEmptyCart
}
Response:
1
2
3
4
5
{
"data": {
"createEmptyCart": "A7jCcOmUjjCh7MxDIzu1SeqdqETqEa5h"
}
}
In the subsequent tutorial steps, the unique shopping cart identifier A7jCcOmUjjCh7MxDIzu1SeqdqETqEa5h
will be listed as { CART_ID }
.
Verify this step
There are no additional verification steps. The value of id
is not displayed on the website or in the Magento Admin.