New Pix integration at Cielo

✅

This is the new Pix integration you should follow starting from 09/01.

Pix at Cielo

With Pix, the payment order transmission and fund availability for the receiver occur in real time, 24/7, without the need for intermediaries. This enables fast payments with lower transaction costs.

Pix update at Cielo

Cielo is providing a new integration with Pix for e-commerce. The main updates are in the provider value, QR Code expiration time, and returned fields:

• You must send Payment.Provider with the value Cielo2;
• The QR Code expiration time, previously two hours, can now be configured by the store using the Payment.QrCodeExpiration field;
• Payment identification: the payment will be identified by the SentOrderId field (payment order creation identifier, represents the txid) and EndToEndId (identifier of the paid Pix);
• Pix transaction reconciliation: with the latest updates, the merchant can use the values of EndToEndId and txid for reconciliation.

⚠️

Fields may appear differently depending on the operation. See the field updates in the API Reference.

How to update the Pix provider at Cielo

To update the Pix provider at Cielo, you must send the Payment.Provider field with the value Cielo2. Here's an example of the minimal request structure for creating a Pix QR Code after updating the provider:

{
    "MerchantOrderId": "1234567890",
    "Customer": {
        "Name": "Lorem Ipsum",
        "Identity": "077...",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "Pix",
        "Amount": 100,
        "Provider": "Cielo2"       
    }
}

ℹ️

API Operations

• Create a Pix QR Code;
• Remove a Pix QR Code;
• Get details on a Pix transaction;
• Request a Pix refund;
• Updates on Pix fields.

ℹ️

The new Pix integration does not yet have a sandbox environment available.