Vouchers

Um voucher é um código de desconto que o cliente digita no checkout (por exemplo BEMVINDO10). Ele é diferente de uma promoção (regra automática, sem código) e de um vale-presente (saldo pré-pago). Cada voucher tem um tipo de desconto, regras de uso e um prazo.

Como funciona

1. Crie um voucher ou gere vários de uma vez.
2. O cliente digita o código no checkout. A plataforma valida: ativo, dentro do prazo, pedido mínimo, limite total e limite por cliente.
3. Cada uso vira uma linha em usos e soma em used_count.

Tipos (type)

Regras de uso

Endpoints

Erros comuns

• Percentual em pontos-base. 10 é 0,10%, não 10%. Para 10% envie 1000.
• Código repetido. Volta 400 voucher code 'X' already exists.
• Desconto que derruba a margem. Se o Protetor de Margem estiver ativo e o desconto levar produtos abaixo do piso, a criação volta 422 com o detalhamento.
• Apagar um voucher já usado achando que apaga o histórico. Apagar é definitivo; prefira is_active: false.
• Gerar mais de 1000 de uma vez. Volta 400; o limite por chamada é 1000.
• Esperar que o filtro status aceite qualquer palavra. Só active, expired, inactive e exhausted filtram; outro valor é ignorado.

Próximos passos