Transaction status (payment

About payment statuses

What it is: payment_status is the field that indicates the current state of a transaction in Link de Pagamento and Checkout Cielo.
Where it appears:
- In status change notifications (via POST and JSON), as the payment_status field with an integer numeric value.
- In the content of transaction completion notifications.
- In transaction queries (GET by checkout_cielo_order_number or by payment link ID), it returns as English text in the payment.status field.
What it represents: represents the stage in the transaction lifecycle — from the initial state (authorized or pending) to final states (paid, denied, voided, expired).

Important: Link de Pagamento and Checkout Cielo have their own statuses, different from those on the Cielo website or in API E-commerce Cielo.

VALUE	TRANSACTION STATUS	PAYMENT METHODS	DESCRIPTION
1	Pending	Boleto, Pix and QR Code	Indicates that the payment is still being processed or is pending some step by the cardholder. Example: a boleto transaction with Pending status indicates that the boleto status has not been changed by the shopper.
2	Paid	All payment methods	Transaction was captured and money will be deposited into account.
3	Denied	Credit and debit cards	Transaction not authorized by the person responsible for the payment method.
4	Expired	Credit, debit and boleto cards	Credit and debit cards: the transaction is no longer valid for capture 15 days after authorization. Boleto: the boleto expires after the expiration date set by the Cielo E-commerce Support team at the merchant's request.
5	Voided	Credit and debit cards	Transaction canceled by the merchant.
6	NotFinalized	All payment methods	Payment awaiting new Status. This may indicate an error or processing failure. Contact Cielo E-commerce Support.
7	Authorized	Credit and debit cards	Transaction authorized by the card issuer. It must be captured for the money to be deposited in the account (by default, the transaction can be captured up to 15 days after authorization).
10	AuthorizedIdPayPending	Credit card	Indicates that facial biometrics are pending. The shopper has up to one hour to authenticate. This status will be updated after authentication to 2 (paid) or 3 (denied).If authentication does not take place, it will be changed to 5 (canceled).

Note: For order queries, the payment.status field will be returned in text format, always in English (Transaction Status column).

Monitor the payment_status field in two scenarios:

Notifications: Cielo sends a status change notification whenever the payment_status of a transaction changes. When you receive it, query the full transaction details using the checkout_cielo_order_number.
- POST notification: payment_status returns as an integer.
- JSON notification: the notification contains the query URL. Send a GET request to that URL to get the payment_status and other details.
Direct queries: in the responses of transaction queries (GET by checkout_cielo_order_number or GET by payment link ID), the payment.status field returns as English text (for example, "Paid", "Denied").

Implement the order update logic in the merchant system based on the status transitions received.

Successful / positive final
- 2 — Paid: flow completed successfully. Credit confirmed.
Transitional / pending — requires monitoring
- 1 — Pending: awaiting cardholder action (boleto not paid, Pix not completed, QR Code not scanned).
- 7 — Authorized: transaction approved by the issuer, awaiting capture by the merchant (valid for up to 15 days).
- 10 — Awaiting facial biometrics (AuthorizedIdPayPending): authentication pending; wait for transition to 2, 3, or 5.
Final / negative termination
- 3 — Denied: transaction refused. Cannot be retried.
- 4 — Expired: capture or payment deadline expired.
- 5 — Voided: transaction voided by the merchant.
Error / undetermined
- 6 — Not Finalized (NotFinalized): processing failure. Contact Cielo E-commerce Support.

In notifications (POST and JSON), payment_status returns as an integer.
In transaction queries (GET), the payment.status field returns as English text (see the Status (EN) column in the table above), for example, "Paid", "Authorized".
To get full transaction details when you receive a status change notification, use the checkout_cielo_order_number to send a GET query.
The status change notification can take up to 3 minutes to be sent after the transaction completion notification.