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>.* 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
PIX_OUT AWAITING_APPROVAL → CANCELED
PIX_OUT PROCESSING → COMPLETED | FAILED
- Saques
FAILEDeCANCELEDdevolvem automaticamente o valor e a taxa ao saldo disponível. - Trate qualquer status desconhecido de forma defensiva: novos status podem ser adicionados no futuro.