> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plugtopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Checkout Response

> Controle quanto tempo seu cliente espera por uma resposta no checkout.

Seu cliente não deveria ficar vários segundos parado numa tela de carregamento enquanto gateways, adquirentes e emissores processam uma transação. Ao mesmo tempo, sua aplicação não deveria precisar adivinhar quando parar de esperar.

O **Smart Checkout Response** é como chamamos, nesta documentação, o mecanismo que resolve isso: você define um limite de espera e a PlugToPay garante que seu checkout nunca fique preso além dele — o processamento continua em background e o resultado final sempre chega, via webhook.

## Como funciona

```
Requisição chega
    ↓
Coroutine criada — processa o pagamento em paralelo
    ↓
PlugToPay aguarda até o limite configurado
    ↓
Gateway respondeu a tempo?
    SIM → resposta HTTP com o resultado completo (approved / failed)
    NÃO → 202 com transaction_id, status "processing"
              ↓
           Gateway responde depois → webhook entregue ao seu servidor
```

Enquanto o resultado não chega, retentativas e fallback entre gateways podem continuar acontecendo em background — sem obrigar o consumidor a esperar a cadeia completa de pagamento.

## Configuração

<Info>
  Na documentação técnica, esse limite é o campo `time_to_wait_sync` (em segundos). Padrão: `5.0`. Faixa permitida: `0.5` a `30.0`. Referência completa em [Configurações de orquestração](/orchestration/settings#time_to_wait_sync).
</Info>

`202` não significa falha — significa que o gateway ainda não respondeu dentro do limite. O estado `processing` é transitório e existe apenas na resposta HTTP; veja [Status das transações](/status-codes) para o mapeamento completo de estados.

## Próximos passos

* [Modos de resposta](/concepts/response-modes) — escolha entre aguardar ou responder de imediato.
* [Configurações de orquestração](/orchestration/settings) — referência técnica do campo `time_to_wait_sync`.
* [Webhooks](/concepts/webhooks) — como o resultado final chega quando o limite é ultrapassado.