Introdução Configurações Komerci SecureCode Fluxo de Transação Redecard Código de verificação...

Transcrição

1

2 Introdução Configurações Komerci SecureCode Fluxo de Transação Loja-virtual 2. Redecard Redecard Código de verificação Modelo de Código-fonte Tela de captura Loja-virtual Tabela de Códigos e Mensagens de Retorno Loja-virtual Redecard Redecard Loja-virtual Loja-Virtual Redecard Comprovante de Venda Dicas de segurança... 26

3 Teste na Loja-Virtual Gerenciamento de Vendas Importante Anexo Guia de Edição Suporte Técnico

4 Este manual irá auxiliá-lo na configuração do acesso ao Komerci, bem como na utilização de todos os recursos e facilidades proporcionadas pelo produto. O estabelecimento deverá desenvolver uma rotina própria para a utilização do Komerci em sua loja-virtual, seguindo, entretanto, os padrões definidos neste documento. O conhecimento de versões anteriores do Komerci não desobriga a leitura deste documento. Configuração mínima de hardware e software -Processador 486 DX2-50 Mhz-16 Mb de memória RAM-32 Mb de espaço livre em disco rígido-modem de bps-mouse-plataforma Windows 95/98/NT/2000, Linux, AIX, Sun Solaris, OS/390 ou AS/400.) Versões certificadas -Netscape Navigator 4.0, Internet Explorer 4.0 (ou versões superiores) e alguns outros browsers -JDK (ou versões superiores) Certificado necessário -SSL 128 bits Sugestão de fornecedores do Certificado SSL 128 bits -

5 O SecureCode é a mais nova solução de autenticação da MasterCard desenvolvida na plataforma Komerci para trazer mais segurança à indústria do cartão como um todo. O principal benefício do Komerci SecureCode é transformar transações remotas em transações de cartão presente, mediante autenticação do portador. A autenticação do SecureCode ocorre via módulo desenvolvido pelo emissor (ex: Internet Banking). Transações de cartão presente são garantidas para o estabelecimento desde que seja retornado o parâmetro referente a autenticação e, portanto, estão sujeitas às mesmas regras de Chargeback do mundo físico. Uma vez que a loja-virtual possua o Komerci, o SecureCode será automático. O SecureCode será habilitado após contratação do Serviço para transações de cartões cujos BINs (6 primeiros dígitos do cartão) tiverem sido homologados pelos seus emissores. Para transações sem SecureCode, o fluxo ocorrerá de forma tradicional. O SecureCode traz consigo uma série de novidades gráficas, de navegação e no fluxo de parâmetros do Komerci. As modificações gráficas e de navegação são automáticas. As alterações no fluxo de parâmetros são opcionais e caso sejam implantadas, garantem mais ferramentas de controle à loja-virtual, agregando ainda mais valor à tecnologia Komerci. Todas as alterações específicas do SecureCode estão demarcadas em vermelho ao longo deste documento. O SecureCode é uma solução desenvolvida em parceria com a MasterCard e, portanto, só se aplica a esta bandeira. Desta forma, o fluxo de transações da bandeira Diners permanece inalterado. E cartão que não são contemplados neste programa e que serão retornados com NUMPRG 0

