CLI

Autenticação & Perfis

Login via API Key, múltiplos perfis e gerenciamento de sessões. A CLI usa a mesma autenticação da API pública (Authorization: Bearer ou X-API-Key).

Crie a chave no dashboard: Integração → API → Nova chave (exige 2FA). A secret só aparece uma vez.

Login

O login valida a chave com um health check + listagem leve e grava o perfil em disco:

hyzepay auth login \
  --api-key hzp_live_XXXXXXXXXXXXXXXX \
  --base-url https://hyzepay.pro \
  --profile prod

Sem --profile, usa o perfil default.

Múltiplos perfis

Ideal para alternar produção e ambiente local:

hyzepay auth login --api-key $PROD_KEY --base-url https://app.hyzepay.pro --profile prod
hyzepay auth login --api-key $LOCAL_KEY --base-url http://localhost:3000 --profile local

hyzepay auth list
hyzepay auth use local
hyzepay payments list --profile prod

Whoami

Confere perfil ativo, base URL e se a chave responde:

hyzepay auth whoami
hyzepay auth whoami --json

Logout

Remove o perfil do arquivo de config (não revoga a chave no dashboard):

hyzepay auth logout
hyzepay auth logout --profile local

Referência de comandos

ComandoDescrição
auth loginSalva API Key + base URL no perfil
auth logoutRemove o perfil local
auth whoamiMostra perfil e valida a chave
auth listLista perfis (* = padrão)
auth use <name>Define o perfil padrão