---
updatedAt: 2025-11-13T21:17:13.000Z
agentTools:
  projectIndex: https://wakecommerce.readme.io/llms.txt
---

# CheckoutAddProduct

A *mutation CheckoutAddProduct* permite que um ou mais produtos sejam adicionados a um carrinho.

## Parâmetros

### `input`

| Argumento | Tipo                | Obrigatório | Descrição                                         |
| :-------- | :------------------ | :---------- | :------------------------------------------------ |
| id        | Uuid                | sim         | ID do carrinho onde serão adicionados os produtos |
| products  | array de *products* | sim         | Produtos a serem adicionados ao carrinho          |

### `products` (array)

| Argumento        | Tipo                     | Obrigatório | Descrição                              |
| :--------------- | :----------------------- | :---------- | :------------------------------------- |
| productVariantId | long                     | sim         | ID do variante do produto              |
| quantity         | integer                  | sim         | Quantidade do produto a ser adicionado |
| customization    | array de *customization* | não         | Personalizações do produto             |
| subscription     | *subscription*           | não         | Informações de assinatura              |

### `customization` (array)

| Argumento       | Tipo   | Obrigatório | Descrição               |
| :-------------- | :----- | :---------- | :---------------------- |
| customizationId | long   | sim         | ID da personalização    |
| value           | string | sim         | Valor da personalização |

### `subscription`

| Argumento           | Tipo    | Obrigatório | Descrição                       |
| :------------------ | :------ | :---------- | :------------------------------ |
| subscriptionGroupId | long    | sim         | ID do grupo de assinatura       |
| recurringTypeId     | integer | sim         | ID da recorrência da assinatura |

## Exemplo

Adição do produto de variante ID 5396 (bota) ao carrinho:

```graphql Add product to cart
mutation {
  checkoutAddProduct(input:{id:"e29a5316-ee1f-4c9c-9a58-429d1b16e7fb", products:[{
    productVariantId: 5396,
    quantity: 1
  }]}) {
    checkoutId
    url
    products {
      name
      productAttributes {
        name
        value
        type
      }
      listPrice
      price
      ajustedPrice
      productId
      productVariantId
      imageUrl
      quantity
    }
    shippingFee
    subtotal
    total
  }
}
```

<details>
<summary>Mostrar resposta</summary>
<br />

```json Add product to cart response
{
  "data": {
    "checkoutAddProduct": {
      "checkoutId": "e29a5316-ee1f-4c9c-9a58-429d1b16e7fb",
      "url": "https://lojacss.checkout.fbits.store/e29a5316-ee1f-4c9c-9a58-429d1b16e7fb",
      "products": [
        {
          "name": "Meia Compressão Running Kanxa 6102",
          "productAttributes": [
            {
              "name": "COR",
              "value": "Branco e Cinza",
              "type": 0
            },
            {
              "name": "Tamanho",
              "value": "39/43",
              "type": 0
            }
          ],
          "listPrice": 120,
          "price": 102,
          "ajustedPrice": 0,
          "productId": 280,
          "productVariantId": 5440,
          "imageUrl": "https://LojaCSS.fbitsstatic.net/img/p/5440/meia-compressao-running-kanxa-6102-280/5440.jpg?w=120&h=120",
          "quantity": 1
        },
        {
          "name": "Chuteira Campo Plakar Genova Couro Legítimo",
          "productAttributes": [
            {
              "name": "COR",
              "value": "Branco",
              "type": 0
            },
            {
              "name": "Tamanho",
              "value": "38",
              "type": 0
            }
          ],
          "listPrice": 300,
          "price": 212.5,
          "ajustedPrice": 0,
          "productId": 272,
          "productVariantId": 5459,
          "imageUrl": "https://LojaCSS.fbitsstatic.net/img/p/5458/chuteira-campo-plakar-genova-couro-legitimo-272/5458.jpg?w=120&h=120",
          "quantity": 1
        },
        {
          "name": "Bota Ultra Extreme II GTX Feminina",
          "productAttributes": [
            {
              "name": "COR",
              "value": "STEEPLEGRY/RADIANCEPURPLE",
              "type": 0
            },
            {
              "name": "Tamanho",
              "value": "34.5",
              "type": 0
            },
            {
              "name": "GENERO_GOOGLE",
              "value": "female",
              "type": 0
            },
            {
              "name": "IDADE_GOOGLE",
              "value": "adult",
              "type": 0
            }
          ],
          "listPrice": 29970,
          "price": 25474.5,
          "ajustedPrice": 0,
          "productId": 251,
          "productVariantId": 5396,
          "imageUrl": "https://LojaCSS.fbitsstatic.net/img/p/5395/bota-ultra-extreme-ii-gtx-feminina-251/5395.jpg?w=120&h=120",
          "quantity": 1
        },
        {
          "name": "Bola Adidas Euro Copa 2016",
          "productAttributes": [],
          "listPrice": 225,
          "price": 199.4,
          "ajustedPrice": 0,
          "productId": 282,
          "productVariantId": 5438,
          "imageUrl": "https://LojaCSS.fbitsstatic.net/img/p/5438/bola-adidas-euro-copa-2016-tio-282/5438.jpg?w=120&h=120",
          "quantity": 1
        }
      ],
      "shippingFee": 0,
      "subtotal": 25988.4,
      "total": 25788.4
    }
  }
}
```

