> For the complete documentation index, see [llms.txt](https://docs.payhow.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payhow.com.br/1.-fluxo-de-carrinho/envio-de-carrinho.md).

# 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. |