addVirtualProductsToCart mutation

A virtual product represents a saleable item that is not physical, such as a membership, service, warranty, or subscription. Virtual products do not need to be shipped or downloaded, nor do they require stock management.

The addVirtualProductsToCart mutation allows you to add multiple virtual products to the cart at the same time, but you cannot add other product types with this mutation. To add a virtual product to a cart, you must provide the cart ID, the SKU, and the quantity. You can also optionally provide customizable options.

Syntax

1
2
3
4
5
6
7
mutation {
  addVirtualProductsToCart(
    input: AddVirtualProductsToCartInput
  ) {
    AddVirtualProductsToCartOutput
  }
}

Example usage

The Luma sample data does not include any virtual products. The following example requires that you create a virtual product with the sku value of Membership-Gold with a price of $49.99.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
mutation {
  addVirtualProductsToCart(
    input: {
      cart_id: "IeTUiU0oCXjm0uRqGCOuhQ2AuQatogjG",
      cart_items: [
        {
          data: {
            quantity: 1
            sku: "Membership-Gold"
          }
        }
       ]
    }
  ) {
    cart {
      items {
        product {
          name
        }
        quantity
      }
      prices {
        grand_total {
          value
          currency
        }
      }
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "data": {
    "addVirtualProductsToCart": {
      "cart": {
        "items": [
          {
            "product": {
              "name": "Gold Membership"
            },
            "quantity": 1
          }
        ],
        "prices": {
          "grand_total": {
            "value": 49.99,
            "currency": "USD"
          }
        }
      }
    }
  }
}

Input attributes

The top-level AddVirtualProductsToCartInput object is listed first. All child objects are listed in alphabetical order.

AddVirtualProductsToCartInput object

The AddVirtualProductsToCartInput object must contain the following attributes:

CartItemInput object

The CartItemInput object must contain the following attributes:

CustomizableOptionInput object

The CustomizableOptionInput object must contain the following attributes:

VirtualProductCartItemInput object

The VirtualProductCartItemInput object must contain the following attributes:

Output attributes

The AddVirtualProductsToCartOutput object contains the Cart object.

Cart object

Cart query output provides more information about the Cart object.

Errors