6 Check-out da Loja-Virtual: A ilustração abaixo é um modelo de loja virtual após a seleção dos itens desejados na compra: Recomenda-se que na forma de pagamento sejam exibidas as opções MasterCard, MasterCard SecureCode e Diners, assim grafadas. As bandeiras MasterCard e MasterCard SecureCode deverão exibir a mesma tela (vide item Primeira Tela Padrão do tópico Tela de Captura localizado neste documento). A diferenciação destas duas logomarcas advém do plano de comunicação trabalhado pela bandeira junto aos portadores de cartão. Para obter as logomarcas das bandeiras MasterCard, MasterCard SecureCode e Diners, basta efetuar download no Portal Redecard através do link Como produzir materiais de sinalização / Download de logomarcas localizado no quadro Dicas e Dúvidas da home-page do Portal Redecard (

7 Etapas do Fluxo: Estas são as etapas do fluxo de dados permutados entre a Redecard e a loja-virtual durante o processo de captura de uma transação. Cada uma das etapas será detalhada a seguir. * Esta etapa será enviada para o portador do cartão, por meio da loja -virtual. Descrição das Etapas: Etapas 1 e 2: 1- Solicitação de autorização 2- Retorno de Autorização Etapas 3 e 4: 3 Solicitação de confirmação 4 Retorno de confirmação Etapa 5 e 6: 5- Solicitação do Comprovante de Vendas 6- Retorna Comprovante de vendas para portador 1. Loja-virtual Redecard A loja virtual deverá enviar os seguintes parâmetros para a Redecard, quando da chamada para a tela de captura do Komerci: NOME TAMANHO DESCRIÇÃO TOTAL 15 Valor total da compra TRANSACAO 2 Código do tipo de transação PARCELAS 2 Número de parcelas FILIACAO 9 Número de filiação do estabelecimento (fornecedor)

8 DISTRIBUIDOR 9 Número de filiação do estabelecimento (distribuidor) BANDEIRA 10 Bandeira do cartão NUMPEDIDO 16 Número do pedido PAX1 26 Texto livre para digitação CODVER 25 Código de Verificação URLBACK 250 Endereço para retorno dos dados da transação URLCIMA 250 Endereço de URL da página ou imagem superior TARGET 40 Nome do frame para onde será retornado a URLBACK TOTAL O parâmetro TOTAL deverá conter o valor da transação separado por. (ponto). Exemplo: É obrigatória a existência de duas casas decimais. TRANSAÇÃO O parâmetro TRANSACAO deverá conter o código do tipo de transação a ser processada, de acordo com a tabela a seguir: Tipo de Transação Código À vista 04 Parcelado Emissor 06 Parcelado Estabelecimento 08 PARCELAS O parâmetro PARCELAS deverá conter o nº de parcelas da transação. Ele deverá ser preenchido com o valor 00 (zero zero) quando o parâmetro TRANSACAO for 04, isto é, à vista. FILIAÇÃO O parâmetro FILIACAO deverá conter o nº de filiação do estabelecimento cadastrado junto a Redecard. DISTRIBUIDOR O parâmetro DISTRIBUIDOR" deverá conter o nº de filiação do estabelecimento distribuidor. Este parâmetro só deverá ser preenchido se o estabelecimento do campo FILIACAO for um fornecedor. BANDEIRA O parâmetro BANDEIRA deverá conter a forma de pagamento solicitada pelo usuário, em caixa alta. As opções oferecidas pelo Komerci são: MASTERCARD e DINERS. Este parâmetro é utilizado apenas para apresentação da logomarca correta na tela de captura do Komerci. Se, porventura, o portador digitar os dados de um cartão de crédito MasterCard na tela de captura Diners, por exemplo, o Comprovante de Vendas será exibido de acordo com o nº do cartão digitado, no caso, MasterCard.

9 NUMPEDIDO O parâmetro NUMPEDIDO deverá conter o nº do pedido referente ao produto / serviço solicitado pelo usuário. Este campo deverá ser preenchido de acordo com a política interna da loja-virtual. PAX1 O parâmetro PAX1 é de preenchimento opcional.caso o número de pedido ultrapasse as 16 posições permitidas para NUMPEDIDO, as demais posições poderão ser incluídas em PAX1. CODVER O parâmetro CODVER deverá conter o código de verificação gerado pelo aplicativo CodVer.class. A instrução para instalação do código está descrita no tópico a seguir. URLBACK O parâmetro URLBACK deverá conter o endereço e página para onde os dados da transação deverão ser retornados. Não ultrapasse as 250 posições permitidas. Não utilize símbolos, pontuações ou caracteres especiais, tais como # & * ^ /?). Como incremento de segurança, a loja-virtual poderá cadastrar previamente uma URLBACK através do portal da Redecard ( Através deste cadastramento prévio, será possível suprimir o envio do parâmetro URLBACK, pois o Komerci sempre retornará os dados das transações para àquele endereço que foi cadastrado no portal. Todos os parâmetros citados nesta etapa do fluxo deverão ser enviados através do método POST, para: 1 URLCIMA O parâmetro URLCIMA deverá conter o endereço da URL (em HTTPS) da página ou imagem a ser carregada na área superior da tela do Komerci (conforme indicado na ilustração abaixo): Seguem abaixo algumas restrições de utilização deste parâmetro:

10 Não ultrapasse as 250 posições permitidas. Não utilize símbolos, pontuações ou caracteres especiais, tais como & * ^?). Caso o estabelecimento deixe de enviar estes parâmetros, ou os envie em branco, o sistema carregará a cor da tela de captura padrão. O tamanho da área que o parâmetro URLCIMA abrange é fixa em 120 X 780 pixels. Este parâmetro está disponível tanto para a bandeira MasterCard quanto para a bandeira Diners. No caso, da bandeira Diners, existem outros parâmetros de customização possíveis de serem editados. Vide tópico Anexo Guia de Edição neste documento. TARGET O parâmetro TARGET é opcional. Ele poderá conter o nome do frame para onde a Redecard retornará a URLBACK. Caso este parâmetro não seja enviado, a Redecard retornará a URLBACK no target top (target= _top ). Este parâmetro só será acatado para transações da bandeira MasterCard inicialmente. Para solicitar a tela de captura do Komerci em outros idiomas, basta substituir este endereço por: INGLÊS: ESPANHOL: Obs: a tela em espanhol só está disponível para a bandeira MasterCard inicialmente).

