Automação e CI

Ambientes não interativos (pipelines de CI, cron jobs, scripts em servidor) não passam pelo device flow. Ele depende de um humano aprovando no navegador. Use uma chave de API e as flags que a CLI já oferece para rodar sem prompts.

Autentique com uma chave de API

export REPASS_API_KEY=rsto_xxxxxxxxxxxxxxxx
repass whoami

Prefira uma chave rsto_ (da organização) para automação: ela não está atrelada a um usuário, então continua funcionando mesmo se a pessoa que a gerou sair da equipe. Reserve chaves rstr_ (pessoais) para uso interativo ou quando a automação precisa herdar o papel de um operador específico. Veja Autenticação.

Com REPASS_API_KEY definida, todo comando resolve a credencial automaticamente. Não é preciso rodar repass login no pipeline.

`--yes` para comandos destrutivos/sensíveis

Fora de TTY, comandos destructive/sensitive (ver Convenções) exigem --yes explícito; sem ele, a CLI falha com um erro orientando a flag em vez de travar esperando confirmação:

repass conversions void conv_xxx --data '{"reason":"chargeback confirmado"}' --yes

--yes pula a confirmação interativa: a ação executa imediatamente, sem chance de cancelar. Use apenas em automação que você já validou (idealmente testada primeiro em modo leitura/dry-run), nunca como padrão para “destravar” um comando que falhou sem entender o motivo.

`--json` para parsear a saída

Toda automação que precisa ler o resultado deve usar --json. A tabela humana trunca valores e não tem formato estável para parsing:

repass payouts run --program-id prog_xxx --live --yes --json | jq -r '.payouts[].id'

Exit codes para controlar o fluxo

0 indica sucesso; qualquer outra coisa (1) indica falha. Use isso para decidir o próximo passo do pipeline, sem depender do texto da mensagem de erro:

if ! repass payouts run --program-id "$PROGRAM_ID" --live --yes --json > result.json; then
  echo "Falha ao rodar o payout. Abortando pipeline."
  exit 1
fi

Exemplo: step de GitHub Actions

.github/workflows/payout.yml

- name: Rodar payout do ciclo
  env:
    REPASS_API_KEY: ${{ secrets.REPASS_ORG_API_KEY }}
  run: |
    npm install -g @repass/cli
    # preview não muta nada; --yes só pula a confirmação exigida fora de TTY
    repass payouts preview --program-id "$PROGRAM_ID" --json --yes
    repass payouts run --program-id "$PROGRAM_ID" --live --yes --json

Exemplo: script bash com jq

audita-comissoes-pendentes.sh

#!/usr/bin/env bash
set -euo pipefail

export REPASS_API_KEY="$REPASS_ORG_API_KEY"

total=$(repass commissions list --status pending --all --json | jq '[.[].amountCents] | add')
echo "Total pendente: ${total} centavos"

if [ "$total" -gt 1000000 ]; then
  echo "Acima do limite esperado. Revisar antes do próximo payout."
  exit 1
fi

Próximos passos

Convenções

Modelo de risco, exit codes e formato de erros em detalhe.

Uso com agentes

A skill repass-cli, para quando a “automação” é um agente de IA.

Começando

Convenções

Recursos

Automação e CI

Autentique com uma chave de API

`--yes` para comandos destrutivos/sensíveis

`--json` para parsear a saída

Exit codes para controlar o fluxo

Exemplo: step de GitHub Actions

Exemplo: script bash com jq

Próximos passos

Convenções

Uso com agentes

​Autentique com uma chave de API

​--yes para comandos destrutivos/sensíveis

​--json para parsear a saída

​Exit codes para controlar o fluxo

​Exemplo: step de GitHub Actions

​Exemplo: script bash com jq

​Próximos passos

Convenções

Uso com agentes

Autentique com uma chave de API

`--yes` para comandos destrutivos/sensíveis

`--json` para parsear a saída

Exit codes para controlar o fluxo

Exemplo: step de GitHub Actions

Exemplo: script bash com jq

Próximos passos