Manual do Desenvolvedor
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
2.7
02/08/04 - Inclusão de alerta para programas bloqueadores de pop-ups
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
Manual do Desenvolvedor (Versão 2.7)
1
Í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
16
.....................................................
Tabela de Códigos e Mensagens de Retorno
3. Loja-virtual
Redecard ........................................................................
17
4. Redecard
Loja-virtual
5. Loja-Virtual
19
.......................................................................
Redecard .......................................................................
20
21
..........................................................................
Comprovante de Venda
Dicas de segurança
22
...............................................................................
Teste na Loja-Virtual
23
.....................................................................................
Gerenciamento de Vendas
Importante
24
.....................................................................................
Anexo – Guia de Edição
Suporte Técnico
........................................................... 23
.................................................................. 25
30
...............................................................................
Manual do Desenvolvedor (Versão 2.7)
2
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
-
Netscape 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
-
SSL 128 bits
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.
Manual do Desenvolvedor (Versão 2.7)
3
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” e
“Diners”, assim grafadas.
Manual do Desenvolvedor (Versão 2.7)
4
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.
1
2
3
4
5
6*
Loja-Virtual
Redecard
Emissor
* 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
Manual do Desenvolvedor (Versão 2.7)
5
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
TOTAL
TRANSACAO
PARCELAS
FILIACAO
DISTRIBUIDOR
BANDEIRA
NUMPEDIDO
PAX1
CODVER
URLBACK
URLCIMA
TARGET
TAMANHO
15
2
2
9
9
10
16
26
25
250
250
40
DESCRIÇÃO
Valor total da compra
Código do tipo de transação
Número de parcelas
Número de filiação do estabelecimento (fornecedor)
Número de filiação do estabelecimento (distribuidor)
Bandeira do cartão
Número do pedido
Texto livre para digitação
Código de Verificação
Endereço para retorno dos dados da transação
Endereço de URL da página ou imagem superior
Nome do frame para onde será retornado a URLBACK
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.
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
À vista
Parcelado Emissor
Parcelado Estabelecimento
Código
04
06
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).
Manual do Desenvolvedor (Versão 2.7)
6
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. 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” 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.
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.
Manual do Desenvolvedor (Versão 2.7)
7
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:
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.
Manual do Desenvolvedor (Versão 2.7)
8
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.
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.
Manual do Desenvolvedor (Versão 2.7)
9
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”.
Manual do Desenvolvedor (Versão 2.7)
10
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.
Manual do Desenvolvedor (Versão 2.7)
11
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">
<!-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>&nbsp;</P>
<P>&nbsp;</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>
Manual do Desenvolvedor (Versão 2.7)
12
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
Manual do Desenvolvedor (Versão 2.7)
13
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.
Manual do Desenvolvedor (Versão 2.7)
14
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
DATA
NUMPEDIDO
NR_CARTAO
TAMANHO
8
16
16
DESCRIÇÃO
Data da transação
Número do Pedido
Número do Cartão mascarado
ORIGEM_BIN
3
Código de Nacionalidade do Emissor
NUMAUTOR
NUMCV
NUMAUTENT
NUMSQN
6
9
27
12
Número de Autorização
Número do Comprovante de Venda (NSU)
Número de Autenticação
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) 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.
Manual do Desenvolvedor (Versão 2.7)
15
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
NOME
NUMPEDIDO
CODRET
MSGRET
TAMANHO
16
2
200
DESCRIÇÃO
Número do Pedido
Código de erro
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.
Manual do Desenvolvedor (Versão 2.7)
16
Tabela de Códigos e Mensagens de Retorno:
Código
Mensagem
Transação Aprovada
0 a 49
50, 52, 54, 55,
62, 64, 66, 67,
73, 75, 78, 79,
84, 85, 87, 89,
94, 95, 97, 99
57,
68,
80,
90,
59,
70,
82,
91,
61,
71,
83, Transação não autorizada
93,
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, tente novamente.
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, ent re em contato com o estabelecimento que está efetuando
a venda.
74
Instituição sem comunicação
81
Banco não pertence à rede
Manual do Desenvolvedor (Versão 2.7)
17
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 lojavirtual.
NOME
DATA
TRANSACAO
TRANSORIG
PARCELAS
FILIACAO
DISTRIBUIDOR
TOTAL
NUMPEDIDO
NUMAUTOR
NUMCV
NUMSQN
TAMANHO
8
3
2
2
9
9
15
16
6
9
12
DESCRIÇÃO
Data da transação
Código da transação de confirmação
Código do tipo da transação original
Número de parcelas da transação
Filiação do estabelecimento (fornecedor)
Filiação do estabelecimento (distribuidor)
Valor da transação
Número do pedido
Número da autorização
Número do Comprovante de Vendas
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.
Manual do Desenvolvedor (Versão 2.7)
18
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 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º 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).
Manual do Desenvolvedor (Versão 2.7)
19
4. Redecard
Loja-Virtual
Efetuada a confirmação, a Redecard retornará os seguintes parâmetros para a loja-virtual:
NOME
CODRET
MSGRET
TAMANHO
2
200
DESCRIÇÃO
Código de retorno
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.
Manual do Desenvolvedor (Versão 2.7)
20
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
NOME
DATA
TRANSACAO
NUMAUTOR
NUMCV
LANGUAGE
TAMANHO
8
3
6
9
1
DESCRIÇÃO
Data da transação
Código 201
Número da autorização
Número do Comprovante de Vendas
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 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.
Manual do Desenvolvedor (Versão 2.7)
21
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.
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
DINERS
Atenção !
Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o
pop-up para 280 X 440 pixels.
Manual do Desenvolvedor (Versão 2.7)
22
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;
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>
Manual do Desenvolvedor (Versão 2.7)
23
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.
Manual do Desenvolvedor (Versão 2.7)
24
Importante
Os procedimentos que confirmam a realização da compra pelo cliente, como o envio de email, 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, acordos locais, etc).
Manual do Desenvolvedor (Versão 2.7)
25
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 da bandeira MasterCard, 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:
NOME
URLCIMA
URLBAIXO
CORBKG
CORTOP1
CORTOP2
CORLEFT1
CORLEFT2
CORRIGHT1
CORRIGHT2
CORBTN1
CORBTN2
CORPOPUP1
CORPOPUP 2
CORPOPUP3
TAMANHO
250
250
6
6
6
6
6
6
6
6
6
6
6
6
DESCRIÇÃO
Endereço de URL da página ou imagem superior
Endereço de URL da página ou imagem inferior
Cor de fundo da tela de captura
Cor da fonte do título superior
Cor da fonte do sub-título superior
Cor da fonte do título esquerdo
Cor da fonte do texto esquerdo
Cor da fonte do título direito
Cor da fonte do formulário direito
Cor de fundo dos botões
Cor da fonte do texto dos botões
Cor de fundo do pop-up
Cor da fonte do título do popup
Cor da fonte do texto do popup
Manual do Desenvolvedor (Versão 2.7)
26
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
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.
Manual do Desenvolvedor (Versão 2.7)
27
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.
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.
Manual do Desenvolvedor (Versão 2.7)
28
CORPOPUP2
O parâmetro “CORPOPUP2” deverá conter a cor de fo nte 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.
Manual do Desenvolvedor (Versão 2.7)
29
Layout dos Parâmetros
CORTOP1
URLCIMA
CORTOP2
CORLEF T1
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
Manual do Desenvolvedor (Versão 2.7)
30
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.
-
Qualquer dúvida referente ao acesso ao portal da Redecard deverá ser esclarecida
com a nossa Central de Atendimento de sua localidade.
Contato: Suporte Técnico
Tel: (11) 2121-0971
E-mail: [email protected]
Horário de Atendimento: Das 9hs às 18hs
Manual do Desenvolvedor (Versão 2.7)
31