Criar chave de API

Crie uma chave gp_live_... no dashboard para autenticar chamadas server-to-server com o header X-API-Key.

O secret aparece uma única vez. Guarde em variável de ambiente ou secret manager — nunca no Git nem no frontend.

Pré-requisito

Conta verificada em app.goatpay.com.br. Sem verificação, o botão de criar chave fica desabilitado.

Acessar API na Dashboard

No menu lateral, abra Integrações → API, ou acesse direto:app.goatpay.com.br/dashboard/integrations/api

Clicar em Nova chave

Clique em Nova chave no canto superior direito da página (ou no estado vazio, se ainda não houver chaves).

Configurar

No diálogo Nova chave, preencha:

Campo	O que fazer
Escopo	`Leitura`, `Escrita` ou `Completo` — define o conjunto inicial de rotas
Permissões	Ajuste as rotas da API v1 (marque só o necessário)
Permitir qualquer IP	Deixe marcado se o IP for dinâmico; desmarque para allowlist
Descrição	Ex.: `ERP Produção`

Clique em Criar.

Detalhes de permissões: Permissões da API key.

Copiar

Na tela Chave criada, copie o valor gp_live_... com Copiar chave. Ele não será exibido de novo.

Guarde assim:

export GOATPAY_API_KEY=gp_live_SUA_CHAVE

Teste rápido:

curl https://api.goatpay.com.br/v1/account/balance \
  -H "X-API-Key: $GOATPAY_API_KEY"

Do saldo à primeira cobrança PIX com webhook.

Rotação, trilho PADRAO e boas práticas.