API Pix para cobrar, receber e pagar direto do seu sistema
Crie cobranças com QR Code, consulte o status, envie Pix por chave e receba o aviso de pagamento por webhook. A documentação é pública e há uma chave de teste para validar tudo antes de operar.
O que a API Pix da Pague Mais entrega
Cobrança dinâmica
Crie a cobrança com o seu identificador (txid) e receba o código copia e cola e o QR Code. O mesmo pedido repetido devolve a mesma cobrança.
Consulta e listagem
Consulte uma cobrança pelo txid ou liste os Pix recebidos por período, com paginação.
Envio de Pix
Pague por chave Pix ou por QR Code copia e cola, com chave de idempotência para nunca enviar duas vezes.
Saldo, extrato e comprovante
Consulte o saldo disponível, o extrato da conta e o comprovante em PDF pela própria API.
Webhooks assinados
Avisos de Pix recebido, Pix enviado e Pix que falhou, no formato {type, data}, cada um com assinatura que o seu servidor confere.
Pensada para quem já integra com outras provedoras
A versão 2 da API segue o desenho que o mercado conhece: autenticação por token (/oauth/token), cobrança por PUT /cob/{txid}, consulta de Pix por período e webhooks por tipo. Quem já integrou com outra provedora de Pix troca de endereço e de credencial, sem reescrever a lógica.
Para integrações novas, a API também tem rotas simples de cobrança por Pix e de cobranças recorrentes, com o mesmo modelo de chaves e permissões.
Limites claros, sem surpresa
Cada chave tem limite de requisições por minuto, e a resposta de limite (429) indica que é preciso esperar. Para saber de um pagamento na hora, use o webhook em vez de consultar a cada instante: o aviso chega no momento da confirmação e poupa milhares de consultas.
Como começar
Abra sua conta
Cadastre-se pelo site, envie os dados e os documentos pedidos e acompanhe a análise do cadastro.
Cobre pelo painel ou integre pela API
Gere cobranças Pix pelo painel ou conecte seu sistema pela API, começando pela chave de teste (sandbox), que não mexe em dinheiro de verdade.
Receba e acompanhe
Receba o aviso de pagamento por webhook, libere o pedido e confira tudo no extrato e nos relatórios.
Perguntas frequentes
Existe ambiente de teste da API Pix?
Sim. A chave de teste (sandbox) simula a criação de cobranças, o pagamento e as falhas, sem mover dinheiro real. Ela é separada da chave de produção.
Como sei que um Pix foi pago?
Pelo webhook de Pix recebido, que chega assim que a liquidação é confirmada. Como conferência, você pode consultar a cobrança pelo identificador.
A API evita cobrança e envio duplicados?
Sim. A cobrança usa o seu identificador (txid) e o envio usa uma chave de idempotência: repetir o pedido devolve o resultado original em vez de criar outro.
Qual a validade do QR Code?
Você define a validade ao criar a cobrança, dentro do máximo permitido pela sua conta.
Onde fica a documentação?
Em docs.paguemais.com, aberta ao público, com exemplos de requisição e resposta e um arquivo llms.txt para assistentes de programação.
API Pix para cobrar, receber e pagar direto do seu sistema
Crie cobranças com QR Code, consulte o status, envie Pix por chave e receba o aviso de pagamento por webhook. A documentação é pública e há uma chave…
Veja também
- Gateway de pagamentoGateway de pagamento com cobrança por Pix, link de pagamento, recorrência e webhooks. Integre pela API e comece a vender hoje.
- Pix para e-commerceAceite Pix na sua loja virtual com QR Code dinâmico, confirmação por webhook e liberação automática do pedido. Integre pela API ou use link de pagamento.
- Processadora de pagamentosProcessadora e intermediadora de pagamentos: receba por Pix, divida com split, crie subcontas e integre por API. Abra sua conta na Pague Mais.
- Split de pagamentoDivida cada cobrança Pix entre até 5 destinos no momento do recebimento. Split por API ou regra permanente, com extrato de cada repasse.