EcomDocs
POSTCupons & Cashback

Criar regra de cashback

Cria uma regra de cashback (percentual creditado na carteira do cliente).

POST/cashbacks
AutenticaçãoPainel admin

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

Corpo da requisição

  • percentualnumberobrigatório

    Percentual de cashback.

  • ativobooleanopcional

    Liga/desliga a regra.

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/cashbacks" \
  -b cookies.txt -H "Content-Type: application/json" \
  -d '{"percentual":5,"ativo":true}'

Resposta201

200 OK
{ "success": true, "data": { "id": "cb_2", "percentual": 5 } }

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."
}
AnteriorListar regras de cashbackPróximoCarteira / saldo