Percentual ou valor fixo
10% off, R$50 fixo, frete grátis. Configure regras como o cliente espera e aplique no checkout.
Controle de uso
Limite por cliente, número total de usos, data de validade. Cada cupom tem regras claras.
Ativar/desativar em segundos
Pausar uma promoção quando bateu a meta? Toggle e pronto. Sem precisar avisar o time todo.
Endpoints
Tudo o que você precisa em poucas chamadas
A API de Coupons é baseada em intenção: cada rota diz o que faz. Comece em minutos, escale sem dor.
- POST
/coupons/createCria um novo cupom de desconto - GET
/coupons/listLista todos os cupons - GET
/coupons/getBusca um cupom pelo ID - POST
/coupons/toggleAtiva ou desativa um cupom - POST
/coupons/deleteRemove um cupom
curl -X POST https://api.abacatepay.com/v2/coupons/create \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"code": "PROMO20",
"discountKind": "FIXED",
"discount": 2000,
"maxRedeems": 50
}'Dúvidas sobre Coupons?
As respostas mais frequentes sobre como usar a API de Coupons.
Posso limitar o cupom a um cliente específico?
Sim. Use o campo de restrição por cliente pra liberar o desconto só pra IDs específicos da sua base.
Como o cliente aplica o cupom?
No checkout hospedado, ele insere o código no campo de cupom. Em integrações customizadas, você passa o código na criação do checkout.
Posso ter vários cupons ativos ao mesmo tempo?
Pode, sem limite. Cada cupom tem suas próprias regras de uso e validade.
O cupom funciona em assinaturas?
Funciona. Você pode aplicar desconto na primeira fatura ou nas X primeiras, conforme configurado.
Sem mensalidade. Aprovação não leva semanas.
Lance sua próxima campanha
Crie sua conta e configure cupons em minutos para a próxima promoção.
Sem mensalidade. Aprovação não leva semanas.
