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

Autenticação

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.

Endpoints

MétodoPathDescrição
GET/balanceSaldo da carteira interna, taxas e dados da conta
POST/chargesCriar cobrança PIX
GET/chargesListar cobranças
GET/charges/{id}Detalhe por UUID ou external_id
POST/withdrawalsSaque PIX
GET/withdrawalsListar saques
GET/withdrawals/{id}Detalhe
GET/transactionsHistórico cash-in / cash-out
POST/transactions/consultConsultar 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.