Autenticação
Como autenticar requisições à API com Bearer token.
Toda requisição à Stater Platform precisa carregar uma API key no header
Authorization usando o esquema Bearer.
Header obrigatório
http
Authorization: Bearer SUA_API_KEYSelecionando a conta
Quando a mesma API key tem acesso a múltiplas contas, envie o header
X-Pix-Account-Id para indicar qual conta deve ser usada na operação.
Se omitido, a conta padrão associada à chave é utilizada.
bash
curl https://api.staterpay.io/v1/account \-H "Authorization: Bearer SUA_API_KEY" \-H "X-Pix-Account-Id: acc_01HXYZ..."Mantenha a chave segura
Nunca exponha a API key no navegador, em apps mobile ou em repositórios públicos. Acesse a Stater somente a partir do seu backend.
Erros de autenticação
401— chave ausente, malformada ou inválida.403— chave válida, mas sem permissão na conta solicitada.