Criar um pedido
POST
/v1/orders
Cria um novo pedido na Appmax. Um pedido deve estar sempre vinculado a um cliente previamente criado.
Pré-requisito
Para criar um pedido, você precisa ter o customer_id do cliente. Caso
ainda não tenha, veja
Criar ou atualizar cliente.
Armazene o order_id retornado, pois ele será necessário para efetuar o
pagamento ou consultar o status do pedido. Para entender como o valor
total é calculado, veja
Cálculo do valor total.
Autorizações
bearerAuth
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Tipo
HTTP (bearer)
Corpo da Requisição
application/json
JSON "customer_id": 29, "products_value": 12300, "discount_value": 0, "shipping_value": 3999, "products": [ { "sku": "9000010", "name": "Livro de receitas", "quantity": 1, "unit_value": 12300, "type": "digital" } ]
{
}
Respostas
Pedido criado com sucesso. O pedido é criado com status pendente até que o pagamento seja processado.
application/json
JSON "data": { "order": { "id": 1, "status": "pendente" } }
{
}
POST
/v1/orders