Skip to main content
Este guia é um mapa de implementação. Os detalhes de payload ficam nas páginas de endpoint.

​
1. Validar autenticação

Use Bearer token como padrão recomendado: 
curl --request GET \
  --url https://api.pagou.ai/v2/transactions \
  --header 'Authorization: Bearer SEU_TOKEN'
Se responder com sucesso, siga para o método de pagamento.

​
2. Escolher o fluxo principal

​
Pix In

  1. Fluxo principal: /pix/cash-in
  2. Criar cobrança: /pix/endpoints/create-payment
  3. Consultar transação: /pix/endpoints/get-transaction
  4. Reembolso: /pix/endpoints/refund-payment

​
Cartão de crédito

  1. Fluxo principal: /credit-card/charge-flow
  2. Tokenização frontend (obrigatória): /sdk/websdk-credit-card
  3. Criar transação no backend: /credit-card/endpoints/create-payment

​
3. Configurar webhooks

  1. Fundamentos e arquitetura de consumo: /webhooks/intro
  2. Eventos de pagamento (Pix + cartão): /webhooks/payments
  3. Configuração de destino (notify_url): /webhooks/update-webhook

​
4. Adicionar reconciliação

  • Pagamentos: GET /v2/transactions/{id}
  • Transferências: GET /v2/transfers/{id}
Use reconciliação como fallback, não como fluxo principal.

​
5. Tratar erros corretamente

A API responde erros em application/problem+json (RFC 7807). Regra prática:
  1. 422: erro de validação (corrigir payload)
  2. 401/403: credencial/permissão
  3. 5xx: falha transitória (retry com idempotência)

​
6. Ir para produção

Checklist mínimo:
  • padrão único de autenticação
  • idempotência em operações críticas
  • webhook com ack rápido + fila
  • logs com IDs de correlação