API de Pagamentos Pitra
A API Pitra permite que o seu sistema crie cobranças Pix, receba o pagamento e acompanhe cada etapa por webhook — sem depender de painel, planilha ou conferência manual.
Criação de cobranças Pix
Uma única chamada cria a cobrança e devolve tudo o que você precisa para exibir ao cliente: valor, vencimento, QR Code dinâmico e o código Pix Copia e Cola.
- Cobrança Pix com valor, descrição e dados do cliente
- QR Code dinâmico pronto para exibir na sua tela
- Pix Copia e Cola para quem prefere colar no aplicativo do banco
- Identificador próprio do pedido (external_id) para consultar depois
Acompanhamento do pagamento
Você pode consultar a cobrança pela API a qualquer momento ou deixar que a Pitra avise o seu sistema. Os eventos cobrem a cobrança criada, paga e expirada.
Webhooks assinados
Cada notificação é assinada, o que permite ao seu servidor confirmar que a mensagem realmente veio da Pitra antes de liberar o pedido. Entregas com falha são reenviadas automaticamente.
Integração e segurança
- REST com respostas em JSON e erros padronizados
- Chaves de API separadas por ambiente, com ambiente de testes
- Idempotência para não duplicar cobranças em caso de repetição
- Limites de uso e paginação documentados
- SDK oficial em Node.js/TypeScript e arquivo OpenAPI para gerar clientes
Documentação
Toda a referência é pública. Comece pela documentação da API Pitra ou vá direto para o tema que você precisa:
Perguntas frequentes sobre a API de pagamentos
- O que é a API Pitra?
- É a API de pagamentos da Pitra: uma API REST para criar cobranças Pix, consultar o status de cada cobrança e receber notificações de pagamento no seu próprio sistema.
- Como funciona a API de pagamentos da Pitra?
- Você autentica com uma chave de API, envia os dados da cobrança e recebe o QR Code Pix e o código Copia e Cola. Quando o pagamento é aprovado, a Pitra envia um webhook assinado para a URL que você cadastrou.
- Como integrar pagamentos por API na Pitra?
- Crie sua conta, gere uma chave de teste, faça a primeira cobrança no ambiente de testes e depois troque para a chave de produção. A documentação traz exemplos prontos em várias linguagens, além do SDK oficial e do arquivo OpenAPI.
- A API tem ambiente de testes?
- Sim. Chaves de teste devolvem cobranças simuladas, com QR Code de exemplo e sem qualquer movimentação financeira.
- Como evitar cobranças duplicadas?
- A API aceita um identificador próprio do seu pedido (external_id) e chaves de idempotência: a mesma requisição repetida nunca gera duas cobranças.
Comece a receber com a Pitra
Crie sua conta, conecte sua conta de recebimento e gere a primeira cobrança Pix — por link de Checkout ou pela API de Pagamentos.