New Pix integration at Cielo

✅

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

Pix at Cielo

When you use Pix, the transmission of the payment order and the availability of funds to the recipient occur in real time, 24 hours a day, without the need for intermediaries. Therefore, it enables fast payments with lower transaction costs.

Pix update at Cielo

Cielo is offering a new integration with Pix for e-commerce. The main updates involve the provider's value, the QR Code expiration time, and the returned fields:

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

⚠️

Field may vary depending on the operation. See the field updates

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": "123456789asdf",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "066...",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "Pix",
        "Provider": "Cielo2",
        "Amount": 100,
        "QrCode": {
            "Expiration": 86400
        }
    }
}

ℹ️

API operations

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