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
SentOrderIdfield (payment order creation identifier, represents 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
Check the list of updates to the fields returned when generating a Pix QR Code:
| Fields | Previous integration | New integration (Cielo2) |
|---|---|---|
AcquirerOrderId | Represented the QR Code ID. | No longer exists. |
ProofOfSale | Represented the Pix NSU. | No longer exists. |
SentOrderId | Represented the MerchantOrderId. | Now represents the txid. |
All other fields remain the same.
Fields returned when querying a Pix transaction
Check the list of updates to the fields returned when querying a Pix transaction:
| Fields | Previous integration | New integration (Cielo2) |
|---|---|---|
SentOrderId | Represented the MerchantOrderId. | Now represents the txid. |
AcquirerTransactionId | 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. |
All other fields remain the same.
Fields returned when refunding a Pix
There were no updates to the fields returned when refunding a Pix.