Criar pagamento com cartão de crédito

ℹ️

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.

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.

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.