Atualizações nos campos Pix

Válido para a integração com o provedor "Cielo2".

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

O Pix na Cielo foi atualizado e recomendamos migrar para a nova integração. As principais atualizações são:

  • Será necessário enviar o Payment.Provider com o valor Cielo2;
  • 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.

Campos retornados na geração de QR Code Pix

Confira a relação das atualizações nos campos retornados na geração de QR Code Pix:

CamposIntegração anteriorIntegração nova (Cielo2)
Payment.QrCode.ExpirationNão existia. Anteriormente o tempo padrão de expiração do QR Code Pix era de duas horas.Representa o tempo de expiração do QR Code Pix em segundos e pode ser determinado pela loja. Caso não seja informado, o tempo de expiração padrão será de 24 horas.
TidRepresentava o ID do QR Code.Não existe mais.
ProofOfSaleRepresentava o NSU do Pix.Não existe mais.
SentOrderIdRepresentava o Ecommerce Order IdPassou a representar o txid.

Os demais campos se mantém iguais.

Campos retornados na consulta de uma transação Pix

Confira a relação das atualizações nos campos retornados na consulta de uma transação Pix:

CamposIntegração anteriorIntegração nova (Cielo2)
AcquirerOrderIdRepresentava o Ecommerce Order IdPassou a representar o txid
TidRepresentava o ID do QR Code.Não existe mais.
ProofOfSaleRepresentava o NSU do Pix.Não existe mais.
EndToEndIdNão existia.Representa o identificador do Pix pago.

Os demais campos se mantém iguais.

Campos retornados na devolução de um Pix

Confira a relação das atualizações nos campos retornados na devolução de um Pix:

CamposIntegração anteriorIntegração nova (Cielo2)
TidRepresentava o ID do QR Code.Não existe mais.
ProofOfSaleRepresentava o NSU do Pix.Não existe mais.
AuthorizationCodeNão existia.Representa o EndToEndId da transação Pix.