Skip to main content
Transfer Status Reconciliation é a rotina periódica que corrige drift entre Transfer e o provider de billing.

​
Objetivo

A rotina garante que saques pendentes ou em processamento sejam atualizados mesmo quando o webhook de resultado atrasar ou falhar.

​
Execução

Ao rodar, a rotina:
  1. Busca transferências com status = PENDING ou status = PROCESSING.
  2. Consulta o provider usando externalProvider e externalProviderId.
  3. Atualiza status para PAID, FAILED ou CANCELED, quando o provider indicar status terminal.
  4. Preenche transferredAt quando a transferência for efetivada.

​
Regras

RegraComportamento
Fonte externaO provider é a fonte de verdade para o resultado da transferência.
Estados terminaisTransferências PAID, FAILED ou CANCELED não são reconciliadas novamente.
SaldoA rotina não calcula saldo disponível; saldo continua vindo do provider.
IdempotênciaA mesma transferência pode ser consultada mais de uma vez sem duplicar mutações.
EscopoA rotina atua apenas em transferências persistidas no DEVMOB.