Skip to main content
As configurações ficam no painel na página Orquestração. 
{
  "time_to_wait_sync": 6.0,
  "default_response": "sync",
  "retry_failed_payments": true,
  "max_retry_attempt": 3
}

​
time_to_wait_sync

Controla por quanto tempo (em segundos) o servidor aguarda a resposta do gateway antes de devolver uma resposta HTTP ao cliente. O que acontece internamente: 
Requisição chega
    ↓
Coroutine criada — processa o pagamento em paralelo
    ↓
Servidor aguarda até time_to_wait_sync segundos
    ↓
Gateway respondeu a tempo?
    SIM → 201 com resultado completo (approved / failed)
    NÃO → 202 com transaction_id ("pagamento em processamento")
              ↓
           Gateway responde depois → webhook entregue ao seu servidor
ValorComportamento
Padrão5.0 segundos
Mínimo0.5 segundos
Máximo30.0 segundos
O 202 não significa falha — significa que o gateway ainda não respondeu. O resultado final sempre chega via webhook.

​
default_response

Define o modo padrão de resposta independentemente do tempo de espera.
ValorComportamento
sync (padrão)Aguarda até time_to_wait_sync — pode retornar 201 ou 202
asyncRetorna 202 imediatamente, sem aguardar o gateway
Use async quando a latência de resposta for crítica e seu sistema já está preparado para receber o resultado via webhook.

​
retry_failed_payments e max_retry_attempt

Controlam o comportamento de retentativa automática quando um gateway recusa o pagamento.
CampoPadrãoRangeDescrição
retry_failed_paymentstrue—Habilita retentativas automáticas em caso de falha
max_retry_attempt51–10Número máximo de tentativas por transação
Cada retentativa seleciona o próximo gateway disponível usando a mesma lógica de roteamento (percentual → ordem). O resultado de cada tentativa fica registrado no array transactions[] da resposta. Não são refeitas retentativas para os seguintes motivos de recusa:
  • expired_card — cartão vencido
  • insufficient_founds — saldo insuficiente
Nesses casos, uma nova tentativa no mesmo ou em outro gateway resultaria na mesma recusa, então o sistema interrompe imediatamente.