EnglishConceptsStatus

Transaction status

The INFI API returns the status in the status field of every transaction. The possible values depend on the type (pix_in for charges, withdrawal for withdrawals).

Charge (type: "pix_in")

StatusMeaning
pendingCharge created. Awaiting customer payment.
Payment confirmed and credited to balance.
failedFailure reported by the provider.
expiredExpired before being paid.
cancelledCancelled.
refundedFull refund. Merchant balance is debited.
partially_refundedPartial refund. refundedAmountCents indicates how much has been returned. May receive more refunds.
chargebackChargeback applied — merchant balance debited.

Withdrawal (type: "withdrawal")

StatusMeaning
pending_approvalManual approval enabled for this account. Awaits review by the INFI team. Balance has not been debited.
pendingAccepted, in initial validation. Balance already debited in automatic mode.
processing_debitWithdrawal approved manually — balance just got debited, about to be sent to the provider.
processingThe provider confirmed receipt of the order. Awaiting settlement.
Settled to the recipient.
failedFailed. Balance returned to the account.
cancelled / rejectedWithdrawal cancelled/rejected. Balance returned.
failed_unknownIndeterminate state — the provider may or may not have processed it. Balance remains debited. Final status within 24h.
transfer_refundedAn already-settled withdrawal was returned by the recipient (PIX Reversal). Balance re-credited in full.
transfer_partially_refundedPartial return by the recipient.

Typical transitions

Charge:

  • pending → paid (happy path).
  • pending → expired or cancelled.
  • paid → refunded or partially_refunded (refund).
  • paid → chargeback.

Withdrawal:

  • pending → processing → paid (automatic mode).
  • pending_approval → processing_debit → processing → paid (manual mode).
  • pending / processing → failed / cancelled / rejected (balance returned).
  • paid → transfer_refunded (recipient returned).
  • processing → failed_unknown (indeterminate — requires reconciliation).

paid, failed, cancelled, rejected, chargeback are final. refunded and transfer_refunded are also final — once total, no further refund.

failed_unknown

For withdrawals, if the provider ended up in an indeterminate state (timeout, ambiguous response), INFI:

  1. Does not auto-return the balance.
  2. Returns HTTP 202 with status: "failed_unknown".
  3. Reconciles with the provider within 24h and updates to paid or failed.

Do not duplicate the operation — the PIX key may have been sent. Wait for reconciliation or query GET /v1/transactions/:id.

Withdrawal lifecycleFees