Guias
Emita cupons dinâmicos
Gere códigos individuais, consulte emissões e revogue cupons dinâmicos com idempotência e validade controlada.
Nesta página
Cupons dinâmicos geram códigos individuais a partir de uma oferta configurada no painel. Eles são úteis quando cada consumidor, pedido ou campanha precisa de um código rastreável.
Crie uma emissão
Use POST /v1/coupon/issuances com o identificador da oferta, uma referência externa, o sujeito, o carrinho e a validade desejada.
A operação exige Idempotency-Key. Reutilize a mesma chave apenas para repetir exatamente a mesma intenção.
Consulte o estado
Use GET /v1/coupon/issuances/{issuance_id}. Uma emissão pode estar ativa, consumida, revogada ou expirada.
Revogue um código
Use POST /v1/coupon/issuances/{issuance_id}/revocations. A revogação é idempotente e impede o uso futuro sem apagar o histórico.
Guarde a relação externa
Persista o identificador da emissão e a referência usada pelo seu sistema. Isso permite reconciliar timeouts e responder a eventos posteriores sem emitir outro código por engano.