ℹ️

Saiba mais sobre essa funcionalidade na documentação.

Atenção

• Se as suas transações forem uma chamada conjunta com o Antifraude, os tamanhos de campos podem ser diferentes. Consulte o tópico Pagamento com Análise de Fraude;

• O campo Payment.ServiceTaxAmount é exclusivo para companhias aéreas e agências de turismo. Para as companhias aéreas, permite a cobrança da taxa de embarque separadamente do valor da passagem aérea. Já para as agências de turismo, é utilizado especialmente para a cobrança de taxas na primeira parcela;

• As bandeiras JCB e Diners são estrangeiras e não permitem parcelamento no cartão de crédito;

• Os parâmetros contidos dentro dos nós Address e DeliveryAddress são de preenchimento obrigatório quando a transação é submetida ao Antifraude ou à análise do Velocity;

• O número de identificação do pedido (MerchantOrderId) não sofre alteração ao longo do fluxo transacional. Contudo, um novo número (SentOrderId) pode ser gerado para o pedido e utilizado durante a transação. Esse número só será diferente se:

  • o MerchantOrderID enviado estiver fora das especificações descritas no campo;
  • o MerchantOrderID enviado já foi utilizado nas últimas 24 horas.

ℹ️

CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026

Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.

O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.

Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.

Autenticação 3DS nas transações de cartão de crédito

A autenticação 3DS é opcional para as transações de cartão crédito.

Se a sua loja tem integração com o protocolo 3DS para autenticação do portador do cartão, atente-se aos parâmetros que devem ser informados na requisição:

• Envie o parâmetro Payment.Authenticate = "true";
• Informe os dados recebidos na saída do script do 3DS no nó Payment.ExternalAuthentication;
• Em transações com autenticação 3DS Data Only, informe o parâmetro ExternalAuthentication.DataOnly como true.
• Para confirmar se a autenticação foi acatada na autorização, verifique o valor do ECI retornado em Payment.Eci. A API replica o ECI informado pela loja no campo Payment.ExternalAuthentication. No entanto, o valor efetivamente utilizado pela bandeira na autorização é o que aparece em Payment.Eci.

ℹ️

Importante

A validação e o retorno do campo Payment.Eci ocorrem apenas no ambiente de produção neste primeiro momento.

Visa Intelligent Data Exchange (IDX)

Caso use o serviço de autenticação IDX da Visa, veja Visa Intelligent Data Exchange (IDX)

Resposta da transação de cartão de crédito

A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento com cartão de crédito.