Escolar Documentos
Profissional Documentos
Cultura Documentos
KOMERCI Manual VersaoIntegrada
KOMERCI Manual VersaoIntegrada
Introdução .................................................................................................
03 .
Configurações ....................................................................................
03
Dicas de segurança 22
...............................................................................
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.
Configurações
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
- http://www.certisign.com.br
- http://www.verisign.com.br
Check-out da Loja-Virtual:
A ilustração abaixo é um modelo de loja virtual após a seleção dos itens desejados na
compra:
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.
1
2
3
4
5
6*
* Esta etapa será enviada para o portador do cartão, por meio da loja-virtual.
A loja virtual deverá enviar os seguintes parâmetros para a Redecard, quando da chamada
para a tela de captura do Komerci:
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
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:
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).
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”.
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.
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):
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”.
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.
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
Sem nenhum parâmetro, será exibido um pequeno “help”.
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="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>
MASTERCARD
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.
Transação Aprovada
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.
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.
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.
Código Mensagem
0 Transação Aprovada
Estabelecimento Inválido
51, 92, 98 Por favor, entre em contato com o estabelecimento que está efetuando
a venda.
Transação Inválida
53 Por favor, entre em contato com o estabelecimento que está efetuando
a venda.
Refaça a transação
76, 86 Sua transação não pode ser concluída.
Por favor, refaça a transação
Dados obrigatórios ausentes
Problemas com o cartão
58, 63, 65, 69, 72, 77, 96 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.
Dado Inválido
56, 60 Por favor, entre em contato com o estabelecimento que está efetuando
a venda.
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.
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.
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.
- 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.
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.
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.
* O valor “S” referente ao idioma Espanhol só está disponível para transações da bandeira
MasterCard inicialmente.
Comprovante de Venda
MASTERCARD
Atenção !
Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o
pop-up para 280 X 440 pixels.
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.
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>
Gerenciamento de Vendas
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.
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).
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
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:
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
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.
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.
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.
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.
CORTOP1 URLCIMA
CORTOP2
CORLEFT1 CORRIGHT1
CORBKG
CORBTN1
CORLEFT2
CORRIGHT2 CORBTN2
URLBAIXO
Caso a loja-virtual não envie nenhum dos parâmetros extras descritos neste guia, o
sistema carregará a interface de pagamento padrão.
CORPOPUP2
CORPOPUP1
CORPOPUP3
CORBTN1
CORBTN2
Horário de Atendimento:
Das 08h às 20h40, segunda à sexta
Email: loja.virtual@redecard.com.br
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.