# Erros comuns de integração

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

* [Códigos de resultado e estruturas de dados](/pt/app2app/reference-a2a/result-codes-data-structure) - mapeie um código retornado para o seu significado.
* [Consulte o status de uma transação](https://docs.globalgetnet.com/pt/products/in-store-payments/app2app-integration?doc=check-a-transaction-status) - resolva um estado desconhecido antes de tentar de novo.