Autenticação - AXNPAY API

Header obrigatório

Todos os endpoints em /v1/integrations/* exigem:

Authorization: Bearer sk_live_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

A Integrations API aceita apenas sk_live_prod_*. Não use pk_live_prod_* para chamadas de servidor.

Exemplo em cURL

cURL

curl "https://api.axnpay.com.br/v1/integrations/balance" \
  -H "Authorization: Bearer sk_live_prod_SEU_TOKEN"

Exemplo em Node.js

const response = await fetch("https://api.axnpay.com.br/v1/integrations/balance", {
  headers: {
    Authorization: `Bearer ${process.env.AXNPAY_SECRET_KEY}`,
  },
});

if (!response.ok) {
  throw new Error(`Erro HTTP ${response.status}`);
}

const data = await response.json();
console.log(data);

Erros comuns

HTTP	Motivo	Mensagem comum
`401`	Header ausente ou malformado	`Authorization header ausente ou inválido.`
`401`	Prefixo incorreto	`Chave inválida. Use sua Secret Key (sk_live_prod_...).`
`401`	Chave revogada/inválida	`Secret key inválida ou revogada.`

Boas práticas

Guarde a sk_live_prod_* apenas em variável de ambiente do backend.
Não inclua a chave em app mobile/web.
Tenha rotação de chave e revogue chaves antigas.
Use idempotência para evitar duplicidade em reenvios de request.