Payout batches (CLI) - Repass

O grupo payout-batches lê os lotes de fechamento de payouts: cada execução real de ciclo (payouts run --live) cria um lote que agrupa os payouts daquela rodada. É a base do histórico de “Ciclos” do painel. Só tem comandos de leitura.

Consulta

# Listar (paginado, filtro opcional por programa)
repass payout-batches list --program-id prog_xxx --json

# Buscar um lote pelo id
repass payout-batches get cyc_xxx --json

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

repass payout-batches get cyc_xxx --json

{
  "id": "cyc_01J9Z…",
  "programId": "prog_xxx",
  "status": "completed",
  "affiliateCount": 42,
  "totalCents": 1850000,
  "closingAt": "2026-07-01T00:00:00Z",
  …
}

O status do lote (processing, completed, partial) é derivado dos payouts-membro: processing enquanto houver payout agendado/em processamento, completed quando todos concluem, partial quando algum liquida com falha ou cancelamento.

Para o schema completo de PayoutBatch e os campos de cada objeto retornado, consulte a página SDK equivalente (Payout batches) e a Referência da API. As regras de negócio estão em Payouts. A execução do ciclo que gera cada lote fica em payouts run. Veja Payouts.