Valid for integration with the "Cielo2" provider.
Learn more about this feature in the documentation.
New Pix integration at Cielo
Starting from 09/01/2025, new Pix integrations will be made with the new Pix provider at Cielo, Cielo2. Learn more about the new Pix integration at Cielo.
Pix at Cielo has been updated, and we recommend migrating to the new integration. The main updates are:
- You must send
Payment.Providerwith the value Cielo2; - Payment identification: the payment will be identified by the fields
SentOrderIdandAcquirerOrderId(payment order creation identifiers, representing thetxid) andEndToEndId(identifier of the paid Pix); - Pix transaction reconciliation: with the latest updates, the merchant can use the values of
EndToEndIdandtxidfor reconciliation.
Fields returned when creating a Pix QR Code
See the list of updates to the fields returned when creating a Pix QR Code:
| Fields | Previous integration | New integration (Cielo2) |
|---|---|---|
Payment.QrCode.Expiration | Did not exist. Previously, the default expiration time for the Pix QR Code was two hours. | Represents the expiration time of the Pix QR Code in seconds and can be set by the merchant. If not specified, the default expiration time will be 24 hours. |
Tid | Represented the QR Code ID. | No longer exists. |
ProofOfSale | Represented the Pix NSU. | No longer exists. |
SentOrderId | Represented the Ecommerce Order Id. | Now represents the txid. |
All other fields remain unchanged.
Fields returned when querying a Pix transaction
See the list of updates to the fields returned when querying a Pix transaction:
| Fields | Previous integration | New integration (Cielo2) |
|---|---|---|
AcquirerOrderId | Represented the Ecommerce Order Id | Now represents the txid |
Tid | Represented the QR Code ID. | No longer exists. |
ProofOfSale | Represented the Pix NSU. | No longer exists. |
EndToEndId | Did not exist. | Represents the identifier of the paid Pix. |
The other fields remain unchanged.
Fields returned in a Pix refund
See the list of updates to the fields returned during a Pix refund:
| Fields | Previous integration | New integration (Cielo2) |
|---|---|---|
Tid | Represented the QR Code ID. | No longer exists. |
ProofOfSale | Represented the Pix NSU. | No longer exists. |
AuthorizationCode | Did not exist. | Represents the Pix transaction EndToEndId. |