Transações

Status

O campo status indica em que etapa a transação está. Cada mudança de status relevante gera um webhook transaction.<status>.
StatusPIX_IN (cobrança)PIX_OUT (saque)Final?
PendenteAguardando pagamento.—Não
Em análise—Em análise manual pela equipe Reload Bank.Não
Processando—Enviado à instituição parceira, aguardando liquidação.Não
PagoPago; líquido no saldo disponível.—Sim
Concluído—PIX liquidado no destino.Sim
Falhou—Não concluído; valor + taxa devolvidos.Sim
Cancelado—Recusado na análise; valor + taxa devolvidos.Sim
ExpiradoPrazo de pagamento esgotado.—Sim*

* Se a instituição parceira confirmar um pagamento feito logo após o vencimento, a cobrança passa de EXPIRED para PAID e o webhook transaction.paid é enviado normalmente.

Transições possíveis

PIX_IN PENDING → PAID | EXPIRED

PIX_OUT AWAITING_APPROVAL → PROCESSING → COMPLETED | FAILED
AWAITING_APPROVAL → CANCELED
PROCESSING → COMPLETED | FAILED

  • Saques FAILED e CANCELED devolvem automaticamente o valor e a taxa ao saldo disponível.
  • Trate qualquer status desconhecido de forma defensiva: novos status podem ser adicionados no futuro.