Início

API de pagamentos Pix para quem integra por conta própria: cobrança com QR dinâmico, saque para uma chave Pix, devolução, saldo, extrato e webhooks assinados.

Endereços #

Há um ambiente só. A integração é feita em produção, com valores mínimos: uma cobrança de R$ 1,00 paga da sua própria conta percorre o mesmo caminho de uma de R$ 1.000,00, e o saldo que ela gera é seu.

Credenciais #

Peça ao seu contato comercial. Você recebe:

1. o client_id (começa com prod_);
2. o client_secret, entregue uma vez por canal seguro. Guarde-o em cofre: ele não é mostrado de novo;
3. a lista de escopos concedidos.

Com os três, siga para Autenticação.

Regras que valem em toda a API #

• Dinheiro é string decimal com duas casas: "150.00". Nunca número.
• Instantes são RFC 3339 em UTC: 2026-09-18T12:00:00Z. Datas de extrato são o dia contábil em America/Sao_Paulo.
• Identificadores de cobrança, saque e sub-conta são seus: 26 a 35 caracteres alfanuméricos. O id da devolução também é seu, com 1 a 35. Recomendamos ULID.
• Toda resposta traz x-correlation-id. Guarde-o para falar com o suporte.
• Seu parser deve tolerar campos e valores novos.

Para a máquina #

• llms.txt: a lista destas páginas, uma frase cada.
• A referência interna completa continua servida em GET /v2/api.md, e a especificação OpenAPI das rotas /v2/ex/ em GET /v2/openapi.yaml. As rotas de cobrança, Pix recebido e devolução seguem o padrão do Banco Central e não estão nessa especificação.