Komerci Manual Desenvolvedor

Manual do Desenvolvedor (Versão 2.9) 1

Histórico de Atualização do Manual

Versão Data Descrição da alteração

2.5 09/02/04 - Atualização do telefone de contato do Suporte Técnico do Komerci

2.6 12/04/04 - Alteração do tamanho do parâmetro “CODVER”.

2.6.1 02/08/04 - Inclusão de alerta para programas bloqueadores de pop-ups

2.7 28/10/04

- Nova interface gráfica para telas da bandeira MasterCard - Inclusão do parâmetro “TARGET” na 1º etapa da transação - Alteração do método de envio da 3ª etapa da transação - Inclusão do idioma “Espanhol” para as telas da bandeira MasterCard - Mudanças nas regras de customização

2.8 07/07/09 - Novo telefone do Suporte Komerci

2.9 09/06/10 - Inclusão do parâmetro “INIFRAME” na 1º etapa da transação

3.0 18/06/10 - Inclusão da nova bandeira VISA

Manual do Desenvolvedor


Índice

Introdução .................................................................................................. 03

Configurações .................................................................................... 03

Fluxo de Transação ............................................................................... 04

1. Loja-virtual Redecard

.......................................................................

06

Código de Verificação ............................................................................. 09 Modelo de Código-fonte ........................................................................... 11 Tela de captura ..................................................................................... 12

2. Redecard Loja-virtual ................................................................... 14 Tabela de Códigos e Mensagens de Retorno ..................................................... 16

3. Loja-virtual Redecard ........................................................................ 17

4. Redecard Loja-virtual ....................................................................... 19

5. Loja-Virtual Redecard ....................................................................... 20 Comprovante de Venda .......................................................................... 21

Dicas de segurança

...............................................................................

22

Teste na Loja-Virtual ..................................................................................... 23

Gerenciamento de Vendas ........................................................... 23

Importante ..................................................................................... 24

Anexo – Guia de Edição .................................................................. 25

Suporte Técnico ............................................................................... 30


Introdução

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ções 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 28800 bps

- Mouse

- Plataforma Windows 95/98/NT/2000,

Linux, AIX, Sun Solaris, OS/390 ou AS/400.)

Versões certificadas

- Navigator 4.0, Internet Explorer 4.0 (ou versões superiores) e alguns outros

browsers

- JDK 1.1.8 (ou versões superiores)

Certificado necessário

- Certificado de Segurança SSL 128 bits (criptografia)

Sugestão de fornecedores do Certificado SSL 128 bits

- http://www.certisign.com.br

- http://www.verisign.com.br

É de inteira responsabilidade do estabelecimento a seleção e negociação com a

empresa certificadora. A Redecard não possui nenhuma relação de empresas homologadas

para a emissão do certificado digital. Os endereços citados acima são apenas sugestões.


Fluxo de transação

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”, “Visa”

e “Diners”, assim grafadas.


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:

1-) Loja-Virtual Redecard: Solicitação de Autorização 2-) Redecard Loja-Virtual: Retorno de Autorização

3-) Loja-Virtual Redecard: Solicitação de Confirmação 4-) Redecard Loja-Virtual: Retorno de Confirmação

5-) Loja-Virtual Redecard: Solicitação de Comprovante de Vendas 6-) Redecard Loja-Virtual: Exibição de Comprovante de Vendas para o portador

Loja-Virtual Redecard

Emissor

1

2

3

4

5

6 *


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)

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

INIFRAME 1 Indica se a tela do Komerci será apresentada em IFRAME

TOTAL

O parâmetro “TOTAL” deverá conter o valor da transação separado por “.” (ponto).

Exemplo: 34.60

É 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

1 Para solicitar a tela de captura do Komerci em outros idiomas, basta substituir este endereço por: INGLÊS: https://ecommerce.redecard.com.br/pos_virtual/form_card_eng.asp/ ESPANHOL: https://ecommerce.redecard.com.br/pos_virtual/form_card_spa.asp/ (Obs: a tela em espanhol só está disponível para a bandeira MasterCard inicialmente).

