> ## 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.

# Comissões (CLI)

> Comandos do ledger de comissões: listagem, aprovação, estorno e bônus avulsos.

O grupo `commissions` opera o ledger de [comissões](/docs/conceitos/comissoes). Cada lançamento tem status, valor (em centavos) e o afiliado de origem. Daqui você lista, inspeciona, aprova, estorna e cria bônus avulsos.

## Consulta

```bash theme={null}
# Listar (paginado, com filtros)
repass commissions list --affiliate-id aff_xxx --status pending --json

# Filtrar por ciclo de cobrança ou payout
repass commissions list --billing-cycle 6 --payout-id pay_xxx --json

# Buscar
repass commissions get comm_xxx --json
```

```text repass commissions list --status pending theme={null}
id        affiliateId  type      status   amountCents  occurredAt
--------  -----------  --------  -------  -----------  ------------------------
comm_01   aff_xxx      standard  pending  9990         2026-06-13T12:00:00.000Z
```

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

## Ações de estado

```bash theme={null}
repass commissions approve comm_xxx                                   # libera a comissão para pagamento
repass commissions void comm_xxx --data '{"reason":"ajuste"}' --yes   # estorna com motivo
```

<Warning>
  `commissions void` é `destructive`: não há "reverter estorno" no registry. Rode `commissions get comm_xxx` antes para conferir valor/afiliado. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).
</Warning>

## Bônus avulso

`create-bonus` registra uma comissão fora do fluxo de conversão, útil para premiações de campanha. O valor vai em centavos.

```bash theme={null}
repass commissions create-bonus --data '{
  "affiliateId": "aff_xxx",
  "amountCents": 5000,
  "description": "Bônus de campanha de junho"
}'
```

<Note>
  Para o schema completo de cada corpo (status possíveis, formato dos valores e filtros) e os campos dos objetos retornados, consulte a página SDK equivalente ([Commissions](/docs/sdk/recursos/commissions)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Comissões](/docs/conceitos/comissoes).
</Note>