Autenticação

Cada pedido identifica a sua conta com uma chave pública:

X-Public-Key: pk_your_public_key
Content-Type: application/json

A chave pode ser incluída com segurança num bundle do navegador. Permite criar pagamentos e ler um pagamento pelo seu ID, mas não permite movimentar dinheiro, alterar as suas wallets de liquidação nem aceder aos dados de outro comerciante. As leituras ao nível de toda a conta usam, em vez disso, a sua chave de API e segredo.

curl https://hub.stablezact.com/api/v1/networks \
  -H "X-Public-Key: pk_your_public_key"

Chave de API e segredo

As leituras ao nível de toda a conta, a lista de pagamentos (/payments/merchant/list) e as estatísticas de pagamentos (/payments/merchant/stats), autenticam-se com a sua chave de API e o segredo, que encontra em Dashboard, Settings, API:

X-API-Key: your_api_key
X-API-Secret: your_api_secret
Content-Type: application/json

• Envie-os apenas a partir do seu servidor. O segredo nunca pode chegar a um navegador.
• Envie estes dois cabeçalhos sem X-Public-Key. Quando está presente uma chave pública, o pedido é autenticado com a chave pública.
• A chave e o segredo leem sempre dados do modo live.

curl https://hub.stablezact.com/api/v1/payments/merchant/stats \
  -H "X-API-Key: $STABLEZACT_API_KEY" \
  -H "X-API-Secret: $STABLEZACT_API_SECRET"

As chamadas a estas duas rotas apenas com uma chave pública ainda funcionam por agora, e a resposta inclui um cabeçalho Deprecation: true. Passe a usar a chave de API e o segredo. As integrações que já enviam a chave e o segredo em cada pedido continuam a funcionar.

Credenciais em falta ou inválidas

{
  "error": "API credentials required. Use x-public-key header or x-api-key and x-api-secret headers."
}

Devolvido com 401.