EcomDocs
POSTStorefront público

Validar cupom (storefront)

Valida um cupom antes do checkout e devolve o desconto (sem auth). O servidor revalida no POST /store/checkout.

POST/public/coupons/validate
AutenticaçãoPúblico

Aberto — não requer autenticação.

Corpo da requisição

  • codigostringobrigatório

    Código do cupom.

  • subtotalCentsintegeropcional

    Subtotal do carrinho.

Requisição

curl -X POST "https://api.ecomplataforma.com.br/public/coupons/validate" \
  -H "Content-Type: application/json" \
  -d '{"codigo":"BEMVINDO10","subtotalCents":15980}'

Resposta200

200 OK
{ "success": true, "data": { "valido": true, "descontoCents": 1598 } }

Respostas de erro

422Falha de validação
422 Falha de validação
{
  "success": false,
  "error": "O campo 'email' é obrigatório."
}
AnteriorCotar frete (storefront)PróximoSimular parcelamento (storefront)