11 A loja-virtual será responsável por implementar uma rotina (na linguagem em que desejar) para chamar o utilitário Java (CodVer.class) que gera o Código de Verificação, seguindo, entretanto, as instruções aqui dispostas. Pré-requisito do Servidor do Lojista: Interpretador Java (JDK, por exemplo) versão (mínimo) instalado. Sintaxe para chamada do utilitário Java: # java CodVer <numfil> <total> <ip address> Onde: <numfil>: Número de filiação do lojista; <total>: Valor total da compra (formato ###.##) com até 12 caracteres; <ip address>: Endereço IP da máquina do COMPRADOR; Exemplos: # java CodVer # java CodVer A saída poderá ser direcionada para um arquivo: # java CodVer > codver.out O conteúdo deste arquivo será: Uma vez passado os argumentos corretos, será retornado o Código de Verificação. Caso seja digitado apenas: # java CodVer Sem nenhum parâmetro, será exibido um pequeno help. Sugestão para as lojas virtuais que operam com ASP

12 A Redecard disponibiliza para download o arquivo Código de Verificação, a fim de auxiliar o desenvolvedor na integração de sua loja virtual com o ambiente Redecard. Este arquivo contém: -Página ASP integradora-componente ActiveX para geração do código de verificação- Arquivos de suporte ao funcionamento do componente-códigos fonte do componente- Instruções detalhadas O arquivo Código de Verificação está disponível para download no link "Manuais" do Portal Redecard ( Todo e qualquer código fornecido é apenas uma sugestão para desenvolvimento, cabendo ao programador da loja virtual adequá-lo ao seu ambiente. Consulte o tópico Suporte Técnico para obter maiores informações. Este é um modelo de código-fonte que a loja virtual poderá utilizar para fazer a chamada para a tela de captura do Komerci: <HTML> <HEAD> <TITLE>Esta é a sua página de compras</title> <META name="description" content=""> <META name="keywords" content=""> <META name="generator" content="xxxxhtml"> <Script language="javascript"> <!-- function Janela() { vpos=window.open('','vpos','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollb ars=auto,resizable=no,copyhistory=no,width=780,height=460'); document.form_card.submit();}//--></script></head><body BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#000000" VLINK="#000000"><Center><P><font face="arial" color="navy" size="4">nesta página estará a tabela com as mercadorias, custos, qtdes, frete, qtde parcelas, etc...</font></p><p> </P><P> </P><P><font face="arial" color="bb0000" size="4"><a href="javascript:janela();">comprar</a></font></p><form name="form_card" method="post" target="vpos" action=" type="hidden" name="total" value="17.50"><input type="hidden" name="transacao" value="04"><input type="hidden" name="parcelas" value="00"><input type="hidden" name="filiacao" value=" "><input type= hidden name= DISTRIBUIDOR value= ><input type= hidden name= BANDEIRA value= MASTERCARD ><input type="hidden" name="numpedido" value="123456"><input type="hidden" name="pax1" value="xxxxxxx"><input type="hidden" name="codver" value="xxxxxxxxxxxxxxxx- XXX"><input type="hidden" name="urlback" value=" type="hidden" name="urlcima" value=" <input type="hidden" name="target" value="_nometarget">

13 <center> <input type = "submit" name = "enviar" value = "Prosseguir"> </center></form> </center> </BODY> </HTML> As interfaces de pagamento serão exibidas de acordo com a solicitação que a loja-virtual fizer no parâmetro BANDEIRA, conforme diagrama abaixo:

14 Primeira tela - Padrão: MASTERCARD

15 Segunda tela Normal (sem SecureCode): Segunda tela SecureCode:

16 Tela Padrão: DINERS O Nome do Portador é o único parâmetro da tela de captura que não é validado junto ao emissor do cartão. Este dado é registrado no Relatório de Transações do estabelecimento conforme foi digitado pelo comprador na tela de captura.

17 2. Redecard Loja-virtual 2 Transação Aprovada Se a transação for aprovada e bem sucedida, a Redecard retornará os seguintes parâmetros para a loja-virtual, em método GET, através de sua URLBACK (previamente cadastrada ou fornecida em parâmetro): NOME TAMANHO DESCRIÇÃO DATA 8 Data da transação NUMPEDIDO 16 Número do Pedido NR_CARTAO 16 Número do Cartão mascarado ORIGEM_BIN 3 Código de Nacionalidade do Emissor NUMAUTOR 6 Número de Autorização NUMCV 9 Número do Comprovante de Venda (NSU) NUMAUTENT 27 Número de Autenticação NUMSQN 12 Número seqüencial único NUMPRG 1 Número correspondente ao programa de captura utilizado DATA O parâmetro DATA retornará a data em que a transação foi efetuada (no formato aaaammdd). NUMPEDIDO O parâmetro NUMPEDIDO retornará o nº do pedido que foi informado pela loja-virtual na primeira etapa do fluxo. NR_CARTAO O parâmetro NR_CARTAO retornará o nº do cartão validado junto ao emissor, de forma mascarada, deixando visível apenas os 6 primeiros e 4 últimos dígitos do número. ORIGEM_BIN O parâmetro ORIGEM_BIN retornará o código de nacionalidade do emissor do cartão validado (ex:. BRA= Brasil) O estabelecimento poderá optar por rejeitar transações de emissores internacionais através do tratamento deste parâmetro. NUMAUTOR O parâmetro NUMAUTOR retornará o nº de autorização da transação. É de inteira responsabilidade da loja-virtual fazer o tratamento de quaisquer informações retornadas pela Redecard. NUMCV O parâmetro NUMCV retornará o nº do comprovante de vendas da transação.

18 NUMAUTENT O parâmetro NUMAUTENT retornará o nº de autenticação da transação. NUMSQN O parâmetro NUMSQN retornará o número seqüencial único da transação. NUMPRG O parâmetro NUMPRG retornará o código correspondente ao programa utilizado na captura da transação, de acordo com a tabela abaixo: Código Forma de Captura 0 Normal 1 SecureCode 2 SecureCode 3 SecureCode 4 SecureCode Este parâmetro só será retornado para transações da bandeira MasterCard quando a transação passar pelo processo MasterCard SecureCode. Todas as transações da bandeira Diners são consideradas normais, isto é, sem SecureCode. Importante: Poderão ocorrer casos em que o cartão é MasterCard porém não passou pelo processo MasterCard SecureCode sendo assim o retorno será 0 Normal, transação sem SecureCode. Transação Não Aprovada NOME TAMANHO DESCRIÇÃO NUMPEDIDO 16 Número do Pedido CODRET 2 Código de erro MSGRET 200 Mensagem de erro NUMPEDIDO O parâmetro NUMPEDIDO retornará o nº do pedido que foi informado pela loja-virtual na primeira etapa do fluxo. Dependendo do código do erro, este parâmetro pode não retornar. CODRET O parâmetro CODRET retornará o código de erro se houver algum problema no processamento da transação ou se o emissor não autorizá-la por qualquer motivo.

19 MSGRET O parâmetro MSGRET retornará a mensagem de erro correspondente ao código de erro CODRET se houver algum problema no processamento da transação ou se o emissor não autorizá-la por qualquer motivo. No caso de transações não aprovadas, o fluxo termina nesta etapa.

20 Código 0 a 49 50, 52, 54, 55, 57, 59, 61, 62, 64, 66, 67, 68, 70, 71, 73, 75, 78, 79, 80, 82, 83, 84, 85, 87, 89, 90, 91, 93, 94, 95, 97, 99 Mensagem Transação Aprovada Transação não autorizada 51, 92, 98 Estabelecimento Inválido Por favor, entre em contato com o estabelecimento que está efetuando a venda. 53 Transação Inválida Por favor, entre em contato com o estabelecimento que está efetuando a venda. 76, 86 Refaça a transação Sua transação não pode ser concluída. Por favor, tente novamente. 58, 63, 65, 69, 72, 77, 96 Problemas com o cartão Por favor, verifique os dados de seu cartão. Caso o erro persista- entre em contato com a central de atendimento de seu cartão. 56, 60 Dado Inválido Por favor, entre em contato com o estabelecimento que está efetuando a venda. 74 Instituição sem comunicação 81 Banco não pertence à rede

21 3. Loja-Virtual Redecard Caso a transação tenha sido aprovada pelo emissor, a loja-virtual deverá confirmá-la, retornando os seguintes parâmetros, em método GET, para a URL: NOME TAMANHO DESCRIÇÃO DATA 8 Data da transação TRANSACAO 3 Código da transação de confirmação TRANSORIG 2 Código do tipo da transação original PARCELAS 2 Número de parcelas da transação FILIACAO 9 Filiação do estabelecimento (fornecedor) DISTRIBUIDOR 9 Filiação do estabelecimento (distribuidor) TOTAL 15 Valor da transação NUMPEDIDO 16 Número do pedido NUMAUTOR 6 Número da autorização NUMCV 9 Número do Comprovante de Vendas NUMSQN 12 Número seqüencial único ORIGEM_BIN 3 Código de Nacionalidade do Emissor NUMPRG 1 Número correspondente ao programa de captura utilizado DATA O parâmetro DATA deverá conter a data em que a transação foi efetuada (no formato aaaammdd). TRANSACAO O parâmetro TRANSACAO deverá conter o código de confirmação da transação: 203. TRANSORIG O parâmetro TRANSORIG deverá conter o código do tipo de transação que foi informado pela loja-virtual no campo TRANSACAO na primeira etapa do fluxo. PARCELAS O parâmetro PARCELAS deverá conter o nº de parcelas da transação que foi informado pela loja-virtual no campo PARCELAS na primeira etapa do fluxo. FILIAÇÃO O parâmetro FILIACAO deverá conter o nº de filiação do estabelecimento (cadastrado junto a Redecard), que foi informado pela loja-virtual no campo FILIACAO na primeira etapa do fluxo. DISTRIBUIDOR O parâmetro DISTRIBUIDOR" deverá conter o nº de filiação do estabelecimento distribuidor que foi informado pela loja-virtual no campo DISTRIBUIDOR na primeira etapa do fluxo. Se este parâmetro não for utilizado enviá-lo com valor nulo.

22 TOTAL O parâmetro TOTAL deverá conter o valor da transação que foi informado pela lojavirtual no campo TOTAL na primeira etapa do fluxo. NUMPEDIDO O parâmetro NUMPEDIDO deverá conter o nº do pedido que foi autorizado e retornado pela Redecard no campo NUMPEDIDO na segunda etapa do fluxo. NUMAUTOR O parâmetro NUMAUTOR deverá conter exatamente o mesmo nº de autorização da transação que foi retornado pela Redecard no campo NUMAUTOR na segunda etapa do fluxo. Por exemplo: Se foi retornado o nº , a loja-virtual deverá enviar o nº e não (suprimindo o valor 0 - zero). NUMCV O parâmetro NUMCV deverá conter o nº do comprovante de vendas da transação que foi informado pela Redecard no campo NUMCV na segunda etapa do fluxo. NUMSQN O parâmetro NUMSQN deverá conter o nº seqüencial único da transação que foi informado pela Redecard no campo NUMSQN na segunda etapa do fluxo. ORIGEM_BIN O parâmetro ORIGEM_BIN deve conter o código de nacionalidade do emissor do cartão validado (ex:. BRA= Brasil) que foi devolvido pela Redecard na segunda etapa do fluxo. NUMPRG O parâmetro NUMPRG deve conter o código correspondente ao programa utilizado na captura da transação, que foi devolvido pela Redecard na segunda etapa do fluxo.

23 IMPORTANTE: LEIA COM ATENÇÃO OS ITENS ABAIXO. Caso a loja-virtual decida não confirmar a transação, por motivo qualquer, basta que o estabelecimento não execute esta etapa do fluxo. Neste caso, a transação será automaticamente desfeita. Após a autorização da transação e o retorno dos dados à URLBACK, a loja-virtual terá 02 (dois) minutos para efetuar a confirmação. Caso a transação não seja confirmada neste período, ela será automaticamente desfeita. Os dados da confirmação devem ser enviados através do método GET, em conexão HTTP (e não HTTPS). O tráfego destes dados não deverá ocorrer através do browser do usuário ou com sua interferência, ou seja, o webserver da loja-virtual deverá comunicar-se diretamente com o ambiente da Redecard.Pode-se, por exemplo, utilizar componentes, serviços, servlets, etc.este procedimento garante a segurança do tráfego dos dados entre a Redecard e a sua loja-virtual. 4. Redecard Loja-Virtual Efetuada a confirmação, a Redecard retornará os seguintes parâmetros para a loja-virtual: NOME TAMANHO DESCRIÇÃO CODRET 2 Código de retorno MSGRET 200 Mensagem de retorno CODRET O parâmetro CODRET retornará o código de retorno da transação. MSGRET O parâmetro MSGRET retornará a mensagem da transação referente ao código de retorno CODRET. Se a confirmação da transação for bem sucedida, este parâmetro retornará o Comprovante de Vendas para o portador do cartão. Estes parâmetros são retornados após a chamada para confirmação da transação. Não é retornado qualquer comando ou TAG HTML, mas somente uma única linha de texto. Ex:. CODRET=0&MSGRET=CONFIRMACAO+COM+SUCESSO. Desta forma, o tratamento do retorno através de componente (ou serviço, servlet, etc) fica mais fácil e rápido.

24 Códigos e Mensagens de retorno: 0 = "CONFIRMACAO COM SUCESSO";1 = "JA CONFIRMADA"; (transação já confirmada anteriormente)2 = "TRANSACAO NEGADA"; 3 = "TRANSACAO DESFEITA"; (ultrapassado o tempo disponível para confirmação)4 = "TRANSACAO ESTORNADA";5 = "TRANSACAO ESTORNADA";8 = "DADOS NAO COINCIDEM"; 9 = "TRANSACAO NAO ENCONTRADA";88 = DADOS AUSENTES. TRANSAÇAO NAO PODE SER CONCLUIDA A loja-virtual deverá tratar cada uma das mensagens de retorno e informar o portador dependendo da situação. Caso nenhum dado seja retornado, o estabelecimento deverá enviar a confirmação novamente (repetir a terceira etapa do fluxo). Recomenda-se que, ao final desta etapa, a loja-virtual retorne para o usuário, o número do pedido, bem como os dados necessários para o acompanhamento da compra por parte do portador do cartão. 5. Loja-Virtual Redecard Devidamente confirmada a transação, a loja-virtual deverá disparar a exibição do comprovante de venda, enviando os seguintes parâmetros (GET ou POST) preenchidos na URL: NOME TAMANHO DESCRIÇÃO DATA 8 Data da transação TRANSACAO 3 Código 201 NUMAUTOR 6 Número da autorização NUMCV 9 Número do Comprovante de Vendas LANGUAGE 1 Idioma do comprovante de vendas DATA O parâmetro DATA deverá conter a data em que a transação foi efetuada (no formato aaaammdd), informado pela Redecard no campo DATA na segunda etapa do fluxo TRANSACAO O parâmetro TRANSACAO deverá conter o código de exibição do cupom: 201. NUMAUTOR O parâmetro NUMAUTOR deverá conter exatamente o mesmo nº de autorização da transação que foi retornado pela Redecard no campo NUMAUTOR na segunda etapa do fluxo. Por exemplo: Se foi retornado o nº , a loja-virtual deverá enviar o nº e não (suprimindo o valor 0 - zero).

25 NUMCV O parâmetro NUMCV deverá conter o nº do comprovante de vendas da transação que foi informado pela Redecard no campo NUMCV na segunda etapa do fluxo. IMPORTANTE: LEIA COM ATENÇÃO OS ITENS ABAIXO. Apesar de tratar-se de uma etapa independente do fluxo, é obrigação da lojavirtual exibir o comprovante de venda, preferencialmente em uma nova janela, de forma que o comprador consiga imprimir os dados. A exibição do comprovante de venda pode ocorrer mais de uma vez, mas apenas o comprador poderá visualizá-lo. Caso seja solicitada a exibição do comprovante de venda para uma transação não confirmada ou não aprovada, uma mensagem de erro será exibida. LANGUAGE O parâmetro LANGUAGE deverá conter o código correspondente ao idioma utilizado na 1ª etapa do fluxo de transação. Onde: Código E S Forma de Captura Inglês Espanhol* * O valor S referente ao idioma Espanhol só está disponível para transações da bandeira MasterCard inicialmente.

26 Os comprovantes de vendas (ilustrados abaixo) serão exibidos de acordo com a solicitação que a loja-virtual fez no parâmetro BANDEIRA, na primeira etapa do fluxo: MASTERCARD Comprovante de Vendas Normal Comprovante de Vendas SecureCode

27 DINERS Comprovante de Vendas Normal Atenção! Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o popup para 280 X 440 pixels.

28 Estes são exemplos de fonte html que poderão ser gerados pelo desenvolvedor para garantir maior segurança nas transações eletrônicas da loja-virtual. O trecho a seguir contém uma rotina de Javascript para desabilitar o botão direito do mouse. <script language = "Javascript"> Function right(e) { if (navigator.appname == 'Netscape' && (e.which == 3 e.which == 2)) Return false; Else if (navigator.appname == 'Microsoft Internet Explorer' && (event.button == 2 event.button == 3)) { Alert("REDECARD ONLINE"); Return false; } Return true; } Document.onmousedown=right; Document.onmouseup=right; if (document.layers) window.captureevents(event.mousedown); if (document.layers) window.captureevents(event.mouseup); Window.onmousedown=right; Window.onmouseup=right; </script> O trecho a seguir contém uma rotina de Javascript para desabilitar o menu, a barra de rolagem e outros itens da página. <Script language="javascript"><!-function Janela(){Vpos=window.open('','vpos','toolbar=no,location=no,directories=no,status=no,menubar =no,scrollbars=auto,resizable=no,copyhistory=no,width=600,height=460');document.form_pos. submit();}//--></script>

29 Para efetuar os testes na plataforma do Komerci antes de implementá-la, a Redecard recomenda que o estabelecimento realize transações em ambiente produtivo, estornando-as no mesmo dia da venda, por meio do Gerenciador de Vendas, disponível no Portal Redecard. O Komerci possui uma série de funcionalidades para gerenciamento das transações processadas, tais como: Estorno de Transações: O Estorno permite que o estabelecimento possa cancelar transações on-line que foram realizadas através do Komerci. Este serviço só está disponível para transações realizadas no mesmo dia da venda (até às 23:59h do horário oficial de Brasília). Resumo de Vendas: O Resumo de Vendas é um documento que exibe a somatória diária de todas as transações confirmadas e faturadas. Ele fica disponível no sistema por 5 dias, de modo que se ele não for extraído durante este período, não será mais possível visualizá-lo. Por isso, recomenda-se a extração diária do mesmo. Relatório de Transações: O Relatório de Transações é uma ferramenta que disponibiliza por três meses a consulta de todos os dados pertinentes às transações efetuadas através do Komerci. Manuais: Esta função armazena a última versão dos manuais operacionais do Komerci para download. Estas funcionalidades estão disponíveis no Portal Redecard. Para utilizar o Portal Redecard, basta que o estabelecimento efetue cadastro no endereço: com sua filiação da tecnologia Komerci. Os procedimentos que confirmam a realização da compra pelo cliente, como o envio de , a confirmação por telefone e a consulta de banco de dados interno, são práticas complementares que devem ser realizadas pelo estabelecimento. Esses procedimentos podem reduzir o risco da transação comercial realizada via Internet, e já são práticas comuns adotadas pela maioria dos estabelecimentos, mas particularmente recomendadas quando o valor da compra for elevado. Atenção: É importante verificar o status da transação antes de iniciar o processo de entrega dos produtos adquiridos ou execução dos serviços contratados pelos consumidores. Apenas transações com o status de Confirmada (vide Relatório de Transações do Komerci) é que devem ser consideradas como bem sucedidas, exceto se tiverem sido canceladas posteriormente. A Redecard entende que a decisão final de efetivação da venda deve sempre ficar a cargo do estabelecimento, principalmente em se tratando da comparação de informações que são digitadas e, conseqüentemente, passíveis de erros. Lembrando que o estabelecimento que utiliza a Internet

30 como canal de vendas, submete-se às regras de Marketing Direto e, assim sendo, ficará sujeito às cláusulas contratuais previstas para este tipo de comercialização, salvo algumas exceções (ex: Komerci SecureCode, acordos locais, etc). Este guia só está disponível para a bandeira Diners. Caso o estabelecimento popule estes parâmetros em transações da bandeira MasterCard, eles serão descartados. O único que será acatado é a URLCIMA, que já foi descrito anteriormente neste guia. Este guia irá auxiliá-lo na edição e personalização da interface de pagamento do Komerci, bem como na utilização de todos os recursos proporcionados pelo sistema. Para editar a tela de captura do Komerci, o estabelecimento deverá enviar dados adicionais na primeira etapa da transação.

31 Para editar a tela de captura do Komerci, o estabelecimento deverá enviar alguns dados adicionais na primeira etapa do fluxo, junto aos demais dados da transação, seguindo as instruções detalhadas em seguida: NOME TAMANHO DESCRIÇÃO URLCIMA 250 Endereço de URL da página ou imagem superior URLBAIXO 250 Endereço de URL da página ou imagem inferior CORBKG 6 Cor de fundo da tela de captura CORTOP1 6 Cor da fonte do título superior CORTOP2 6 Cor da fonte do sub-título superior CORLEFT1 6 Cor da fonte do título esquerdo CORLEFT2 6 Cor da fonte do texto esquerdo CORRIGHT1 6 Cor da fonte do título direito CORRIGHT2 6 Cor da fonte do formulário direito CORBTN1 6 Cor de fundo dos botões CORBTN2 6 Cor da fonte do texto dos botões CORPOPUP1 6 Cor de fundo do pop-up CORPOPUP2 6 Cor da fonte do título do popup CORPOPUP3 6 Cor da fonte do texto do popup URLCIMA / URLBAIXO O parâmetro URLCIMA e/ou URLBAIXO deverá conter o endereço da URL (em HTTPS) da página ou imagem a ser carregada nas áreas correspondentes. Não ultrapasse as 250 posições permitidas. Não utilize símbolos, pontuações ou caracteres especiais, tais como & * ^?). Caso o estabelecimento deixe de enviar estes parâmetros, ou os envie em branco, o sistema carregará a cor da tela de captura padrão. O tamanho da área que o parâmetro URLCIMA abrange é fixa em 120 X 780 pixels. O tamanho da área que o parâmetro URLBAIXO abrange é fixo em 80 X 780 pixels para a tela de captura simples ou de Pré-Autorização e 50 X 780 pixels para a tela de captura contemplando o serviço de AVS. Como a construção da tela de captura depende de javascript na página da loja-virtual, existe a possibilidade de aumentar sua altura, porém somente da barra inferior (URLBAIXO). CORBKG O parâmetro CORBKG deverá conter a cor de fundo do miolo da tela de captura no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor da tela padrão. CORTOP1 O parâmetro CORTOP1 deverá conter a cor de fonte do título superior: Sistema Seguro de Pagamento no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou

