Você está na página 1de 35

Manual do Desenvolvedor

Histrico de Atualizao do Manual


Verso 2.5 2.6 2.6.1 Data 09/02/04 12/04/04 02/08/04 Descrio da alterao - Atualizao do telefone de contato do Suporte Tcnico do Komerci - Alterao do tamanho do parmetro CODVER. - Incluso de alerta para programas bloqueadores de pop-ups Nova interface grfica para telas da bandeira MasterCard Incluso do parmetro TARGET na 1 etapa da transao Alterao do mtodo de envio da 3 etapa da transao Incluso do idioma Espanhol para as telas da bandeira MasterCard Mudanas nas regras de customizao

2.7

28/10/04

2.8 2.9 3.0

07/07/09 09/06/10 18/06/10

- Novo telefone do Suporte Komerci - Incluso do parmetro INIFRAME na 1 etapa da transao - Incluso da nova bandeira VISA

Manual do Desenvolvedor (Verso 2.9)

ndice

Introduo

03 .................................................................................................. 03 .................................................................................... 04 ...............................................................................


Redecard ....................................................................... 06

Configuraes

Fluxo de Transao 1. Loja-virtual

Cdigo de Verificao ............................................................................. 09 Modelo de Cdigo-fonte ........................................................................... 11 Tela de captura ..................................................................................... 12

2. Redecard

Loja-virtual ................................................................... 14

Tabela de Cdigos e Mensagens de Retorno

..................................................... 16

3. Loja-virtual 4. Redecard 5. Loja-Virtual

Redecard ........................................................................ 17 Loja-virtual ....................................................................... 19 Redecard ....................................................................... 20

Comprovante de Venda

.......................................................................... 21

Dicas de segurana Teste na Loja-Virtual

22 ............................................................................... 23 .....................................................................................

Gerenciamento de Vendas Importante Anexo Guia de Edio Suporte Tcnico

........................................................... 23

24 .....................................................................................

.................................................................. 25

30 ...............................................................................

Manual do Desenvolvedor (Verso 2.9)

Introduo Este manual ir auxili-lo na configurao do acesso ao Komerci, bem como na utilizao de todos os recursos e facilidades proporcionadas pelo produto. O estabelecimento dever desenvolver uma rotina prpria para a utilizao do Komerci em sua loja-virtual, seguindo, entretanto, os padres definidos neste documento. O conhecimento de verses anteriores do Komerci no desobriga a leitura deste documento.

Configuraes
Configurao mnima de hardware e software

- Processador 486 DX2-50 Mhz - 16 Mb de memria RAM - 32 Mb de espao livre em disco rgido - Modem de 28800 bps - Mouse - Plataforma Windows 95/98/NT/2000, Linux, AIX, Sun Solaris, OS/390 ou AS/400.)
Verses certificadas

Navigator 4.0, Internet Explorer 4.0 (ou verses superiores) e alguns outros browsers JDK 1.1.8 (ou verses superiores)

Certificado necessrio

Certificado de Segurana SSL 128 bits (criptografia)

Sugesto de fornecedores do Certificado SSL 128 bits

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

de inteira responsabilidade do estabelecimento a seleo e negociao com a empresa certificadora. A Redecard no possui nenhuma relao de empresas homologadas para a emisso do certificado digital. Os endereos citados acima so apenas sugestes.

Manual do Desenvolvedor (Verso 2.9)

Fluxo de transao

Check-out da Loja-Virtual:

A ilustrao abaixo um modelo de loja virtual aps a seleo dos itens desejados na compra:

Recomenda-se que na forma de pagamento sejam exibidas as opes MasterCard, Visa e Diners, assim grafadas.

Manual do Desenvolvedor (Verso 2.9)

Etapas do Fluxo:

Estas so as etapas do fluxo de dados permutados entre a Redecard e a loja-virtual durante o processo de captura de uma transao. 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 carto, por meio da loja-virtual.

Descrio das Etapas:

1-) Loja-Virtual Redecard: Solicitao de Autorizao 2-) Redecard Loja-Virtual: Retorno de Autorizao 3-) Loja-Virtual Redecard: Solicitao de Confirmao 4-) Redecard Loja-Virtual: Retorno de Confirmao 5-) Loja-Virtual Redecard: Solicitao de Comprovante de Vendas 6-) Redecard Loja-Virtual: Exibio de Comprovante de Vendas para o portador

Manual do Desenvolvedor (Verso 2.9)

