EcomDocs
POSTCupons & Cashback

Criar cupom

Cria um cupom de desconto (percentual ou fixo, com regras de validade).

POST/coupons
AutenticaçãoPainel admin

Cookie de sessão do painel (ecom_token) + permissão RBAC.

Corpo da requisição

  • codigostringobrigatório

    Código do cupom.

  • tipostringobrigatório

    percentual | fixo.

  • valornumberobrigatório

    Valor do desconto (% ou centavos).

Cabeçalhos

  • Cookiestringobrigatório

    Cookie de sessão do painel: ecom_token=<jwt> (obtido em POST /auth/login).

Requisição

curl -X POST "https://api.ecomplataforma.com.br/coupons" \
  -b cookies.txt -H "Content-Type: application/json" \
  -d '{"codigo":"BEMVINDO10","tipo":"percentual","valor":10}'

Resposta201

200 OK
{ "success": true, "data": { "id": "cp_2", "codigo": "BEMVINDO10" } }

Respostas de erro

401Não autenticado
401 Não autenticado
{
  "success": false,
  "error": "Sessão ausente ou expirada."
}
403Sem permissão
403 Sem permissão
{
  "success": false,
  "error": "Você não tem permissão para acessar este recurso."
}
422Falha de validação
422 Falha de validação
{
  "success": false,
  "error": "O campo 'email' é obrigatório."
}
AnteriorObter cupomPróximoAtualizar cupom