API v1 — integradores

A API v1 é o contrato principal para integradores que usam chaves de API criadas no painel.

Base URL

Todos os endpoints abaixo usam o prefixo:

https://seu-dominio.com/api/v1

Header obrigatório:

Authorization: Bearer {public_id}.{secret}

public_id e secret são exibidos na criação da chave (o secret só aparece uma vez).
A conta precisa de KYC aprovado internamente para consumir o gateway.

Método	Path	Descrição
GET	`/balance`	Saldo da carteira interna, taxas e dados da conta
POST	`/charges`	Criar cobrança PIX
GET	`/charges`	Listar cobranças
GET	`/charges/{id}`	Detalhe por UUID ou `external_id`
POST	`/withdrawals`	Saque PIX
GET	`/withdrawals`	Listar saques
GET	`/withdrawals/{id}`	Detalhe
GET	`/transactions`	Histórico cash-in / cash-out
POST	`/transactions/consult`	Consultar status no provedor

As respostas de criação de cobrança/saque podem incluir campos enriquecidos pela plataforma (ex.: uuid local), além do que o provedor retorna.