Settings (CLI)

Três grupos de configuração da organização: settings (políticas, por área), custom-domains (domínios próprios para links) e api-keys (chaves de API).

`settings`

Ao contrário do SDK, que expõe um sub-namespace por política (sdk.settings.payoutPolicy, sdk.settings.fraudPolicy…), a CLI expõe só dois comandos, get e set, com a área como argumento posicional:

repass settings get <area> [--json]
repass settings set <area> --data '<json>'

Área (`<area>`)	Política
`payout-policy`	Ciclo, dia de fechamento, valor mínimo e método padrão de payout
`fiscal-policy`	Modo de emissão de nota fiscal
`fraud-policy`	Limiares de aprovação/revisão automática antifraude
`reprocess-policy`	Limiar de confirmação e modo de notificação do reprocessamento
`stripe`	Configuração da integração Stripe (segredos mascarados na leitura)
`destination-domains`	Domínios de destino permitidos para links
`tracker`	Configuração do tracker de rastreamento

# Ler a política de payout
repass settings get payout-policy --json

# Atualizar (parcial) a política antifraude
repass settings set fraud-policy --data '{"approveBelow":0.3,"reviewAbove":0.7}'

repass settings get payout-policy --json

{ "cycle": "monthly", "closingDay": 5, "minimumPayoutCents": 5000, "defaultMethod": "pix" }

settings set <area> é sensitive para todas as áreas, mesmo destination-domains (que isoladamente seria só write): o risco do comando é estático no registry e cobre várias áreas em runtime, então a CLI classifica a escrita inteira como sensível. Rode settings get <area> antes para comparar com o valor atual. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

`custom-domains`

Domínios próprios da organização para os links de afiliado.

# Listar
repass custom-domains list --json

# Adicionar (gera o token de verificação TXT)
repass custom-domains create --data '{"hostname":"go.exemplo.com"}'

# Verificar posse (TXT) e roteamento (CNAME)
repass custom-domains verify dom_xxx

# Marcar como primário
repass custom-domains set-primary dom_xxx

# Remover
repass custom-domains remove dom_xxx --yes

custom-domains remove é destructive. Remove o domínio (hard-delete); links que o usavam voltam ao domínio padrão. Não é reversível (seria preciso recriar e reverificar o DNS). Rode custom-domains list antes para checar se não é o domínio primário. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

`api-keys`

Chaves de API da organização (rsto_...).

# Criar
repass api-keys create --data '{"name":"Integração ERP"}'

# Listar (não retorna o valor da chave)
repass api-keys list --json

# Revogar
repass api-keys revoke key_xxx --yes

api-keys create inclui um campo extra aviso na resposta, só para lembrar de guardar a chave. A chave em claro só aparece nesta resposta:

repass api-keys create --json

{
  "id": "hs82ndKq7Lm3vRz1PbTgYs4Q",
  "name": "Integração ERP",
  "key": "rsto_…",
  "prefix": "rsto_",
  "aviso": "Guarde esta chave agora: ela não será exibida novamente e não pode ser recuperada depois."
}

O id de uma chave de API é opaco e não segue o padrão de prefixo por tipo de recurso (prog_, aff_…) usado no restante da API: é gerado pela camada de autenticação, não pelo domínio de negócio.

A chave de API só aparece em texto claro na resposta de api-keys create. Guarde-a imediatamente, ela não pode ser recuperada depois (nem mostrada de novo). Se perder, a única opção é criar uma chave nova e revogar a antiga.

api-keys revoke é destructive. Revoga (apaga) a chave; qualquer integração que a use para de funcionar na hora, sem aviso prévio. Não é reversível (é preciso criar uma chave nova). Rode api-keys list antes para confirmar o id certo. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

Para o schema completo de cada corpo (campos de cada política, modos e valores aceitos), consulte a página SDK equivalente (Settings) e a Referência da API. As regras de negócio estão em Payouts, Fiscal e Reprocessamento. custom-domains e api-keys não têm ferramenta MCP/SDK correspondente documentada à parte. Os campos seguem a Referência da API.

Começando

Convenções

Recursos

Settings (CLI)

`settings`

`custom-domains`

`api-keys`

​settings

​custom-domains

​api-keys

`settings`

`custom-domains`

`api-keys`