1. Loja-virtual

Redecard

A loja virtual dever enviar os seguintes parmetros 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 INIFRAME TAMANHO 15 2 2 9 9 10 16 26 25 250 250 40 1 DESCRIO Valor total da compra Cdigo do tipo de transao Nmero de parcelas Nmero de filiao do estabelecimento (fornecedor) Nmero de filiao do estabelecimento (distribuidor) Bandeira do carto Nmero do pedido Texto livre para digitao Cdigo de Verificao Endereo para retorno dos dados da transao Endereo de URL da pgina ou imagem superior Nome do frame para onde ser retornado a URLBACK Indica se a tela do Komerci ser apresentada em IFRAME

Todos os parmetros citados nesta etapa do fluxo devero ser enviados atravs do mtodo POST, para: https://ecommerce.redecard.com.br/pos_virtual/form_card.asp1 No utilizar frames ou iframes na chamada do site https://ecommerce.redecard.com.br/pos_virtual. Esta prtica causar interferncias no funcionamento das pginas para determinadas configuraes/verses de browsers. O Komerci oferece a opo de exibio de "banner" das lojas, vide pgina 8 deste manual (Utilizao de parmetro URLCIMA), ou contate nosso suporte tcnico.

TOTAL

O parmetro TOTAL dever conter o valor da transao separado por . (ponto). Exemplo: 34.60 obrigatria a existncia de duas casas decimais.
TRANSAO

O parmetro TRANSACAO dever conter o cdigo do tipo de transao a ser processada, de acordo com a tabela a seguir:
Tipo de Transao vista Parcelado Emissor Parcelado Estabelecimento
1

Cdigo 04 06 08

Para solicitar a tela de captura do Komerci em outros idiomas, basta substituir este endereo por: INGLS: 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 disponvel para a bandeira MasterCard inicialmente).

Manual do Desenvolvedor (Verso 2.9)

PARCELAS

O parmetro PARCELAS dever conter o n de parcelas da transao. Ele dever ser preenchido com o valor 00 (zero zero) quando o parmetro TRANSACAO for 04, isto , vista. No possvel efetuar transaes parceladas para cartes emitidos fora do Brasil. Trata-se de uma regra dos emissores estrangeiros.
FILIAO

O parmetro FILIACAO dever conter o n de filiao do estabelecimento cadastrado junto a Redecard.


DISTRIBUIDOR

O parmetro DISTRIBUIDOR" dever conter o n de filiao do estabelecimento distribuidor. Este parmetro s dever ser preenchido se o estabelecimento do campo FILIACAO for um fornecedor. Em caso negativo, enviar este parmetro, porm em branco.

BANDEIRA

O parmetro BANDEIRA dever conter a forma de pagamento solicitada pelo usurio, em caixa alta. As opes oferecidas pelo Komerci so: MASTERCARD, VISA e DINERS. Este parmetro utilizado apenas para apresentao da logomarca correta na tela de captura do Komerci. Se, porventura, o portador digitar os dados de um carto de crdito MasterCard ou Visa na tela de captura Diners, por exemplo, o Comprovante de Vendas ser exibido de acordo com o n do carto digitado, sendo, MasterCard ou Visa.

NUMPEDIDO

O parmetro NUMPEDIDO dever conter o n do pedido referente ao produto / servio solicitado pelo usurio. Este campo dever ser preenchido de acordo com a poltica interna da loja-virtual.

PAX1

O parmetro PAX1 de preenchimento opcional.Caso o nmero de pedido ultrapasse as 16 posies permitidas para NUMPEDIDO, as demais posies podero ser includas em PAX1.

CODVER

O parmetro CODVER dever conter o cdigo de verificao gerado pelo aplicativo CodVer.class. A instruo para instalao do cdigo est descrita no tpico a seguir.

Manual do Desenvolvedor (Verso 2.9)

URLBACK

