Pular para o conteúdo principal

Comece em sandbox

Crie uma primeira transação v2 com o mínimo de configuração e avance para fluxos seguros de produção.

Use com agentes de IA

Dê a Claude Code, Cursor, Codex, Copilot, Windsurf, Lovable, Bolt.new ou v0 o contexto certo da Pagou.

​
Caminhos principais de integração

Pagamentos

Modele clientes, transações, Pix, voucher, cartão, reembolsos e tratamento de status de transação.

Payment Element

Monte campos de cartão hospedados, dispare tokenização, trate 3D Secure e mantenha segredos no back-end.

Assinaturas

Crie cobrança recorrente com clientes, renovações, retentativas e webhooks de assinatura.

Pix Out

Crie transferências Pix de saída, cancele transferências pendentes e reconcilie o estado do payout.

​
Construa por tarefa

Receber Pix

Crie transações Pix, devolva os dados do QR code ao comprador e finalize por webhook ou reconciliação.

Receber vouchers

Crie instruções locais como Boleto, SPEI, Mercado Pago, Webpay, CODI ou PSE usando method: "voucher".

Receber cartão

Use elements.submit(...) para tokenizar cartões e envie o token para a rota de criação de transação no back-end.

Cobrar assinaturas

Inicie cobrança recorrente com um cliente, um token de cartão e a API de assinaturas.

Receber webhooks

Construa uma entrada única para eventos de pagamento, assinatura e payout com deduplicação por ID de evento.

Entrar em produção

Confirme ambiente, autenticação, idempotência, webhook, retentativas e reconciliação antes da produção.

​
Referência e ferramentas

Referência API

Navegue por clientes, transações, assinaturas, transferências v2 e endpoints legados v1 por recurso.

SDK TypeScript

Configure o SDK oficial server-side para TypeScript em pagamentos e transferências.

OpenAPI v2

Use a fonte de verdade de schemas para builders de request, testes, mocks e validação por agentes.

​
Regras de produção

  • Crie pagamentos e transferências apenas pelo back-end.
  • Use external_ref como identificador estável de escrita.
  • Nunca invente campos que não existem no schema OpenAPI.
  • Use Payment Element e elements.submit(...) para tokenização de cartão.
  • Libere pedidos apenas a partir de webhook confirmado ou estado reconciliado.
  • Deduplique webhooks pelo id do evento no topo.

​
Leia a seguir