Cupons (CLI) - Repass

O grupo coupons gerencia cupons: emissão por afiliado, listagem, sincronização com o gateway de pagamento e desativação. A emissão é escopada por afiliado, pelo comando issue.

Cupom

# Emitir (escopado pelo afiliado): desconto percentual
repass coupons issue aff_xxx --data '{"code":"MARIA15","discountType":"percentage","discountValue":15}'

# Emitir: desconto de valor fixo, em centavos
repass coupons issue aff_xxx --data '{"code":"MARIA10OFF","discountType":"fixed","discountValue":1990}'

# Listar (paginado, com filtros)
repass coupons list --program-id prog_xxx --status active --json

# Buscar
repass coupons get coup_xxx

repass coupons list --status active

id        code       discountType  discountValue  status  affiliateId
--------  ---------  ------------  -------------  ------  -----------
coup_01   MARIA15    percentage    15             active  aff_xxx

coupons list é paginado. Veja Paginação para --all e cursores.

Sincronização e ciclo de vida

repass coupons resync coup_xxx        # re-sincroniza com o gateway de pagamento
repass coupons deactivate coup_xxx    # desativa o cupom (para de gerar descontos)

coupons deactivate é destructive: não há reativação no registry. Rode coupons get coup_xxx antes para confirmar qual cupom. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

repass coupons deactivate coup_xxx --yes

Para o schema completo de cada corpo (tipos de desconto, valores, status de sincronização etc.) e os campos dos objetos retornados, consulte a página SDK equivalente (Coupons) e a Referência da API. As regras de negócio estão em Links e cupons.