Documentation Index
Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
Use this file to discover all available pages before exploring further.
Use esta página antes do lançamento e sempre que o comportamento de pagamento no navegador parecer inconsistente.
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": "req_4005",
"data": {
"id": "tr_2001",
"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.