Envio de Carrinho

Endpoint para envio dos dados de um pedido feito na loja que será finalizado no checkout payhow

POST https://api.payhow.com.br/api/v1/ecommerce/external/cart

Headers

Name	Type	Description
Accept*	String	application/json
Content-Type*	String	application/json

Descrição do body JSON da requisição

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

Items

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

{
    "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 protected]",
        "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

{
    "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.