Getnet DocsGetnet Docs

Erros comuns de integração

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Esta página traz soluções para problemas comuns encontrados ao integrar sua aplicação com o Getnet Payment App via deeplinks.

Problemas de software e de Intent

Erros comuns relacionados à comunicação por Intent e à conectividade do app.

O Intent não é resolvido

Esse erro ocorre quando sua aplicação trava ou nada acontece ao chamar startActivityForResult. A causa mais comum é o Getnet Payment App não estar instalado no terminal ou o esquema da URI estar incorreto.

Solução

  1. Confirme que o pacote com.getnet.payment (ou equivalente) está instalado no terminal
  2. Garanta que você usa a URI base correta: getnet://payment/v1/
  3. Adicione uma verificação com intent.resolveActivity(packageManager) antes de disparar o Intent

Código de resultado “4” (estado desconhecido)

Esse erro ocorre quando o app retorna result="4", indicando um estado de transação desconhecido. Isso normalmente acontece quando uma falha crítica (como um travamento ou queda de energia) ocorre depois que a transação chega ao processador, mas antes de uma resposta ser gerada.

Solução

Chame primeiro o deeplink getnet://payment/v1/last-transaction (Get Last Voucher), antes de chamar relatórios, para verificar se o pagamento foi realmente aprovado.

Timeouts

Erros comuns relacionados a timeout e suas soluções.

Timeout do QR Code

Esse erro ocorre quando a transação é cancelada automaticamente durante o pagamento por QR Code. A exibição do QR Code tem um limite de timeout de 180 segundos, e a fase de autorização tem um limite de 60 segundos.

Solução

Oriente o usuário a escanear o código imediatamente. Se o timeout for atingido, você precisa iniciar um novo Intent de pagamento.

Timeout geral da transação

Esse erro ocorre quando o Payment App retorna um erro de timeout de host, normalmente por falta de resposta da adquirente em 15–30 segundos.

Solução

Verifique a conexão de internet do terminal. Se o erro persistir, faça uma verificação de conectividade para confirmar a disponibilidade do serviço.

Próximos passos