32 incorretamente, o sistema carregará a cor de fonte padrão. CORTOP2 O parâmetro CORTOP2 deverá conter a cor de fonte do sub-título superior: Você está em um ambiente de compra seguro... no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORLEFT1 O parâmetro CORLEFT1 deverá conter a cor de fonte do título esquerdo: Sua Compra no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORLEFT2 O parâmetro CORLEFT2 deverá conter a cor de fonte do texto esquerdo: Você está realizando uma compra no valor de..., Para efetuar o pagamento preencha... no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORRIGHT1 O parâmetro CORRIGHT1 deverá conter a cor de fonte do título direito: Seus Dados no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORRIGHT2 O parâmetro CORRIGHT2 deverá conter a cor de fonte do formulário direito: Número do Cartão, Validade do Cartão, Nome do Portador... no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORBTN1 O parâmetro CORBTN1 deverá conter a cor de fundo dos botões: Enviar, Limpar (tela de captura) e Fechar (pop- up) no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fundo padrão. CORBTN2 O parâmetro CORBTN2 deverá conter a cor de fonte dos botões: Enviar, Limpar (tela de captura) e Fechar (pop- up) no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão.

33 CORPOPUP1 O parâmetro CORPOPUP1 deverá conter a cor de fundo do pop-up no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fundo padrão. CORPOPUP2 O parâmetro CORPOPUP2 deverá conter a cor de fonte do título do pop-up Por que é Seguro? no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão. CORPOPUP3 O parâmetro CORPOPUP3 deverá conter a cor de fonte do texto do pop-up no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parâmetro, o envie em branco ou incorretamente, o sistema carregará a cor de fonte padrão.

