Cupons
Gerar Cupom
Gerar um novo cupom para um cliente
POST
Gerar cupom
Gerar Cupom
Gera um cupom para um cliente da empresa autenticada. O request sempre exigeclient_id; product_id e points_amount são opcionais.
Comportamento atual
- a rota aceita
X-Idempotency-Keypara retry seguro - quando
product_idé enviado, o produto precisa pertencer à empresa e estar ativo - o response model atual retorna
uid,status,product_name,valor,expires_atecreated_at - na resposta imediata de criação,
product_namepode virnull; para consultar o nome enriquecido do produto, use a rota de busca do cupom - o status atual retornado pelo backend é serializado como
ativo - no uso esperado, envie
points_amountouproduct_id
Exemplo de resposta
Exemplo de request com idempotência
Status comuns
201cupom criado com sucesso400falha de geração ou recurso inválido para a empresa401API Key inválida ou revogada403plano semapi_access422header ou body inválidos429limite global da API pública excedido
Body
application/json
Gerar cupom

