Nova integração do Pix na Cielo

ℹ️

As informações dessa página são referentes à nova integração de Pix na Cielo.

Pix na Cielo

No Pix, a transmissão da ordem de pagamento e a disponibilidade de fundos para o recebedor ocorrem em tempo real, 24 horas por dia e sem a necessidade de intermediários. Sendo assim, é um meio que viabiliza pagamentos rápidos e com menores custos de transação.

Atualização do Pix na Cielo

A Cielo está disponibilizando uma nova integração com o Pix para o e-commerce. As principais novidades estão no valor do provedor, no tempo de expiração do QR Code e nos campos retornados:

• Será necessário enviar o Payment.Provider com o valor Cielo2;
• O tempo de expiração do QR Code, que anteriormente era de duas horas, poderá ser configurado pela loja no campo Payment.QrCode.Expiration;
• Identificação do pagamento: o pagamento será identificado pelos campos SentOrderId e AcquirerOrderId (identificadores de criação de pedido de pagamento, representam o txid) e EndToEndId (identificador do Pix pago);
• Conciliação das transações Pix: com as últimas atualizações, a loja poderá usar os valores de EndToEndId e txid para a conciliação.

⚠️

Os campos podem aparecer de formas diferentes dependendo da operação, veja as atualizações dos campos na Referência da API.

Como atualizar o provedor do Pix na Cielo

Para atualizar o provedor de Pix na Cielo, é necessário enviar o campo Payment.Provider com o valor Cielo2. Veja como deve ficar a requisição de geração de QR Code Pix após a atualização do provedor:

{
    "MerchantOrderId": "123456789asdf",
    "Customer": {
        "Name": "Lorem Ipsum",
        "Identity": "066...",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "Pix",
        "Provider": "Cielo2",
        "Amount": 100,
        "QrCode": {
            "Expiration": 86400
        }
    }
}

ℹ️

Operações da API

• Gerar QR Code Pix;
• Remover um QR Code Pix;
• Consultar uma transação Pix;
• Solicitar devolução de transação Pix;
• Atualizações nos campos Pix.