Todos os parâmetros citados nesta etapa do fluxo deverão ser enviados através do método

POST, para: https://ecommerce.redecard.com.br/pos_virtual/form_card.asp1

Não utilizar frames ou iframes na chamada do site

https://ecommerce.redecard.com.br/pos_virtual. Esta prática causará interferências no

funcionamento das páginas para determinadas configurações/versões de browsers.

O Komerci oferece a opção de exibição de "banner" das lojas, vide página 8 deste manual

(Utilização de parâmetro URLCIMA), ou contate nosso suporte técnico.

https://ecommerce.redecard.com.br/pos_virtual/form_card_eng.asp/

https://ecommerce.redecard.com.br/pos_virtual/form_card_spa.asp/


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.

Não é possível efetuar transações parceladas para cartões emitidos fora do Brasil.

Trata-se de uma regra dos emissores estrangeiros.

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. Em caso negativo, enviar este parâmetro, porém em

branco.

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”, “VISA” 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 ou Visa na tela de captura Diners, por exemplo, o Comprovante de Vendas será

exibido de acordo com o nº do cartão digitado, sendo, MasterCard ou Visa.

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 (www.redecard.com.br). 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.

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:



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 para as bandeiras MasterCard, Visa e 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 ou Visa inicialmente

Recomenda-se a abertura da tela de captura do Komerci no próprio frame da

loja-virtual para evitar problemas decorrentes da utilização de programas

bloqueadores de pop-ups por parte dos portadores de cartão. Uma outra solução para

evitar problema com estes programas é a exibição de um aviso, antes ou durante a

transação, informando ao seu cliente sobre a necessidade de desabilitar ou desinstalar

o programa bloqueador de pop-ups que ele eventualmente possua. INIFRAME

O parâmetro “INIFRAME” é opcional. Caso seja necessário exibir as telas do Komerci em

um IFRAME, este deverá ser enviado com valor igual a “S”.


Instruções para Instalação do Código de Verificação

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 1.1.8 (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 000098756 20.75 200.21.32.64

332705431571-768

# java CodVer 000056734 120.50 125.32.76.109

218937362874-605

A saída poderá ser direcionada para um arquivo:

# java CodVer 000043201 35.50 32.147.125.76 > codver.out

O conteúdo deste arquivo será:

647398373692-762

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

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 (www.redecard.com.br).

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.


Modelo de Código Fonte

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">  </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="https://ecommerce.redecard.com.br/pos_virtual/form_card.asp"> <input 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="000012345"> <input type=”hidden” name=”DISTRIBUIDOR” value=”999999999”> <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="https://www.loja.com.br/cgi-bin/retorna.cgi"> <input type="hidden" name="URLCIMA" value=" https://www.loja.com.br/imagem_cima.jpg"> <input type="hidden" name="TARGET" value="_nometarget"> <center> <input type = "submit" name = "enviar" value = "Prosseguir"> </center></form> </center> </BODY> </HTML>


Tela de Captura

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:

MASTERCARD


VISA


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.


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):


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

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 para a Mastercard e BR = Brasil para a Visa) 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.

2 É 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.

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.

Transação Não Aprovada


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.

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.


Tabela de Códigos e Mensagens de Retorno:

Código Mensagem

0 Transação Aprovada

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

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


76, 86

Refaça a transação

Sua transação não pode ser concluída. Por favor, refaça a transação Dados obrigatórios ausentes

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


74 Instituição sem comunicação

81 Banco não pertence à rede


3. Loja-Virtual Redecard

Caso a transação tenha sido aprovada pelo emissor, a loja-virtual deverá confirmá-la,

retornando os seguintes parâmetros para o endereço: http://ecommerce.redecard.com.br/pos_virtual/confirma.asp:

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.



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

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.

