---
title: "Guia de Timeout no Pagamento"
url: "https://devcenter.stone.com.br/sdk-android-guia-de-timeout-no-pagamento"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Guia+de+Timeout+no+Pagamento,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9zZGstYW5kcm9pZC1ndWlhLWRlLXRpbWVvdXQtbm8tcGFnYW1lbnRvIg,s_Ty4oS4QmnPcl0vtD.png"
---

# Guia de Timeout no Pagamento

Informação para Parceiros

Este 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-é-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](#como-funciona-na-prática)

```text
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?](#e-se-o-cliente-não-fizer-nada)

```text
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](#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?](#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](#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?](#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.

---

**Jornada: [Integrar por Deeplink](https://devcenter.stone.com.br/sdk-android-explicacao-deeplink)**  
Etapa 10 de 11

[**Etapa anterior**Cores White Label](https://devcenter.stone.com.br/sdk-android-cores-white-label)[**Próxima etapa**Deeplink](https://devcenter.stone.com.br/sdk-android-deeplink)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.