Referência da API
A base pública planejada é https://magnum.lat. No desenvolvimento, use http://localhost:3100. Todas as respostas funcionais usam { "data": ... }; erros usam { "error": ... }.
Integração de servidor
| Método | Caminho | Autorização |
|---|---|---|
| GET | /v1/capabilities | Público |
| GET | /v1/networks | Público |
| GET | /v1/quotes?asset=USDT | Público |
| GET/POST | /v1/integrations | integrations:read/write |
| POST | /v1/checkout-sessions | checkouts:write + idempotência |
| GET | /v1/checkout-sessions/:id | checkouts:read |
| GET | /v1/payments | payments:read |
| GET | /v1/metrics | metrics:read |
| GET | /v1/requests | metrics:read |
| POST | /v1/webhook-endpoints | webhooks:write |
| DELETE | /v1/webhook-endpoints/:id | webhooks:write |
| GET | /v1/webhook-deliveries | webhooks:write |
Navegador do checkout
| Método | Caminho | Requisito |
|---|---|---|
| GET | /v1/public/checkouts/:id | Capacidade Checkout |
| POST | /v1/public/checkouts/:id/payments | Capacidade + idempotência |
| GET | /v1/public/checkouts/:id/payment | Capacidade Checkout |
| POST | /v1/public/checkouts/:id/simulate | Capacidade + sandbox |
| POST | /v1/sandbox/sessions | Mesma origem + limite de uso |
Rotas de conta estão descritas em Contas. /healthz é liveness; /readyz consulta PostgreSQL. A rota /v1/providers/4p/notifications está bloqueada por política live.
OpenAPI
O contrato gerado fica em /v1/openapi.json. Schemas das entradas de negócio são derivados da mesma validação usada no servidor. Autenticação de conta é delegada ao Better Auth e não faz parte desse documento. Campos adicionais não documentados são rejeitados.
API do painel
Veja Painel do estabelecimento para endpoints de sessão, construtor e ciclo de conta. São separados da autenticação por chave de servidor.