Pagou Gateway v2
Bem-vindo à API da Pagou.
Aqui você encontra o que precisa para integrar cobranças Pix, pagamentos com cartão, Payment Element, transferências Pix, webhooks e rotinas de reconciliação com foco em implementação real.
Comece pela v2, use um único esquema de autenticação, envie external_ref estável e trate webhooks como fonte de estado.
Use Payment Element para campos hospedados, tokenização e orquestração de 3DS antes de criar a transação no back-end.
Escreva pela API, confirme webhooks rapidamente e reconcilie com endpoints GET quando o desfecho estiver incerto.
Conteúdo principal
Fazer a primeira requisição
Vá das credenciais até a primeira transação v2 bem-sucedida em sandbox com o menor setup possível.
Autenticação
Escolha um padrão único de autenticação para produção e valide o acesso antes de movimentar dinheiro.
Ambientes
Entenda URLs base, separação de credenciais e a disciplina de implantação entre sandbox e produção.
Criar cobrança Pix
Crie cobranças Pix, entregue dados de QR Code ao comprador, trate o estado por webhook e ofereça suporte a reembolsos.
Pagamentos com cartão
Use o fluxo recomendado para cartão, entenda o ciclo de vida da transação e modele reembolsos corretamente.
Aceitar cartão com Payment Element
Use campos hospedados, tokenização e orquestração de 3DS sem tocar em dados sensíveis no DOM.
Enviar transferência Pix
Crie transferências, acompanhe estados e opere reconciliação com a mesma base da API v2.
Consumir webhooks com segurança
Processe eventos de pagamentos e transferências com confirmação rápida, idempotência e reconciliação como contingência.
SDK para TypeScript
Use o SDK oficial com exemplos reais de transações, transferências, paginação, tentativas automáticas e erros tipados.
Referência da API
Navegue pelo contrato OpenAPI gerado para todos os endpoints públicos suportados da v2.
Arquivo legado v1
Mantenha integrações antigas funcionando e mapeie fluxos legados para o modelo recomendado da v2.
Atualizações
Acompanhe mudanças da documentação e alterações públicas relevantes para implementação.
Sequência recomendada de integração
Comece aqui
Veja o mapa completo da integração e siga pela trilha de início rápido, autenticação, idempotência, erros e entrada em produção.
Pagamentos
Modele clientes, estados de transação, fluxos Pix, fluxos de cartão e comportamento de reembolso em um único lugar.
Transferências
Trate transferências Pix com guias de criação, listagem, cancelamento, estados e reconciliação.
Front-end
Implemente a parte do navegador para aceitação de cartão com campos hospedados, eventos e 3DS.
Exemplo rápido em sandbox
Base de produção: autentique com um método, envie
external_ref estável, reconheça webhooks em milissegundos e reconcilie incertezas com GET /v2/transactions/{id} ou GET /v2/transfers/{id}.