O parmetro URLBACK dever conter o endereo e pgina para onde os dados da transao devero ser retornados. No ultrapasse as 250 posies permitidas. No utilize smbolos, pontuaes ou caracteres especiais, tais como ( ! @ # & * ^ / ?). Como incremento de segurana, a loja-virtual poder cadastrar previamente uma URLBACK atravs do portal da Redecard (www.redecard.com.br). Atravs deste cadastramento prvio, ser possvel suprimir o envio do parmetro URLBACK, pois o Komerci sempre retornar os dados das transaes para quele endereo que foi cadastrado no portal.
URLCIMA

O parmetro URLCIMA dever conter o endereo da URL (em HTTPS) da pgina ou imagem a ser carregada na rea superior da tela do Komerci (conforme indicado na ilustrao abaixo):

Seguem abaixo algumas restries de utilizao deste parmetro:

Manual do Desenvolvedor (Verso 2.9)

No ultrapasse as 250 posies permitidas. No utilize smbolos, pontuaes ou caracteres especiais, tais como ( ! @ & * ^ ?). Caso o estabelecimento deixe de enviar estes parmetros, ou os envie em branco, o sistema carregar a cor da tela de captura padro. O tamanho da rea que o parmetro URLCIMA abrange fixa em 120 X 780 pixels. Este parmetro est disponvel para as bandeiras MasterCard, Visa e Diners. No caso, da bandeira Diners, existem outros parmetros de customizao possveis de serem editados. Vide tpico Anexo Guia de Edio neste documento

Manual do Desenvolvedor (Verso 2.9)

TARGET

O parmetro TARGET opcional. Ele poder conter o nome do frame para onde a Redecard retornar a URLBACK. Caso este parmetro no seja enviado, a Redecard retornar a URLBACK no target top (target=_top). Este parmetro s ser acatado para transaes da bandeira MasterCard ou Visa inicialmente

Recomenda-se a abertura da tela de captura do Komerci no prprio frame da loja-virtual para evitar problemas decorrentes da utilizao de programas bloqueadores de pop-ups por parte dos portadores de carto. Uma outra soluo para evitar problema com estes programas a exibio de um aviso, antes ou durante a transao, informando ao seu cliente sobre a necessidade de desabilitar ou desinstalar o programa bloqueador de pop-ups que ele eventualmente possua.
INIFRAME

O parmetro INIFRAME opcional. Caso seja necessrio exibir as telas do Komerci em um IFRAME, este dever ser enviado com valor igual a S.

Manual do Desenvolvedor (Verso 2.9)

10

Instrues para Instalao do Cdigo de Verificao

A loja-virtual ser responsvel por implementar uma rotina (na linguagem em que desejar) para chamar o utilitrio Java (CodVer.class) que gera o Cdigo de Verificao, seguindo, entretanto, as instrues aqui dispostas. Pr-requisito do Servidor do Lojista: Interpretador Java (JDK, por exemplo) verso 1.1.8 (mnimo) instalado. Sintaxe para chamada do utilitrio Java: # java CodVer <numfil> <total> <ip address> Onde: <numfil>: Nmero de filiao do lojista; <total>: Valor total da compra (formato ###.##) com at 12 caracteres; <ip address>: Endereo IP da mquina 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 sada poder ser direcionada para um arquivo: # java CodVer 000043201 35.50 32.147.125.76 > codver.out O contedo deste arquivo ser: 647398373692-762 Uma vez passado os argumentos corretos, ser retornado o Cdigo de Verificao. Caso seja digitado apenas: # java CodVer Sem nenhum parmetro, ser exibido um pequeno help.

Manual do Desenvolvedor (Verso 2.9)

11

Sugesto para as lojas virtuais que operam com ASP A Redecard disponibiliza para download o arquivo Cdigo de Verificao, a fim de auxiliar o desenvolvedor na integrao de sua loja virtual com o ambiente Redecard. Este arquivo contm: Pgina ASP integradora Componente ActiveX para gerao do cdigo de verificao Arquivos de suporte ao funcionamento do componente Cdigos fonte do componente Instrues detalhadas O arquivo Cdigo de Verificao est disponvel para download no link "Manuais" do Portal Redecard (www.redecard.com.br).

Todo e qualquer cdigo fornecido apenas uma sugesto para desenvolvimento, cabendo ao programador da loja virtual adequ-lo ao seu ambiente. Consulte o tpico Suporte Tcnico para obter maiores informaes.

Manual do Desenvolvedor (Verso 2.9)

12

Modelo de Cdigo Fonte Este um modelo de cdigo-fonte que a loja virtual poder utilizar para fazer a chamada para a tela de captura do Komerci:
<HTML> <HEAD> <TITLE>Esta a sua pgina 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 pgina 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 (Verso 2.9)

13

Tela de Captura As interfaces de pagamento sero exibidas de acordo com a solicitao que a loja-virtual fizer no parmetro BANDEIRA, conforme diagrama abaixo: MASTERCARD

Manual do Desenvolvedor (Verso 2.9)

14

VISA

Manual do Desenvolvedor (Verso 2.9)

15

DINERS

O Nome do Portador o nico parmetro da tela de captura que no validado junto ao emissor do carto. Este dado registrado no Relatrio de Transaes do estabelecimento conforme foi digitado pelo comprador na tela de captura.

Manual do Desenvolvedor (Verso 2.9)

16

2. Redecard

Loja-virtual 2

Transao Aprovada

Se a transao for aprovada e bem sucedida, a Redecard retornar os seguintes parmetros para a loja-virtual, em mtodo GET, atravs de sua URLBACK (previamente cadastrada ou fornecida em parmetro):
NOME DATA NUMPEDIDO NR_CARTAO ORIGEM_BIN NUMAUTOR NUMCV NUMAUTENT NUMSQN TAMANHO 8 16 16 3 6 9 27 12 DESCRIO Data da transao Nmero do Pedido Nmero do Carto mascarado Cdigo de Nacionalidade do Emissor Nmero de Autorizao Nmero do Comprovante de Venda (NSU) Nmero de Autenticao Nmero seqencial nico

DATA

O parmetro DATA retornar a data em que a transao foi efetuada (no formato aaaammdd).
NUMPEDIDO

O parmetro NUMPEDIDO retornar o n do pedido que foi informado pela loja-virtual na primeira etapa do fluxo.
NR_CARTAO

O parmetro NR_CARTAO retornar o n do carto validado junto ao emissor, de forma mascarada, deixando visvel apenas os 6 primeiros e 4 ltimos dgitos do nmero.

ORIGEM_BIN

O parmetro ORIGEM_BIN retornar o cdigo de nacionalidade do emissor do carto validado (ex: BRA= Brasil para a Mastercard e BR = Brasil para a Visa) O estabelecimento poder optar por rejeitar transaes de emissores internacionais atravs do tratamento deste parmetro.
NUMAUTOR

O parmetro NUMAUTOR retornar o n de autorizao da transao.

de inteira responsabilidade da loja-virtual fazer o tratamento de quaisquer informaes retornadas pela Redecard.

Manual do Desenvolvedor (Verso 2.9)

17

NUMCV

O parmetro NUMCV retornar o n do comprovante de vendas da transao.


NUMAUTENT

O parmetro NUMAUTENT retornar o n de autenticao da transao.


NUMSQN

O parmetro NUMSQN retornar o nmero seqencial nico da transao.

Transao No Aprovada
NOME NUMPEDIDO CODRET MSGRET TAMANHO 16 2 200 DESCRIO Nmero do Pedido Cdigo de erro Mensagem de erro

NUMPEDIDO

O parmetro NUMPEDIDO retornar o n do pedido que foi informado pela loja-virtual na primeira etapa do fluxo. Dependendo do cdigo do erro, este parmetro pode no retornar.
CODRET

O parmetro CODRET retornar o cdigo de erro se houver algum problema no processamento da transao ou se o emissor no autoriz-la por qualquer motivo.
MSGRET

O parmetro MSGRET retornar a mensagem de erro correspondente ao cdigo de erro CODRET se houver algum problema no processamento da transao ou se o emissor no autoriz-la por qualquer motivo. No caso de transaes no aprovadas, o fluxo termina nesta etapa.

Manual do Desenvolvedor (Verso 2.9)

18

Tabela de Cdigos e Mensagens de Retorno:

Cdigo
0

Mensagem Transao Aprovada

50, 52, 54, 55, 57, 59, 61, 62, 64, 66, 67, 68, 70, 71, 73, 75, 78, 79, 80, 82, 83, Transao no autorizada 84, 85, 87, 89, 90, 91, 93, 94, 95, 97, 99

Estabelecimento Invlido
51, 92, 98 Por favor, entre em contato com o estabelecimento que est efetuando a venda.

Transao Invlida
53 Por favor, entre em contato com o estabelecimento que est efetuando a venda.

Refaa a transao
76, 86 Sua transao no pode ser concluda. Por favor, refaa a transao Dados obrigatrios ausentes

Problemas com o carto


58, 63, 65, 69, 72, 77, 96 Por favor, verifique os dados de seu carto. Caso o erro persista- entre em contato com a central de atendimento de seu carto.

Dado Invlido
56, 60 Por favor, entre em contato com o estabelecimento que est efetuando a venda.

74 81

Instituio sem comunicao Banco no pertence rede

Manual do Desenvolvedor (Verso 2.9)

19

3. Loja-Virtual

Redecard

Caso a transao tenha sido aprovada pelo emissor, a loja-virtual dever confirm-la, retornando os seguintes parmetros para o endereo:
http://ecommerce.redecard.com.br/pos_virtual/confirma.asp:

O trfego destes dados no dever ocorrer atravs do browser do usurio ou com sua interferncia, ou seja, o webserver da loja-virtual dever comunicar-se diretamente com o ambiente da Redecard. Pode-se, por exemplo, utilizar componentes, servios, servlets, etc. Este procedimento garante a segurana do trfego 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 DESCRIO Data da transao Cdigo da transao de confirmao Cdigo do tipo da transao original Nmero de parcelas da transao Filiao do estabelecimento (fornecedor) Filiao do estabelecimento (distribuidor) Valor da transao Nmero do pedido Nmero da autorizao Nmero do Comprovante de Vendas Nmero seqencial nico

DATA

O parmetro DATA dever conter a data em que a transao foi efetuada (no formato aaaammdd).
TRANSACAO

O parmetro TRANSACAO dever conter o cdigo de confirmao da transao: 203.


TRANSORIG

O parmetro TRANSORIG dever conter o cdigo do tipo de transao que foi informado pela loja-virtual no campo TRANSACAO na primeira etapa do fluxo.
PARCELAS

O parmetro PARCELAS dever conter o n de parcelas da transao que foi informado pela loja-virtual no campo PARCELAS na primeira etapa do fluxo.
FILIAO

O parmetro FILIACAO dever conter o n de filiao do estabelecimento (cadastrado junto a Redecard), que foi informado pela loja-virtual no campo FILIACAO na primeira etapa do fluxo.

Manual do Desenvolvedor (Verso 2.9)

20

DISTRIBUIDOR

O parmetro DISTRIBUIDOR" dever conter o n de filiao do estabelecimento distribuidor que foi informado pela loja-virtual no campo DISTRIBUIDOR na primeira etapa do fluxo.

TOTAL

O parmetro TOTAL dever conter o valor da transao que foi informado pela lojavirtual no campo TOTAL na primeira etapa do fluxo.
NUMPEDIDO

O parmetro NUMPEDIDO dever conter o n do pedido que foi autorizado e retornado pela Redecard no campo NUMPEDIDO na segunda etapa do fluxo.

NUMAUTOR

O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao 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 no 12345 (suprimindo o valor 0 - zero).

NUMCV

O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi informado pela Redecard no campo NUMCV na segunda etapa do fluxo.

NUMSQN

O parmetro NUMSQN dever conter o n seqencial nico da transao que foi informado pela Redecard no campo NUMSQN na segunda etapa do fluxo.

IMPORTANTE: LEIA COM ATENO OS ITENS ABAIXO.

Caso a loja-virtual decida no confirmar a transao, por motivo qualquer, basta que o estabelecimento no execute esta etapa do fluxo. Neste caso, a transao ser automaticamente desfeita. Aps a autorizao da transao e o retorno dos dados URLBACK, a loja-virtual ter 02 (dois) minutos para efetuar a confirmao. Caso a transao no seja confirmada neste perodo, ela ser automaticamente desfeita. Os dados da confirmao devem ser enviados atravs do mtodo GET, em conexo HTTP (e no HTTPS).

Manual do Desenvolvedor (Verso 2.9)

21

4. Redecard

Loja-Virtual

Efetuada a confirmao, a Redecard retornar os seguintes parmetros para a loja-virtual:


NOME CODRET MSGRET TAMANHO 2 200 DESCRIO Cdigo de retorno Mensagem de retorno

CODRET

O parmetro CODRET retornar o cdigo de retorno da transao.

MSGRET

O parmetro MSGRET retornar a mensagem da transao referente ao cdigo de retorno CODRET. Se a confirmao da transao for bem sucedida, este parmetro retornar o Comprovante de Vendas para o portador do carto.

Estes parmetros so retornados aps a chamada para confirmao da transao. No 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 atravs de componente (ou servio, servlet, etc) fica mais fcil e rpido. Cdigos e Mensagens de retorno: 0 = "CONFIRMACAO COM SUCESSO"; 1 = "JA CONFIRMADA"; (transao j confirmada anteriormente) 2 = "TRANSACAO NEGADA"; 3 = "TRANSACAO DESFEITA"; (ultrapassado o tempo disponvel para confirmao) 4 = "TRANSACAO ESTORNADA"; 5 = "TRANSACAO ESTORNADA"; 8 = "DADOS NAO COINCIDEM"; 9 = "TRANSACAO NAO ENCONTRADA"; 88 = DADOS AUSENTES. TRANSAAO NAO PODE SER CONCLUIDA A loja-virtual dever tratar cada uma das mensagens de retorno e informar o portador dependendo da situao. Caso nenhum dado seja retornado, o estabelecimento dever enviar a confirmao novamente (repetir a terceira etapa do fluxo). Recomenda-se que, ao final desta etapa, a loja-virtual retorne para o usurio, o nmero do pedido, bem como os dados necessrios para o acompanhamento da compra por parte do portador do carto.

Manual do Desenvolvedor (Verso 2.9)

22

5. Loja-Virtual

Redecard

Devidamente confirmada a transao, a loja-virtual dever disparar a exibio do comprovante de venda, enviando os seguintes parmetros (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 DESCRIO Data da transao Cdigo 201 Nmero da autorizao Nmero do Comprovante de Vendas Idioma do comprovante de vendas

DATA

O parmetro DATA dever conter a data em que a transao foi efetuada (no formato aaaammdd), informado pela Redecard no campo DATA na segunda etapa do fluxo

TRANSACAO

O parmetro TRANSACAO dever conter o cdigo de exibio do cupom: 201.


NUMAUTOR

O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao 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 no 12345 (suprimindo o valor 0 - zero).

NUMCV

O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi informado pela Redecard no campo NUMCV na segunda etapa do fluxo.

IMPORTANTE: LEIA COM ATENO OS ITENS ABAIXO.

Apesar de tratar-se de uma etapa independente do fluxo, obrigao da lojavirtual exibir o comprovante de venda, preferencialmente em uma nova janela, de forma que o comprador consiga imprimir os dados. A exibio do comprovante de venda pode ocorrer mais de uma vez, mas apenas o comprador poder visualiz-lo. Caso seja solicitada a exibio do comprovante de venda para uma transao no confirmada ou no aprovada, uma mensagem de erro ser exibida.

Manual do Desenvolvedor (Verso 2.9)

23

LANGUAGE

O parmetro LANGUAGE dever conter o cdigo correspondente ao idioma utilizado na 1 etapa do fluxo de transao. Onde:
Cdigo Forma de Captura

E S

Ingls Espanhol*

* O valor S referente ao idioma Espanhol s est disponvel para transaes da bandeira MasterCard inicialmente. Comprovante de Venda Os comprovantes de vendas (ilustrados abaixo) sero exibidos de acordo com a solicitao que a loja-virtual fez no parmetro BANDEIRA, na primeira etapa do fluxo: MASTERCARD

Manual do Desenvolvedor (Verso 2.9)

24

VISA

Manual do Desenvolvedor (Verso 2.9)

25

DINERS

Ateno ! Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o pop-up para 280 X 440 pixels.

Dicas de Segurana Estes so exemplos de fonte html que podero ser gerados pelo desenvolvedor para garantir maior segurana nas transaes eletrnicas da loja-virtual. O trecho a seguir contm uma rotina de Javascript para desabilitar o boto direito do mouse. <script language = "Javascript"> Function right(e) { if (navigator.appName == 'Netscape' && (e.which == 3 || e.which == 2)) Return false;

Manual do Desenvolvedor (Verso 2.9)

26

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 contm uma rotina de Javascript para desabilitar o menu, a barra de rolagem e outros itens da pgina. <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 (Verso 2.9)

27

Teste na Loja-Virtual Para efetuar os testes na plataforma do Komerci antes de implement-la, a Redecard recomenda que o estabelecimento realize transaes em ambiente produtivo, estornando-as no mesmo dia da venda, por meio do Gerenciador de Vendas, disponvel no Portal Redecard.

Gerenciamento de Vendas O Komerci possui uma srie de funcionalidades para gerenciamento das transaes processadas, tais como: Estorno de Transaes: O Estorno permite que o estabelecimento possa cancelar transaes on-line que foram realizadas atravs do Komerci. Este servio s est disponvel para transaes realizadas no mesmo dia da venda (at s 23:59h do horrio oficial de Braslia). Resumo de Vendas: O Resumo de Vendas um documento que exibe a somatria diria de todas as transaes confirmadas e faturadas. Ele fica disponvel no sistema por 5 dias, de modo que se ele no for extrado durante este perodo, no ser mais possvel visualiz-lo. Por isso, recomenda-se a extrao diria do mesmo. Relatrio de Transaes: O Relatrio de Transaes uma ferramenta que disponibiliza por trs meses a consulta de todos os dados pertinentes s transaes efetuadas atravs do Komerci. Manuais: Esta funo armazena a ltima verso dos manuais operacionais do Komerci para download.

Estas funcionalidades esto disponveis no Portal Redecard. Para utilizar o Portal Redecard, basta que o estabelecimento efetue cadastro no endereo: www.redecard.com.br com sua filiao da tecnologia Komerci.

Manual do Desenvolvedor (Verso 2.9)

28

Importante

Os procedimentos que confirmam a realizao da compra pelo cliente, como o envio de email, a confirmao por telefone e a consulta de banco de dados interno, so prticas complementares que devem ser realizadas pelo estabelecimento. Esses procedimentos podem reduzir o risco da transao comercial realizada via Internet, e j so prticas comuns adotadas pela maioria dos estabelecimentos, mas particularmente recomendadas quando o valor da compra for elevado. Ateno: importante verificar o status da transao antes de iniciar o processo de entrega dos produtos adquiridos ou execuo dos servios contratados pelos consumidores. Apenas transaes com o status de Confirmada (vide Relatrio de Transaes do Komerci) que devem ser consideradas como bem sucedidas, exceto se tiverem sido canceladas posteriormente. A Redecard entende que a deciso final de efetivao da venda deve sempre ficar a cargo do estabelecimento, principalmente em se tratando da comparao de informaes que so digitadas e, conseqentemente, passveis 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 clusulas contratuais previstas para este tipo de comercializao, salvo algumas excees (ex: Komerci SecureCode para a Mastercard e VBV Verified By Visa para a VISA, acordos locais, etc).

Manual do Desenvolvedor (Verso 2.9)

29

Anexo Guia de Edio

Este guia s est disponvel para a bandeira Diners. Caso o estabelecimento popule estes parmetros em transaes das bandeiras MasterCard ou Visa, eles sero descartados. O nico que ser acatado a URLCIMA, que j foi descrito anteriormente neste guia.

Introduo

Este guia ir auxili-lo na edio e personalizao da interface de pagamento do Komerci, bem como na utilizao de todos os recursos proporcionados pelo sistema.

Programao Especfica

Para editar a tela de captura do Komerci, o estabelecimento dever enviar dados adicionais na primeira etapa da transao.

Fluxo de Transao

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 transao, seguindo as instrues detalhadas em seguida:
NOME URLCIMA URLBAIXO CORBKG CORTOP1 CORTOP2 CORLEFT1 CORLEFT2 CORRIGHT1 CORRIGHT2 CORBTN1 CORBTN2 CORPOPUP1 CORPOPUP2 CORPOPUP3 TAMANHO 250 250 6 6 6 6 6 6 6 6 6 6 6 6 DESCRIO Endereo de URL da pgina ou imagem superior Endereo de URL da pgina ou imagem inferior Cor de fundo da tela de captura Cor da fonte do ttulo superior Cor da fonte do sub-ttulo superior Cor da fonte do ttulo esquerdo Cor da fonte do texto esquerdo Cor da fonte do ttulo direito Cor da fonte do formulrio direito Cor de fundo dos botes Cor da fonte do texto dos botes Cor de fundo do pop-up Cor da fonte do ttulo do popup Cor da fonte do texto do popup

Manual do Desenvolvedor (Verso 2.9)

30

URLCIMA / URLBAIXO

O parmetro URLCIMA e/ou URLBAIXO dever conter o endereo da URL (em HTTPS) da pgina ou imagem a ser carregada nas reas correspondentes. No ultrapasse as 250 posies permitidas. No utilize smbolos, pontuaes ou caracteres especiais, tais como ( ! @ & * ^ ?). Caso o estabelecimento deixe de enviar estes parmetros, ou os envie em branco, o sistema carregar a cor da tela de captura padro. O tamanho da rea que o parmetro URLCIMA abrange fixa em 120 X 780 pixels. O tamanho da rea que o parmetro URLBAIXO abrange fixo em 80 X 780 pixels para a tela de captura simples ou de Pr-Autorizao e 50 X 780 pixels para a tela de captura contemplando o servio de AVS. Como a construo da tela de captura depende de javascript na pgina da loja-virtual, existe a possibilidade de aumentar sua altura, porm somente da barra inferior (URLBAIXO).

CORBKG

O parmetro 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 parmetro, o envie em branco ou incorretamente, o sistema carregar a cor da tela padro.

CORTOP1

O parmetro CORTOP1 dever conter a cor de fonte do ttulo superior: Sistema Seguro de Pagamento no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORTOP2

O parmetro CORTOP2 dever conter a cor de fonte do sub-ttulo superior: Voc est em um ambiente de compra seguro... no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORLEFT1

O parmetro CORLEFT1 dever conter a cor de fonte do ttulo esquerdo: Sua Compra no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

Manual do Desenvolvedor (Verso 2.9)

31

CORLEFT2

O parmetro 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 parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORRIGHT1

O parmetro CORRIGHT1 dever conter a cor de fonte do ttulo direito: Seus Dados no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORRIGHT2

O parmetro CORRIGHT2 dever conter a cor de fonte do formulrio direito: Nmero do Carto, Validade do Carto, Nome do Portador... no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORBTN1

O parmetro CORBTN1 dever conter a cor de fundo dos botes: Enviar, Limpar (tela de captura) e Fechar (pop-up) no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fundo padro.

CORBTN2

O parmetro CORBTN2 dever conter a cor de fonte dos botes: Enviar, Limpar (tela de captura) e Fechar (pop-up) no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORPOPUP1

O parmetro CORPOPUP1 dever conter a cor de fundo do pop-up no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fundo padro.

Manual do Desenvolvedor (Verso 2.9)

32

CORPOPUP2

O parmetro CORPOPUP2 dever conter a cor de fonte do ttulo do pop-up Por que Seguro? no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

CORPOPUP3

O parmetro CORPOPUP3 dever conter a cor de fonte do texto do pop-up no formato RGB hexadecial (RRGGBB). Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.

Manual do Desenvolvedor (Verso 2.9)

33

Layout dos Parmetros

CORTOP1 CORTOP2

URLCIMA

CORLEFT1

CORRIGHT1

CORBKG

CORBTN1 CORLEFT2 CORRIGHT2 CORBTN2

URLBAIXO

Caso a loja-virtual no envie nenhum dos parmetros extras descritos neste guia, o sistema carregar a interface de pagamento padro.
CORPOPUP2

CORPOPUP1

CORPOPUP3

CORBTN1

CORBTN2

Manual do Desenvolvedor (Verso 2.9)

34

Suporte Tcnico A Redecard possui uma equipe de suporte tcnico especializada no atendimento aos desenvolvedores das lojas-virtuais durante sua integrao ao sistema de captura, Komerci. Para usufruir plenamente deste servio, por favor, atente s seguintes recomendaes: Ao entrar em contato com o suporte tcnico, tenha em mos o nmero de FILIAO do estabelecimento / loja-virtual. O nmero de filiao importante para que o suporte identifique o estabelecimento, e para que possa prestar informaes especficas. Certifique-se de ter lido todos os manuais referentes ao produto contratado, que todas as especificaes tcnicas foram seguidas, e sem adaptaes. O suporte tcnico est apto a resolver qualquer dvida ou problema tcnico que o desenvolvedor tenha durante a integrao com o Komerci, porm, no ser fornecido suporte a linguagens de programao ou cdigos fonte, ainda que fornecidos pelo desenvolvedor. O suporte tcnico no est autorizado a fornecer ou receber nmeros de cartes de crdito, vlidos ou no, ainda que para testes. O suporte tcnico no atende questes referentes aquisio do produto, upgrade, contratao dos servios de AVS e Pr-Autorizao, custos e taxas, dados cadastrais, habilitao de funes e do nmero de filiao. Nestes casos, o lojista dever entrar em contato com o representante comercial da Redecard que atende seu estabelecimento.

Dvidas, referentes ao desenvolvimento do Komerci devero ser esclarecidas com o nosso Suporte Tcnico Komerci.

Contato: Suporte Tcnico


Telefones de Atendimento: Capitais e Litoral: 4001-4433 Outras localidades: 0800-784433

Horrio de Atendimento:
Das 08h s 20h40, segunda sexta Email: loja.virtual@redecard.com.br

Acesse sempre redecard.com.br e confira alguns dos nossos servios: Extrato OnLine, Servios 48h (Pesquisas de Dbito e Crdito) e Cancelamento de vendas.

Manual do Desenvolvedor (Verso 2.9)

35