API · Coupons

Crie cupons de desconto que convertem

Black Friday, primeira compra, recuperação de carrinho. Crie cupons de desconto e os aplique no checkout com poucas linhas de código.

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 é REST, simples e bem documentada. 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
terminal
curl -X POST https://api.abacatepay.com/v1/coupons/create \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "BLACKFRIDAY",
    "discountType": "PERCENT",
    "discountValue": 30,
    "maxUses": 1000
  }'

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.

Lance sua próxima campanha

Crie sua conta e configure cupons em minutos para a próxima promoção.