Cupom de desconto delivery: 3 tipos, validação no servidor

Os três tipos de cupom no painel

Ao criar o cupom, você escolhe o público: isso define quando ele pode ser usado:

• Código: qualquer cliente que digitar o código no fechamento. Use para promoções sazonais, indicação, divulgação.
• Primeira compra: só vale para cliente que nunca teve pedido entregue. O sistema confere o histórico do telefone (hash E.164) e o status "entregue".
• Pós-venda: só vale para cliente que já tem pelo menos um pedido com status "entregue". O sistema confere se existe pedido entregue para aquele telefone.

Fixo ou porcentagem: você define o valor

Tipo "fixo": desconto em centavos (ex.: R$ 10,00 = 1000 centavos). Tipo "porcentagem": porcentagem inteira (ex.: 15% = 15). O desconto nunca passa do subtotal dos itens; taxa de entrega e adicionais não entram no cálculo.

Quatro controles que todo cupom tem

Ao criar o cupom, o painel exige:

• Mínimo do pedido (em centavos): o cupom só aplica se o subtotal dos itens for maior ou igual. Evita cupom de R$ 20,00 em pedido de R$ 15,00.
• Limite de usos total: quantas vezes o cupom pode ser usado no total (ex.: 100). Quando atinge, o cupom para de ser aceito.
• Público (código / primeira compra / pós-venda): define quem pode usar.
• Valor (fixo ou porcentagem): o desconto em si.

Validação no servidor: sem brecha no navegador

O cliente digita o código no fechamento. O pedido vai para o servidor, que confere: cupom ativo? usos < limite? expirou? público certo? pedido ≥ mínimo? Se qualquer um falha, o pedido volta com o erro no campo do código. O cliente nunca vê a lógica de validação; ela roda no servidor.

O desconto, a taxa e o total são recalculados no servidor a cada pedido. Se o valor enviado não bate com a regra cadastrada, o pedido volta com o erro no campo certo. Valor alterado no navegador não passa.

Expiração e limite de usos

Você pode definir data de expiração (opcional). O cupom para de ser aceito no fechamento do pedido no dia seguinte à data. O histórico de quem já usou continua no painel.

Quando o limite de usos é atingido, o cupom para de ser aceito imediatamente. O cliente recebe um aviso no campo do código. O histórico de quem já usou continua no painel.

Ativar e desativar na hora

Basta desativar o cupom no painel e ele deixa de ser aceito imediatamente, sem apagar os usos já registrados. Para reativar, ligue o interruptor novamente.