Testes e troubleshooting - Pagou Developer Docs

Use esta página antes do lançamento e sempre que o comportamento de pagamento no navegador parecer inconsistente.

Para os cartões, documentos e valores de teste do sandbox que determinam cada resultado (aprovado, recusado, 3DS challenge/frictionless, tokenização e liquidação de Pix/Boleto), veja Dados de teste.

Checklist de teste

confirme que o navegador usa a chave pública de sandbox
confirme que o back-end usa o token secreto de sandbox
verifique se o back-end devolve o payload da transaction intacto
verifique a entrega de webhook antes de confiar no estado do navegador
reconcilie qualquer tentativa de 3DS interrompida

Exemplo de requisição do back-end

{
  "external_ref": "order_2001",
  "amount": 2490,
  "currency": "BRL",
  "method": "credit_card",
  "token": "pgct_token_from_browser"
}

Exemplo de resposta do back-end

{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b43-7c9a-8d3e-1a2b3c4d5e70",
    "status": "pending"
  }
}

Erro comum

{
  "type": "https://api.pagou.ai/problems/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request contains invalid data.",
  "errors": [
    {
      "field": "token",
      "message": "Token is required for credit card payments",
      "code": "invalid_type"
    }
  ]
}

Como corrigir: se o back-end não estiver recebendo um token válido do Payment Element, pare e valide a integração do navegador antes de mudar lógica de pedido ou tratamento de webhook.