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
Transitions
Creation and confirmation
The transaction is created in thepending 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
Thepaid 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
Monitoring
It is recommended that the integration consider the payment confirmed only upon receipt of thetransaction_paid event. The GET /v1/transactions/{transactionId} operation returns the current status of a transaction, and the GET /v1/transactions operation lists the transactions of the account, filtered by status, payment method and period, which enables periodic reconciliation.