Aplicar um desconto a um pedido
POST/v1/orders/:id/discounts
Aplica um desconto a um pedido e o retorna com os totais recalculados.
Os descontos aplicados aqui são manuais: você decide o valor ou o percentual. Descontos de cupom são resolvidos pela loja virtual, que conhece as regras do cupom, e não são criados por este endpoint.
Um pedido pode ter vários descontos; eles se somam.
Somente pedidos criados pela API podem ser alterados aqui. Um pedido feito na loja virtual, no POS ou em um food app pertence a esse canal e responde 422 order_not_modifiable.
Escopo necessário: orders:write
Request
Responses
- 201
- 401
- 403
- 404
- 422
O pedido com o desconto aplicado.
Não autenticado — a requisição não possui uma credencial, ou o token Bearer / API key é inválido, expirou ou foi revogado.
Escopo insuficiente — a credencial está autenticada, mas não possui um escopo exigido pelo endpoint.
Não encontrado — nenhum recurso corresponde ao id no caminho (ou ele pertence a outra empresa).
Falha de validação — o corpo da requisição falhou na validação do schema. errors[] lista todos os campos com problema.