Pular para o conteúdo
Pedir acesso

Hub de pagamentos · para quem integra

Cobre por pix, boleto e cartão com uma API só.

Seu sistema pede o quê: valor, meio e pagador. O hub decide como, em vários gateways, e registra cada movimento num extrato que fecha no centavo.

Pedir acesso Ler a documentação
Uma cobrança, um pedido

POST /api/v1/charges

Idempotency-Key: pedido-1042

{ "amount": 4990, "currency": "BRL", "method": "pix", "payer": { … } }

201 status: pending

amount é inteiro, em centavos: R$ 49,90

aviso charge.updated

assinado, enviado ao seu sistema

Como funciona

Peça o quê

Valor, meio e pagador. Você não escolhe gateway: o hub decide como, pela política de roteamento entre as contas que a sua empresa conectou, com fallback entre gateways.

Centavos, sempre

Todo valor é inteiro, na menor unidade da moeda, com a moeda ao lado. Nunca decimal.

Idempotente

Criar cobrança e criar estorno levam uma chave de idempotência. Repetir o pedido, por timeout ou por erro de rede, devolve o que já foi feito, sem cobrar duas vezes.

Avisos assinados

A cada mudança de cobrança, o hub envia um aviso assinado ao seu sistema. Você confere a assinatura antes de acreditar nele.

Cada movimento fica registrado

  1. Cobrar

    Pix, boleto e cartão. No cartão, o número digitado vai do pagador direto ao gateway: o hub nunca o recebe.

  2. Estornar

    Estorno inteiro ou parcial, no mesmo gateway em que a cobrança foi criada. Estorno é um lançamento novo, nunca uma edição.

  3. Conferir

    O extrato lista cada lançamento, em partidas dobradas que somam zero. O saldo é sempre a soma do que foi lançado.

O pagador

O pagador não vê o hub

Ele paga na conta do seu sistema no gateway. O hub não aparece para o pagador, e nenhuma página deste site faz parte do pagamento.

Gateways

A lista de gateways prontos é publicada aqui, à medida que cada um chega a produção.

Para quem é

Para a sua empresa, com as suas credenciais

Você conecta as credenciais da sua empresa em cada gateway, e o dinheiro cai direto na sua conta no gateway. O hub registra cada movimento no extrato e não guarda o seu dinheiro.

  • Cada sistema enxerga só as próprias cobranças, e pedir o id de outro devolve 404
  • As credenciais do gateway ficam cifradas e nunca aparecem em resposta, em log ou em página

API REST

JSON, API key por sistema, erros no formato RFC 9457

Referência

Rotas, campos, enums e erros, geradas do contrato

openapi.yaml

O contrato, para gerar cliente

llms.txt

Documentação pronta para agentes

Como começar

Não há cadastro aberto. Sistema, API key e credenciais de gateway nascem pelo caminho de quem opera o hub: peça acesso e combinamos o resto. As credenciais do gateway são entregues a quem opera, por canal combinado, e guardadas cifradas. Nenhuma página deste site pede, recebe ou mostra credencial, API key ou dado de cartão.

Preço: a definir.

Ainda não há preço, taxa nem plano publicados

Pedir acesso