# Envio de Carrinho

<mark style="color:green;">`POST`</mark> `https://api.payhow.com.br/api/v1/ecommerce/external/cart`

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| Accept<mark style="color:red;">\*</mark>       | String | application/json |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json |

### &#x20;<a href="#descricao-do-body-json-da-requisicao" id="descricao-do-body-json-da-requisicao"></a>

### Descrição do body JSON da requisição <a href="#descricao-do-body-json-da-requisicao" id="descricao-do-body-json-da-requisicao"></a>

| Chave         | Tipo   | Descrição                                                                                                                                                                           |
| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| access\_token | string | Gerado na integração da API (obrigatório)                                                                                                                                           |
| order\_id     | string | id de pedido da loja do usuário caso já tenha sido criando antes de ser redirecionado para o checkout, caso seja enviado, voltara no callback após finalização da compra (opcional) |
| cart          | string | Id do carrinho gerado pela Payhow, por padrão irá vazio na criação do carrinho, só será preenchido quando for uma atualização de um carrinho existente.                             |
| merchant\_url | string | URL da loja, mesma inserida na integração da API                                                                                                                                    |

#### &#x20;I**tems**

| Chave              | Tipo   | Descrição                                                            |
| ------------------ | ------ | -------------------------------------------------------------------- |
| id                 | int    | Id do produto dentro da loja (obrigatório)                           |
| sku                | string | código único de identificação atribuído a um produto (obrigatório)   |
| name               | string | Nome do produto (obrigatório)                                        |
| price              | string | Preço unitário do produto sem ponto separando centavos (obrigatório) |
| width              | string | largura (obrigatório)                                                |
| height             | string | altura (obrigatório)                                                 |
| lenght             | string | comprimento (obrigatório)                                            |
| weight             | string | peso (obrigatório)                                                   |
| images.src         | string | caminho da imagem do produto (obrigatório)                           |
| images.name        | string | nome da imagem com extensão (obrigatório)                            |
| quantity           | int    | quantidade do produto (obrigatório)                                  |
| description        | string | descrição do produto (opcional)                                      |
| shipping\_taxable  | string | não utilizado no momento, enviar fixo "true" (obrigatorio)           |
| shipping\_required | string | não utilizado no momento, enviar fixo "true" (obrigatorio)           |

#### **User**

| Chave            | Tipo   | Descrição                           |
| ---------------- | ------ | ----------------------------------- |
| user\_address\_1 | string | endereço (obrigatório)              |
| user\_address\_2 | string | complemento (opcional)              |
| user\_city       | string | Cidade do usuário (obrigatório)     |
| user\_country    | string | País do usuário (obrigatório)       |
| user\_email      | string | e-mail do usuário (obrigatório)     |
| user\_firstname  | string | Nome (obrigatório)                  |
| user\_id         | string | id do usuário na loja (obrigatório) |
| user\_lastname   | string | Sobrenome (obrigatório)             |
| user\_login      | string | Nome Login usuário (obrigatório)    |
| user\_nicename   | string | Apelido (obrigatório)               |
| user\_postcode   | string | CEP Usuário (Obrigatório)           |
| user\_state      | string | Estado Usuário (Obrigatório)        |

Obs: Todos os parâmetros que forem opcionais, enviar aspas vazias ("")

### **Exemplo de Requisição**

```json
{
    "access_token": "aOGND2Z9uNnQIih7UeyuUtWavC1IZwsMn6UImXRS",
    "order_id" : "102030405099",
    "cart": "ec_615caa5360376",
    "merchant_url" : "https://exemploeccommerce.com.br",
    "items":[{
    "id": 12705,
    "sku": "4960",
    "name": "Blazer Suede - P, Off",
    "price": "14900",
    "width": "18.0",
    "height": "3.0",
    "length": "23.0",
    "weight": "0.332",
    "images": [
     {
          "src": "https://exemploecommerce.com.br/product/56/image/product56.jpg",
          "name": "product56.jpg"
        }
    ],    
    "quantity": 1,
    "description": "",
    "shipping_taxable": true,
    "shipping_required": true
    },
    {
    "id": 12507,
    "sku": "5006",
    "name": "Vestido tule Lara - P/M, Roxo",
    "price": "18900",
    "width": "18.0",
    "height": "3.0",
    "images": [
        {
        "src": "https://exemploecommerce.com.br/product/68/image/product68.jpg",
        "name": "product68.jpg"
        }
    ],
    "length": "23.0",
    "weight": "0.390",
    "quantity": 1,
    "description": "",
    "shipping_taxable": true,
    "shipping_required": true
    }],
    "user" : {
        "user_address_1": "Rua das palmeiras",
        "user_address_2": "bla bla",
        "user_city": "Sorocaba",
        "user_country": "BR",        
        "user_email" : "email@email.com",
        "user_firstname" : "Felipe",
        "user_id" : "1",
        "user_lastname" : "Martins",
        "user_login" : "lionsoft",
        "user_nicename" : "lionsoft",
        "user_postcode" : "18051-868",
        "user_state" : "SP"
    }
  }
```

### **Exemplo de Resposta da Requisição**

```json
{
    "checkout_url": "https://checkout.payhow.com.br/?ec_616845a081528",
    "cart": "ec_616845a081528"
}
```

### **Descrição do JSON de Resposta**

| Chave             | Tipo   | Descrição                                                                                                       |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------------- |
| **checkout\_url** | string | url que redireciona para o checkout Payhow com os dados do carrinho criado                                      |
| cart              | string | id do carrinho criado, pode ser utilizado no envio do carrinho quando for apenas um update dos dados do pedido. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payhow.com.br/1.-fluxo-de-carrinho/envio-de-carrinho.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.