Afiliados (CLI)

O grupo affiliates gerencia afiliados (cadastro, aprovação, transições de estado, tier e dados de pagamento), além de consultar saldo e timeline. affiliate-imports importa afiliados em massa via CSV. A criação é sempre escopada por programa.

`affiliates`

# Criar (escopado pelo programa)
repass affiliates create prog_xxx --data '{"name":"Maria Silva","email":"[email protected]"}'

# Buscar
repass affiliates get aff_xxx

# Listar (paginado, com filtros)
repass affiliates list --program-id prog_xxx --status approved --q maria --json

# Atualizar dados de pagamento (parcial)
repass affiliates update aff_xxx --data '{"payoutMethod":"pix","pixKey":"[email protected]","pixKeyType":"email"}'

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

Ciclo de vida

repass affiliates approve aff_xxx                                            # aprova o cadastro pendente
repass affiliates reject aff_xxx --data '{"reason":"fora do perfil"}'        # rejeita o cadastro
repass affiliates pause aff_xxx                                              # suspende temporariamente
repass affiliates resume aff_xxx                                             # retoma após pausa
repass affiliates ban aff_xxx --data '{"reason":"violação dos termos"}' --yes # bane permanentemente

affiliates ban é destructive: não há “desbanir” no registry, é mudança de estado permanente na prática. Rode affiliates get aff_xxx antes para confirmar a identidade/estado atual. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

Tier

# Move o afiliado para outro tier
repass affiliates change-tier aff_xxx --data '{"tier":"gold"}'

# tier: null volta ao tier base
repass affiliates change-tier aff_xxx --data '{"tier":null}'

Saldo, timeline e convite

# Saldos: pendente, aprovado, em revisão e clawback
repass affiliates balance aff_xxx --json

# Trilha imutável de eventos, em ordem cronológica (não paginado)
repass affiliates timeline aff_xxx --json

# Convida um afiliado já existente para o portal (envia URL de claim por e-mail)
repass affiliates invite aff_xxx

repass affiliates balance aff_xxx

pendingCents  approvedCents  inReviewCents  clawbackCents
------------  -------------  -------------  -------------
50000         120000         0              0

`affiliate-imports`

Import assíncrono de afiliados a partir de um CSV. Usa --upload, não --data. Todos os comandos operam sobre a organização; create recebe program-id.

# Importar (--upload, processamento assíncrono)
repass affiliate-imports create prog_xxx --upload ./afiliados.csv

# Listar os imports da organização (paginado)
repass affiliate-imports list --json

# Status e progresso de um import (totais, erros por linha)
repass affiliate-imports get imp_xxx --json

repass affiliate-imports get imp_xxx --json

{
  "id": "imp_01J9Z…",
  "programId": "prog_xxx",
  "status": "completed",
  "totalRows": 120,
  "importedRows": 118,
  "failedRows": 2,
  …
}

affiliate-imports list é paginado. Veja Paginação.

Para o schema completo de cada corpo (dados de cadastro, métodos de pagamento, formato dos saldos etc.) e os campos dos objetos retornados, consulte a página SDK equivalente (Affiliates) e a Referência da API. As regras de negócio estão em Afiliados.

Começando

Convenções

Recursos

Afiliados (CLI)

`affiliates`

Ciclo de vida

Tier

Saldo, timeline e convite

`affiliate-imports`

​affiliates

​Ciclo de vida

​Tier

​Saldo, timeline e convite

​affiliate-imports

`affiliates`

Ciclo de vida

Tier

Saldo, timeline e convite

`affiliate-imports`