PosUp

Debugar transações recusadas

Seu pagamento foi rejeitado em produção? Siga este guia prático para identificar e resolver o problema rapidamente.

Passo 1: Verifique logs

Acesse os logs do gateway de pagamento e do seu servidor. Procure por timestamp exato, código de erro e mensagem de resposta da transação.

Passo 2: Identifique o código

Cada rejeição tem um código (ex: 05 - insufficient funds, 14 - invalid card). Consulte a documentação do seu provider para entender a causa raiz.

Passo 3: Valide dados

Confirme que CVV, data de validade, nome do titular e valor estão corretos. Erros de digitação são a causa mais comum de rejeição.

Passo 4: Teste em sandbox

Reproduza a transação no ambiente de teste do seu gateway. Use números de cartão de teste fornecidos pelo provider para validar o fluxo.

Passo 5: Verifique limites

Confirme se o cartão tem limite disponível, se há restrição de país, se está bloqueado para compras online ou se excedeu tentativas de transação.

Passo 6: Comunique ao usuário

Retorne mensagem clara e acionável: qual foi o problema (saldo, dados, bloqueio) e próximos passos (tentar outro cartão, contatar banco).

Resolva com confiança

Com logs claros, testes em sandbox e validação de dados, você encontrará a causa. Documente a solução para evitar recorrências.

MaquininhaReview: O que é, como funciona e por que confiar (2026)

Leia a matéria completa