Learn more about this feature in the documentation.
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. |