API AURA v1

Versão 2026-09-01 · base /api/public/v1

1. Crie sua aplicação

No app AURA, abra Perfil › API para lojistas, crie uma aplicação em modo Teste e guarde a credencial e o segredo do webhook. Eles aparecem uma única vez.

Chaves de teste começam com ak_test_ e as de produção com ak_live_. Revogar uma chave tem efeito imediato.

2. Autentique as chamadas

Envie o identificador e o segredo separados por dois-pontos. Nunca use o segredo no navegador: chame sempre a partir do seu servidor.

curl https://coinaura.lovable.app/api/public/v1/ping \
  -H "Authorization: Bearer ak_test_xxxx:sk_yyyy"

Resposta

{
  "ok": true,
  "mode": "sandbox",
  "client": "Minha Loja",
  "scopes": ["charges:write", "charges:read", "balance:read"],
  "version": "2026-09-01"
}

3. Endpoints disponíveis

GET/ping

Valida a credencial e devolve modo e escopos.

POST/charges

Cria uma cobrança e devolve o link de pagamento.

GET/charges

Lista as cobranças da aplicação.

GET/charges/{code}

Consulta o estado de uma cobrança.

GET/balance

Saldo do lojista em AURA e em dólar.

GET/rates

Valor de referência da AURA e câmbio USD/EUR/BRL.