Novos campos na notificação de venda realizada

O gmxCheckout possui uma funcionalidade que permite notificar outros sistemas quando uma venda é realizada. Através dessa funcionalidade o nosso sistema faz uma requisição HTTP/POST para qualquer outro sistema com as informações da venda.

Este recurso é bastante utilizado pelos nossos clientes que possuem suas próprias páginas de pagamento e que estão hospedadas fora da nossa infraestrutura.

Segue um exemplo da página de pagamentos do KlickMembers um cliente gmxCheckout: https://pagamento.ignicaodigital.com.br/klickmembers/expert/

Pagina de pagamento Klickmembers

Pagina de pagamento Klickmembers

Para utilizar esta funcionalidade basta adicionar um campo hidden contendo a URI (Universal Resource Identifier) a ser invocada quando uma venda for processada. Até mesmo as vendas reprovadas são notificadas através desse mecanismo. Segue um exemplo de como utilizar essa funcionalidade abaixo.

Codigo-fonte exemplo de formulario de pagamento do gmxCheckout

Código-fonte exemplo de formulário de pagamento do gmxCheckout

As seguintes informações são enviadas para o destino HTTP definido no campo venda.urlCampainha

venda.dataRegistro – data do processamento da venda no formato dd/MM/yyyy. Alfa-numérico.
venda.valor – valor cobrado do cliente no formato String e sem ponto (ex: 12345 significando R$ 123,45).
venda.valorCobrado – valor cobrado do cliente no formato numérico (ex: 123.45 significando R$ 123,45).
venda.idVenda – número identificador da venda no gmxCheckout. Numérico.
venda.idVendaEmpresa – número identificador da venda no sistema do cliente. Alfa-numérico.
venda.status – Estado do processamento na adquirente: APROVADA: 5, REPROVADA = 6, CAPTURADA = 1, ERRO DE COMUNICAÇÃO = 7. Numérico.
venda.tid – ID da Transação (CIELO) ou código de autorização (REDE). Idenfica unicamente a transação na adquirente. Alfa-numérico.
venda.nsu – NSU (CIELO) ou NUMCV (REDE) controle interno da adquirente, utilizado para agrupar lógicamente as transações. É informado pela adquirente para transações APROVADAS ou CAPTURADAS.
venda.lr – Código que informa a razão da reprovação de uma transação. Teremos um novo post para isso em breve para CIELO e REDE. Numérico.
venda.lrDescricao – Descrição da causa da reprovação de uma transação.
venda.lrOrientacao – Orientacao para o cliente que está efetuando a tentativa de pagamento.
venda.cartaoCredito.numeroMask – Número do cartão de crédito, com apenas os 4 últimos dígitos.
venda.formaPagamento – Bandeira do cartão de Crédito utilizado
venda.cliente.idClienteEmpresa – Número identificador do cliente no sistema do cliente
venda.msgErro – Mensagem de erro, se ocorrer algum problema com o processamento da transação. A descrição e a orientação LR são acrescentadas a esse campo.

Atendendo a pedidos, acrescentamos mais dois campos que estão presentes na resposta da CIELO e deixamos a disposição dos nossos clientes.

venda.arp – Código de autorização retornado pelo banco emissor do cartão.
venda.eci – Eletronic Commerce Indicator. Retornado apenas pela CIELO. Representa o quão segura é uma transação. Esse valor deve ser levado em consideração pelo cliente para decidir sobre a captura da transação.

Seguem os possíveis valores que esse campo pode assumir:

AUTENTICADO = 1: O consumidor digitou os dados do cartão, foi encaminhado para o sistema de autenticação do banco e digitou a senha do cartão corretamente.

BANCO EMISSOR NÃO SUPORTA = 2: O banco emissor do cartão de crédito não tem suporte a autenticação via Internet

AUTORIZADO SEM AUTENTICAÇÃO = 3: O cliente gmxCheckout optou por não solicitar a Autenticação da transação, aprovando sem a necessidade de senha. É o caso mais comum.

AUTENTICAÇÃO FALHOU = 4: O consumidor digitou os dados do cartão, foi encaminhado para o sistema de autenticação do banco e digitou a senha do cartão porém a senha não confere com a senha do cartão.

Mas o que significa Captura ?

Uma transação com cartão de crédito possui duas fases distintas:

  1. Autorização: A transação, com as informações do cartão de crédito e do pedido, é submetida para a adquirente. A adquirente irá verificar a validade do cartão e a existência de limite para a compra. Havendo limite, este é alocado para esta compra e a transação entra no estado AUTORIZADA. Transações podem permanecer nesse estado por até 5 dias na CIELO e até as 23:59 do dia atual na REDE. Um fato muito importante é que caso a transação não seja capturada até o prazo máximo acima, a mesma será automaticamente cancelada pelo banco emissor e o limite alocado se torna disponível novamente para o cliente.
  2. Captura: A transação autorizada pode ser capturada e o débito no cartão de crédito do cliente é confirmado. Este é o estágio final e confirma de fato a compra.

O padrão do gmxCheckout é operar com a Captura Automática, a menos que o cliente queira que a transação seja apenas autorizada num primeiro momento e depois capturada.

Voltando aos novos campos: Considerando uma transação com captura manual e havendo a falha de autenticação no cartão, o cliente gmxCheckout pode optar por não capturar a transação e não aprovar a venda. Transações autenticadas são menos suscetíveis a contestações junto aos bancos emissores.