Transaction lifecycle

Statuses of a transaction, permitted transitions and associated events.

Every charge created gives rise to a transaction. The status field reports the current status of the transaction, which changes as a result of acts of the payer, the acquirer, the banking system or the integrator itself. Relevant transitions are communicated by notification.

​

Statuses

Status	Description
pending	Charge created, awaiting payment. Initial status of every transaction.
waiting	Transaction awaiting an external act or event.
paid	Payment confirmed.
refused	Payment declined. For cards, the refuseReason field states the reason.
expired	Charge past due without payment.
canceled	Transaction canceled.
error	Failure in processing the payment.
refund	Amount returned to the payer.
infraction	Paid Pix transaction under analysis of an infraction report.
contest	Payment under dispute.
chargeback	Payment reversed as a result of an upheld dispute.

​

Transitions

​

Creation and confirmation

The transaction is created in the pending status. For Pix and boleto, it remains in that status until the payment is settled, when it moves to paid, or until the due date. For credit card, the response to the creation already contains the outcome of the authorization, paid or refused, with the pending status possible while the acquirer completes processing.

Once the payment is confirmed, the net amount is credited to the account balance according to the settlement period applicable to the payment method, as described in Balance and transfers.

​

Events after payment

The paid status is not final. Three kinds of event may change it.

A refund, at the integrator’s initiative or at the payer’s request, moves the transaction to the refund status.

An infraction report on a Pix transaction moves the transaction to the infraction status and results in the precautionary block of the amount. Once the analysis is concluded, the transaction returns to paid, if the infraction is rejected or cancelled, or moves to refund, if it is upheld.

A dispute over a payment moves the transaction to the contest status and, if upheld, to the chargeback status.

​

Associated events

Transition	Event notified
Creation of the transaction	transaction_created
Confirmation of payment	transaction_paid
Declined card payment	card_declined
Refund request by the payer	refund_requested
Return of the amount	transaction_refunded
Opening or update of an infraction	infraction
Other status changes	transaction_updated

​

Monitoring

It is recommended that the integration consider the payment confirmed only upon receipt of the transaction_paid event. The GET /transactions/{transactionId} operation returns the current status of a transaction, and the GET /transactions operation lists the transactions of the account, filtered by status, payment method and period, which enables periodic reconciliation.