PortuguêsConceitosStatus

Status de transação

A API INFI retorna o status no campo status de toda transação. Os valores possíveis dependem do tipo (pix_in para cobranças, withdrawal para saques).

Cobrança (type: "pix_in")

StatusSignificado
pendingCobrança criada. Aguarda pagamento do cliente.
Pagamento confirmado e creditado em saldo.
failedFalha reportada pelo provedor.
expiredExpirou antes de ser paga.
cancelledCancelada.
refundedEstorno total. Saldo do lojista é debitado.
partially_refundedEstorno parcial. refundedAmountCents indica quanto já foi devolvido. Pode receber mais estornos.
chargebackContestação aplicada — saldo do lojista debitado.

Saque (type: "withdrawal")

StatusSignificado
pending_approvalAprovação manual habilitada para esta conta. Aguarda revisão da equipe da INFI. Saldo não foi debitado.
pendingAceito, em validação inicial. Saldo já debitado em modo automático.
processing_debitSaque aprovado manualmente — saldo acabou de ser debitado, prestes a ser enviado ao provedor.
processingProvedor confirmou o recebimento da ordem. Aguardando liquidação.
Liquidado para o destinatário.
failedFalhou. Saldo retornou à conta.
cancelled / rejectedSaque cancelado/rejeitado. Saldo retornou.
failed_unknownEstado indeterminado — provedor pode ou não ter processado. Saldo permanece debitado. Status final em até 24h.
transfer_refundedSaque já liquidado teve devolução do destinatário (PIX Reversal). Saldo re-creditado integralmente.
transfer_partially_refundedDevolução parcial do destinatário.

Transições típicas

Cobrança:

  • pending → paid (caminho feliz).
  • pending → expired ou cancelled.
  • paid → refunded ou partially_refunded (estorno).
  • paid → chargeback (contestação).

Saque:

  • pending → processing → paid (modo automático).
  • pending_approval → processing_debit → processing → paid (modo manual).
  • pending / processing → failed / cancelled / rejected (saldo devolvido).
  • paid → transfer_refunded (destinatário devolveu).
  • processing → failed_unknown (estado indeterminado — exige reconciliação).

paid, failed, cancelled, rejected, chargeback são finais. refunded e transfer_refunded também — uma vez total, não recebe mais.

failed_unknown

Em saques, se o provedor ficou em estado indeterminado (timeout, resposta ambígua), a INFI:

  1. Não devolve o saldo automaticamente.
  2. Retorna HTTP 202 com status: "failed_unknown".
  3. Reconcilia com o provedor em até 24h e atualiza para paid ou failed.

Não duplique a operação — a chave PIX pode ter sido enviada. Aguarde a reconciliação ou consulte GET /v1/transactions/:id.

Ciclo de um saqueTaxas