</details>

### Produto(s) com personalização no carrinho

Abaixo temos um exemplo, para inserir produto(s) com personalização no carrinho:

Para obter a informação do campo *customizationId*, para inserção na mutation é necessário executar a query checkout,  para mais informações [clique aqui!](https://wakecommerce.readme.io/docs/storefront-api-checkout#produtos-com-personaliza%C3%A7%C3%A3o-no-carrinho)

```graphql Request
mutation {
  checkoutAddProduct(
    input: {
      id: "969ca571-5d72-49ed-a172-c460f6c00000"
      products: [
        {
          customizationId: "eyJQcm9kdXRvVmFyaWFudGVJZCI6MzQwLCJFbnRpdHkiOiJDaGVja291dFByb2R1Y3RJZCIsIklkIjoxNjEyNTI5fQ=="
          productVariantId: 123
          quantity: 1
        }
        {
          customizationId: "eyJQcm9kdXRvVmFyaWFudGVJZCI6NTQzOCwiRW50aXR5IjoiQ2hlY2tvdXRQcm9kdWN0SWQiLCJJZCI6MTYxMjUzMn0="
          productVariantId: 456
          quantity: 1
        }
      ]
    }
  ) {
    checkoutId
    products {
      name
      quantity
      productVariantId
      productId
      customization {
        id
        values {
          cost
          name
          value
        }
      }
    }
  }
}
```

<details>
<summary>Mostrar resposta</summary>
<br />

```json Response
{
  "data": {
    "checkoutAddProduct": {
      "checkoutId": "969ca571-5d72-49ed-a172-c460f6c00000",
      "products": [
        {
          "name": "Bola Adidas Euro Copa 2016",
          "quantity": 1,
          "productVariantId": 456,
          "productId": 282,
          "customization": {
            "id": "eyJQcm9kdXRvVmFyaWFudGVJZCI6NTQzOCwiRW50aXR5IjoiQ2hlY2tvdXRQcm9kdWN0SWQiLCJJZCI6MTYxMjUzMn0=",
            "values": [
              {
                "cost": 5,
                "name": "Nome",
                "value": "teste"
              }
            ]
          }
        },
        {
          "name": "Bola Adidas Euro Copa 2016",
          "quantity": 1,
          "productVariantId": 456,
          "productId": 282,
          "customization": {
            "id": "eyJQcm9kdXRvVmFyaWFudGVJZCI6NTQzOCwiRW50aXR5IjoiQ2hlY2tvdXRQcm9kdWN0SWQiLCJJZCI6MTYxMjUzMn0=",
            "values": [
              {
                "cost": 5,
                "name": "Nome",
                "value": "teste"
              }
            ]
          }
        }
      ]
    }
  }
}
```

</details>

### Metadados na inserção de produtos no carrinho

Abaixo temos um exemplo, para incluir metadados na inserção de produto(s) no carrinho:

```graphql Request
mutation {
  checkoutAddProduct(
    input: {
      id: "3fabf44c-4335-4d3b-a0f5-f09af4e6ac84"
      products:[{
        productVariantId: 123456
        quantity: 1
        metadata: [{ key: "AB", value: "12" }]
      }]
      }
  ) {
    checkoutId
    products {
      quantity
      productVariantId
      metadata {
        key
        value
      }
    }
  }
}
```

<details>
<summary>Mostrar resposta</summary>
<br />

```json Response
{
  "data": {
    "checkoutAddProduct": {
      "checkoutId": "3fabf44c-4335-4d3b-a0f5-f09af4e6ac84",
      "products": [
        {
          "quantity": 1,
          "productVariantId": 123456,
          "metadata": [
            {
              "key": "AB",
              "value": "12"
            }
          ]
        }
      ]
    }
  }
}
```

</details>