> ## Documentation Index
> Fetch the complete documentation index at: https://userepass.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cupons (CLI)

> Comandos de cupons de afiliado: emissão, listagem, sincronização e desativação.

O grupo `coupons` gerencia [cupons](/docs/conceitos/links-e-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

```bash theme={null}
# 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
```

```text repass coupons list --status active theme={null}
id        code       discountType  discountValue  status  affiliateId
--------  ---------  ------------  -------------  ------  -----------
coup_01   MARIA15    percentage    15             active  aff_xxx
```

`coupons list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

## Sincronização e ciclo de vida

```bash theme={null}
repass coupons resync coup_xxx        # re-sincroniza com o gateway de pagamento
repass coupons deactivate coup_xxx    # desativa o cupom (para de gerar descontos)
```

<Warning>
  `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](/docs/cli/convencoes#modelo-de-risco)).

  ```bash theme={null}
  repass coupons deactivate coup_xxx --yes
  ```
</Warning>

<Note>
  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](/docs/sdk/recursos/coupons)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Links e cupons](/docs/conceitos/links-e-cupons).
</Note>