Informação para ParceirosEste guia descreve como funciona o timeout de inatividade no app de pagamento. Essa configuração é gerenciada pelos administradores do sistema. Se você precisar ajustá-la, entre em contato com o seu time de suporte.
O que é APP_TIMEOUT_MS?
O que faz: Cronômetro automático que fecha o app quando o cliente fica parado sem fazer nada por muito tempo.
É um mecanismo de segurança que garante que o terminal não fique travado esperando pela eternidade.
🔄 Como funciona na prática
Cliente vai pagar → App abre
↓
Cronômetro começa a contar
↓
Cliente passa o cartão → Cronômetro ZERA e recomeça
↓
Cliente digita senha → Cronômetro ZERA e recomeça
↓
Pagamento aprovado → App fecha normal ✅E se o cliente não fizer nada?
App abre para pagamento
↓
Cliente fica parado (não passa cartão, não toca em nada)
↓
Cronômetro chega a zero
↓
App fecha sozinho com erro de TIMEOUT ❌⚠️ Importante
Qualquer ação do cliente reinicia o cronômetro do zero:
- Tocar na tela
- Passar cartão
- Digitar senha
- Qualquer interação
⏸️ Quando o cronômetro PAUSA?
O cronômetro não conta (pausa) nos seguintes momentos:
- Cliente está digitando a senha
- Pagamento está processando online
- QR Code está sendo exibido
- App está minimizado (em segundo plano)
❓ Perguntas Frequentes
P: O que acontece quando o timeout expira?
R: O app fecha e retorna erro ABORTED_BY_TIMEOUT.
P: Quanto tempo até o app fechar?
R: O valor é de 20 segundos.
P: O cronômetro continua quando o app está minimizado?
R: Não. Ele pausa quando o app vai para segundo plano e é zerado ao voltar.
P: O que fazer se o app não fecha nunca?
R: Verifique se o terminal está na versão 7.10 ou superior. Se o problema persistir, entre em contato com o seu time de suporte.
🔗 Precisa de Suporte?
Se o app está fechando muito rápido ou não fecha quando deveria, entre em contato com o seu time de suporte para que as configurações sejam ajustadas adequadamente.