Pular para o conteúdo principal
Esta seção é para engenheiros que estão desenhando uma nova integração ou reorganizando uma integração existente para o fluxo recomendado da v2.

​
O que você pode construir com a Pagou

Cobranças Pix

Crie transações Pix, exiba dados de QR Code ao comprador, reembolse pagamentos elegíveis e reconcilie estado.

Pagamentos com cartão

Use Payment Element para o fluxo recomendado no navegador e a API de transações no back-end.

Transferências Pix

Envie dinheiro para destinatários, acompanhe estados e cancele transferências pendentes quando permitido.

Webhooks

Consuma eventos assíncronos de pagamentos e transferências como fonte primária de verdade.

​
Modelo recomendado

  1. Autentique todas as chamadas com um único método padronizado.
  2. Crie recursos com external_ref estável.
  3. Trate webhooks como canal principal de atualização de estado.
  4. Use endpoints GET para reconciliação e suporte operacional.
  5. Isole fluxos v1 no arquivo legado.