http://ecommerce.redecard.com.br/pos_virtual/confirma.asp


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.

TOTAL

O parâmetro “TOTAL” deverá conter o valor da transação que foi informado pela loja-

virtual 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º 012345, a loja-virtual deverá enviar o nº 012345 e

não 12345 (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.

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).


4. Redecard Loja-Virtual Efetuada a confirmação, a Redecard retornará os seguintes parâmetros para a loja-virtual:


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.

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: https://ecommerce.redecard.com.br/pos_virtual/cupom.asp



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º 012345, a loja-virtual deverá enviar o nº 012345 e

não 12345 (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.

IMPORTANTE: LEIA COM ATENÇÃO OS ITENS ABAIXO.

- Apesar de tratar-se de uma etapa independente do fluxo, é obrigação da loja-

virtual 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 Forma de Captura

E Inglês

S Espanhol*

* O valor “S” referente ao idioma Espanhol só está disponível para transações da bandeira

MasterCard inicialmente.

Comprovante de Venda

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


VISA


DINERS

Dicas de Segurança

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;

Atenção ! Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o

pop-up para 280 X 440 pixels.


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">



</Script>


Teste na Loja-Virtual

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.

Gerenciamento de Vendas

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: www.redecard.com.br com sua

filiação da tecnologia Komerci.

http://www.redecard.com.br/


Importante

Os procedimentos que confirmam a realização da compra pelo cliente, como o envio de e-

mail, 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 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 para a Mastercard e VBV “Verified By

Visa” para a VISA, acordos locais, etc).


Anexo – Guia de Edição

Este guia só está disponível para a bandeira Diners. Caso o estabelecimento popule

estes parâmetros em transações das bandeiras MasterCard ou Visa, eles serão descartados.

O único que será acatado é a “URLCIMA”, que já foi descrito anteriormente neste guia.

Introdução

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.

Programação Específica

Para editar a tela de captura do Komerci, o estabelecimento deverá enviar dados adicionais

na primeira etapa da transação.

Fluxo de Transação

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:


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.


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).


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).



CORLEFT1

O parâmetro “CORLEFT1” deverá conter a cor de fonte do título esquerdo: “Sua Compra”

no formato RGB hexadecial (RRGGBB).




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).



CORRIGHT1

O parâmetro “CORRIGHT1” deverá conter a cor de fonte do título direito: “Seus Dados”

no formato RGB hexadecial (RRGGBB).



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).



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).


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).



CORPOPUP1

O parâmetro “CORPOPUP1” deverá conter a cor de fundo do pop-up no formato RGB

hexadecial (RRGGBB).


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).



CORPOPUP3

O parâmetro “CORPOPUP3” deverá conter a cor de fonte do texto do pop-up no formato

RGB hexadecial (RRGGBB).




Layout dos Parâmetros

Caso a loja-virtual não envie nenhum dos parâmetros extras descritos neste guia, o

sistema carregará a interface de pagamento padrão.

URLCIMA

CORBKG

URLBAIXO

CORTOP1

CORTOP2

CORLEFT1

CORLEFT2

CORRIGHT1

CORRIGHT2

CORBTN1

CORBTN2

CORPOPUP3 CORPOPUP1

CORPOPUP2

CORBTN1

CORBTN2


Suporte Técnico

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 de

FILIAÇÃ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.

Dúvidas, referentes ao desenvolvimento do Komerci deverão ser esclarecidas com o

nosso Suporte Técnico Komerci.

Contato: Suporte Técnico

Telefones de Atendimento:

Capitais e Litoral: 4001-4433

Outras localidades: 0800-784433

Horário de Atendimento: Das 08h às 20h40, segunda à sexta Email: [email protected]

Acesse sempre redecard.com.br e confira alguns dos nossos serviços: Extrato On-

Line, Serviços 48h (Pesquisas de Débito e Crédito) e Cancelamento de vendas.

Documents

Komerci Manual Desenvolvedor