Autenticação

Toda requisição à API pública precisa de um header Authorization com sua API key.

bash

Authorization: Bearer hpx_test_sua_chave_aqui

Gerando uma API key

Acesse Dashboard → API Keys e clique em Nova API Key. Guarde a chave — ela só é exibida uma vez.

Ambientes

Prefixo	Ambiente	Comportamento
`hpx_test_`	Sandbox	Usa o sandbox do PSP — cobranças não são reais
`hpx_live_`	Produção	Cobranças reais, dinheiro real

Exemplo

bash

curl https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"amount": 5000, "provider": "asaas"}'

Erros de autenticação

Se a chave estiver ausente, inválida ou revogada, a API retorna 401:

json

{
  "error": {
    "type": "unauthorized",
    "message": "Invalid or revoked API key."
  }
}