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

# Commissions

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

`repass.commissions` é 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

```ts theme={null}
// Listar (RepassPage, filtros opcionais por afiliado e status)
await repass.commissions.list({ affiliate_id: "aff_…", status: "pending" }); // → RepassPage<Commission>

// Buscar uma comissão
await repass.commissions.retrieve("comm_…"); // → Commission
```

## Ações de estado

```ts theme={null}
await repass.commissions.approve("comm_…");              // → Commission (libera a comissão para pagamento)
await repass.commissions.void("comm_…", { reason: "ajuste" }); // → Commission (estorna com motivo)
```

## Bônus avulso

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

```ts theme={null}
await repass.commissions.createBonus({
  affiliateId: "aff_…",
  amountCents: 5000, // R$ 50,00
  description: "bônus de campanha",
}); // → Commission
```

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