34

35 CORPOPUP1 CORPOPUP3

36 A Redecard possui uma equipe de suporte técnico especializada no atendimento aos desenvolvedores das lojas-virtuais durante sua integração ao sistema de captura, Komerci. Para usufruir plenamente deste serviço, por favor, atente às seguintes recomendações: Ao entrar em contato com o suporte técnico, tenha em mãos o número defiliação do estabelecimento / loja-virtual. O número de filiação é importante para que o suporte identifique o estabelecimento, e para que possa prestar informações específicas. Certifique-se de ter lido todos os manuais referentes ao produto contratado, que todas as especificações técnicas foram seguidas, e sem adaptações. O suporte técnico está apto a resolver qualquer dúvida ou problema técnico que o desenvolvedor tenha durante a integração com o Komerci, porém, não será fornecido suporte a linguagens de programação ou códigos fonte, ainda que fornecidos pelo desenvolvedor. O suporte técnico não está autorizado a fornecer ou receber números de cartões de crédito, válidos ou não, ainda que para testes. O suporte técnico não atende questões referentes à aquisição do produto, upgrade, contratação dos serviços de AVS e Pré-Autorização, custos e taxas, dados cadastrais, habilitação de funções e do número de filiação. Nestes casos, o lojista deverá entrar em contato com o representante comercial da Redecard que atende seu estabelecimento. Qualquer dúvida referente ao acesso ao portal da Redecard deverá ser esclarecida com a nossa Central de Atendimento de sua localidade.