Manual KomerciIntegrado

Manual do Desenvolvedor Komerci Integrado
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.8.1 2.9 3.0
07/07/09 09/06/10 01/07/10 20/09/10
- Novo telefone do Suporte Komerci - Incluso do parmetro INIFRAME na 1 etapa da transao - Incluso da bandeira Visa - Reformulao e consolidao de Manuais de Integrao
Manual do Desenvolvedor (Verso 3.0)
ndice
Contedo
Introduo .................................................................................................................... 3 Credenciamento da tecnologia Komerci, Produtos e Servios ............................... 3 Configuraes .............................................................................................................. 4 Fluxo de transao ...................................................................................................... 5 Instrues para Instalao do Cdigo de Verificao ............................................. 13 Modelo de Cdigo Fonte ........................................................................................... 15 Tela de Captura .......................................................................................................... 16
Servio de Verificao de dados Cadastrais AVS ............................................................. 21
Tabela de Cdigos e Mensagens de Retorno: ......................................................... 25 Comprovante de Venda ............................................................................................. 33 Dicas de Segurana ................................................................................................... 34 Teste na Loja-Virtual .................................................................................................. 35 Gerenciamento de Vendas ........................................................................................ 35 Importante .................................................................................................................. 36 Anexo 1 Guia de Edio ......................................................................................... 37 Anexo 2 - Confirmao / Desfazimento / Estorno de Confirmao de PrAutorizao / Relatrio de Transaes do Komerci ............................................... 42 Anexo 3 Motivos das Mensagens de Erro ............................................................. 47 Suporte Tcnico ......................................................................................................... 49
Introduo
Este manual ir auxili-lo no desenvolvimento e configurao para acesso ao Komerci, bem como na utilizao de todos os recursos e facilidades proporcionadas por essa tecnologia.
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.
Credenciamento da tecnologia Komerci, Produtos e Servios

Para implantao da soluo do Komerci Integrado e WebService necessrio efetuar o credenciamento prvio junto a Redecard. Servios de AVS, Mastercard SecureCode e Verified By Visa devem ser contratados previamente para sua habilitao. Os estabelecimentos podem se credenciar ou contratar servios atravs dos seguintes telefones da central de atendimento: Capitais e Regies Metropolitanas: 4001-4433 Outras localidades: 0800-784433
Configuraes
Configurao mnima de hardware e software para Clientes
Pentium III 450 MHz ou AMD Athlon equivalente ou superior 256 Mb de memria RAM 500 Mb de espao livre em disco rgido Modem de 28800 bps Mouse, Teclado e Monitor Plataforma Windows (98 ou superior), Linux ou Mac OS
Verses certificadas
Internet Explorer 6.0 (ou verses superiores) e Mozilla Firefox 3.0.19 (ou verses superiores)
Certificado digital obrigatrio

Certificado de Segurana SSL 128 bits (criptografia)
So 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.
Fluxo de transao
Checkout 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.
Etapas do Fluxo:
Estas so as etapas do fluxo de dados trocados entre a Redecard e a loja-virtual durante o processo de captura de uma transao. Cada uma das etapas ser detalhada a seguir.
Descrio das Etapas:
1-) Loja-Virtual 2-) Redecard 3-) Loja-Virtual 4-) Redecard 5-) Loja-Virtual 6-) Redecard
Redecard: Solicitao de Autorizao Loja-Virtual: Retorno de Autorizao Redecard: Solicitao de Confirmao Loja-Virtual: Retorno de Confirmao Redecard: Solicitao de Comprovante de Vendas Loja-Virtual: Exibio de Comprovante de Vendas para o portador
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 NUMDOC1 PAX1 NUMDOC2 PAX2 NUMDOC3 PAX3 NUMDOC4 PAX4 CODVER URLBACK URLCIMA TARGET INIFRAME AVS IATA TAXAEMBARQUE LANGUAGE TAMANHO 15 2 2 9 9 10 16 14 26 14 26 14 26 14 26 25 250 250 40 1 1 8 15 3 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 Somente Companhia Area N do Bilhete Companhia Area Nome do Passageiro Principal. Demais Ramos Texto livre para digitao. Somente Companhia Area N do Bilhete Somente Companhia Area Nome do Passageiro Somente Companhia Area N do Bilhete Somente Companhia Area Nome do Passageiro Somente Companhia Area N do Bilhete Somente Companhia Area Nome do Passageiro 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 Servio de AVS Nmero do cdigo IATA (Exclusivo para Companhia Area) Taxa de embarque da transao (Exclusivo para Companhia Area) Idioma para apresentao dos textos
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.asp Caso a tela do Komerci seja exibida em um iframe, ser necessria a utilizao do parmetro INIFRAME = S. Caso contrrio, podero ocorrer problemas no funcionamento do Komerci. No utilizar frames 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 10 deste manual (Utilizao de parmetro URLCIMA), ou contate nosso suporte tcnico.
TOTAL
O parmetro TOTAL dever conter o valor total da transao. Este valor dever ser separado por . (ponto). Exemplo: 34.60 No deve conter separador de milhar obrigatria a existncia de duas casas decimais. O parmetro TOTAL deve ser enviado em todas as etapas e sempre da mesma forma.
TRANSACAO
O parmetro TRANSACAO dever conter o cdigo do tipo de transao a ser processada, de acordo com a tabela a seguir: Tabela 1 Tipo de Transao vista Parcelado Emissor Parcelado Estabelecimento Pr-Autorizao IATA Vista IATA Parcelado
Cdigo 04 06 08 73 39 40
As transaes IATA (Cdigo 39 e 40) so especficas para operaes de venda de Companhias Areas.
No caso de Pr-Autorizao, o parmetro TRANSACAO dever conter o cdigo 73. Este cdigo nico para transaes vista ou parceladas, a escolha da forma de pagamento (a vista ou parcelada) feita no momento da confirmao da transao (vide pgina 30). No possvel efetuar transaes parceladas para cartes emitidos fora do Brasil. Trata-se de uma regra dos emissores estrangeiros. O cdigo 73 refere-se apenas a solicitao do pedido de autorizao, somente na etapa de confirmao da Pr-Autorizao dever ser informado se a transao ser a vista ou parcelada. Se a opo for parcelada deve ser informado o n de parcelas.
Portanto, imprescindvel que a loja-virtual capture o valor do parmetro PARCELAS, que foi solicitado pelo usurio.
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 ou 39, ser vista.
FILIACAO
O parmetro FILIACAO dever conter o n de filiao do estabelecimento cadastrado com 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 vazio.
BANDEIRA
O parmetro BANDEIRA dever conter a forma de pagamento solicitada pelo usurio, em caixa alta. As opes oferecidas pelo Komerci so: Bandeira Mastercard Diners Visa Valor que deve ser informado MASTERCARD DINERS 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. O sistema da Redecard no valida esse parmetro.
PAX1
O parmetro PAX1 de preenchimento opcional para ramos de atividade que no so do segmento de Companhias Areas. Neste caso, este campo pode ser utilizado como livre para incluso de dados adicionais. Caso o nmero de pedido ultrapasse as 16 posies permitidas para NUMPEDIDO, as demais posies podero ser includas em PAX1. No caso de segmento de Companhias Areas o parmetro PAX1 obrigatrio e deve conter o nome do passageiro principal.
PAX2, PAX3 e PAX 4

Estes parmetros so enviados somente quando a transao a ser confirmada for de Companhia Area. Os parmetros PAX2, PAX3 e PAX4 so de preenchimento opcional. Eles podem ser utilizados para o registro do nome dos passageiros, correspondentes ao nmero dos bilhetes informados nos parmetros NUMDOC.
NUMDOC1, NUMDOC2, NUMDOC3 e NUMDOC4

Estes parmetros so enviados somente quando a transao for do segmento de Companhia Area. Os parmetros NUMDOC2, NUMDOC3 e NUMDOC4 so de preenchimento opcional. Eles podem ser utilizados para o registro do nmero dos bilhetes das passagens areas transacionadas.
A nica exceo para o NUMDOC1, que um parmetro obrigatrio no caso do segmento de Companhia Area. 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 na Pgina 13.
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):
10
Seguem abaixo algumas restries de utilizao deste parmetro:
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. recomendado que a loja envie os parmetros para apresentao da identidade da loja virtual corretamente na pagina do Komerci, pois assim o portador no perde a identidade da loja virtual em que ele esta efetuando a compra. O tamanho da rea que o parmetro URLCIMA abrange fixa em 120 X 780 pixels. Este parmetro est disponvel tanto para a bandeira MasterCard quanto para as bandeiras Diners e Visa. No caso, da bandeira Diners, existem outros parmetros de customizao possveis de serem editados. Vide tpico Anexo Guia de Edio neste documento. As configuraes existentes neste anexo s esto disponveis no Komerci apenas no caso de bandeira Diners.
11
TARGET
O parmetro TARGET opcional. Ele poder conter o nome do iframe 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 e Visa inicialmente. Recomenda-se a abertura da tela de captura do Komerci na prpria pgina da lojavirtual para evitar problemas decorrentes da utilizao de programas bloqueadores de pop-ups por parte dos portadores de carto. 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.
AVS (Parmetro Opcional)

O parmetro AVS dever conter a sigla S somente quando a loja-virtual solicitar uma transao contemplando o servio de AVS. Se o estabelecimento no desejar complementar a transao com a consulta do produto AVS, no enviar este parmetro. Para a utilizao do Produto AVS a loja virtual deve solicitar a habilitao do servio atravs da Central de Atendimento Redecard. As funcionalidades do Produto AVS esto descritas na Pgina 21
IATA (Parmetro Opcional)

O parmetro IATA" dever conter o Cdigo IATA do estabelecimento fornecedor. O preenchimento deste parmetro opcional. Este parmetro somente dever ser enviado para estabelecimentos do ramo de Companhias Areas. O cdigo IATA um registro da Companhia Area fornecido pela Associao Internacional de Transporte Areo (IATA). Esse dado no armazenado e nem validado pela Redecard, apenas trafegado no momento da transao.
TAXAEMBARQUE (Parmetro Opcional)

O parmetro TAXAEMBARQUE dever conter o valor referente taxa de embarque da transao. Este parmetro dever ser preenchido apenas no caso de Companhia Area. Caso no se aplique seu envio, deve ser valor vazio.
LANGUAGE (Parmetro Opcional)

O parmetro LANGUAGE dever conter o valor referente ao idioma no qual se quer exibir os textos da tela do Komerci. Idioma Ingls Portugus Cdigo ENG POR
12
Instrues para Instalao do Cdigo de Verificao

A loja-virtual ser responsvel por programar 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.
13
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 nos links "Manuais Diversos" / Vendas pela internet e televendas do Portal Redecard (www.redecard.com.br). Deve-se, antes, acessar o portal de servios com o nmero de estabelecimento e senha.
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.
14
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> </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>
15
Tela de Captura
As interfaces de pagamento sero exibidas de acordo com a solicitao que a loja-virtual fizer no parmetro BANDEIRA. Caso tenha sido atribudo o parmetro AVS (Este parmetro disponvel apenas para bandeiras MASTERCARD e DINERS), a tela apresentar dados referentes a essa modalidade. Conforme diagrama abaixo:
MASTERCARD Sem AVS
16
MASTERCARD Com AVS
17
DINERS Sem AVS
DINERS Com AVS
18
VISA SEM AVS
O Nome do Portador o nico parmetro da tela de captura que no validado junto ao emissor do carto de nenhuma das Bandeiras. Este dado registrado no Relatrio de Transaes do estabelecimento conforme digitao feita pelo comprador na tela de captura do Komerci. Obs.: Para transaes VISA, a opo AVS no est disponvel.
19
2. Redecard
Loja-virtual
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 DATA_EXPI TAMANHO 8 16 16 3 6 9 27 12 8 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 de Expirao da Transao
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, os demais nmeros sero mascarados.
ORIGEM_BIN
O parmetro ORIGEM_BIN retornar o cdigo de nacionalidade do emissor do carto validado .O estabelecimento poder optar por rejeitar transaes de emissores estrangeiros (emitidos fora do Brasil) atravs do tratamento deste parmetro. Nos casos de bandeiras: Mastercard e Diners, este parmetro retornado com o padro de trs caracteres para designar o pas emissor (Exemplo: BRA para Brasil). Na situao de bandeira Visa, este parmetro retornado com o padro de dois caracteres para designar o pas emissor (Exemplo: BR para Brasil).
de inteira responsabilidade da loja-virtual fazer o tratamento de quaisquer informaes retornadas pela Redecard.
20
NUMAUTOR
O parmetro NUMAUTOR retornar o n de autorizao da transao.
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.
DATA_EXPI
O parmetro DATA_EXPI retornar a data de expirao da transao de Pr-Autorizao (no formato: aaaammdd). Este campo ser retornado apenas para transaes de pr-autorizao (TRANSACAO = 73).
Se o estabelecimento utilizar transaes de pr-autorizao, a confirmao dessa transao dever ser feita at a data contida no parmetro DATA_EXPI. Aps essa data a transao ser desfeita e outra transao ter que ser feita para que seja efetivada a sua confirmao.
Servio de Verificao de dados Cadastrais AVS

O Servio de Verificao de Dados Cadastrais (AVS) um servio de verificao on-line de dados cadastrais dos portadores de cartes MasterCard e Diners Club International, emitidos no Brasil. oferecido aos estabelecimentos credenciados que efetuam vendas atravs de marketing direto e comrcio eletrnico, com o objetivo de oferecer maior segurana nas vendas realizadas sem a presena fsica do portador do carto. No momento da compra, o estabelecimento, por meio do Servio AVS, pode validar junto ao emissor do carto, o nmero do CPF e dados numricos do endereo da entrega da fatura do titular do carto.
Transaes de Pr Autorizao podem ser capturadas com AVS. A implementao de AVS depende da contratao de servios adicionais. Para transaes VISA esta opo no esta disponvel. Caso o parmetro AVS = S for informado, no ser habilitada a captura atravs de Secure Code, independentemente de o servio estar contratado junto a Redecard. O servio AVS inibe o Secure Code (Vide Manual de Integrao Secure Code / Verified by Visa). Manual do Desenvolvedor (Verso 3.0)
21
Em caso de servio AVS, os seguintes dados complementares sero retornados quando a transao for aprovada e bem sucedida: NOME TAMANHO DESCRIO ENDERECO 45 Endereo de recebimento de fatura do carto (rua/avenida) NUMERO 5 Nmero do endereo de recebimento de fatura do carto Complemento do endereo de recebimento de fatura do COMPLEMENTO 18 carto CEP 9 CEP do endereo de recebimento de fatura do carto DATA_EXPI 8 Data de expirao da transao RESPAVS 2 Cdigo de retorno do AVS MSGAVS 80 Mensagem de retorno do AVS
ENDERECO
O parmetro ENDERECO retornar o logradouro (rua, avenida) do endereo de entrega da fatura do portador do carto (que foi digitado pelo portador na tela de captura do Komerci).
NUMERO
O parmetro NUMERO retornar o nmero do endereo de entrega da fatura do portador do carto (que foi digitado pelo portador na tela de captura do Komerci).
COMPLEMENTO
O parmetro COMPLEMENTO retornar o complemento (apto., andar, quadra, bloco...) do endereo de entrega da fatura do portador do carto (que foi digitado pelo portador na tela de captura do Komerci).
CEP
O parmetro CEP retornar o CEP (com hfen) do endereo de entrega da fatura do portador do carto (que foi digitado pelo portador na tela de captura do Komerci).
RESPAVS
O parmetro RESPAVS retornar o cdigo referente consulta dos dados cadastrais digitados pelo portador do carto.
MSGAVS
O parmetro MSGAVS retornar a mensagem de AVS correspondente ao cdigo RESPAVS. Os dados que podero ser retornados nos parmetros RESPAVS e MSGAVS so:
22
CDIGO (RESPAVS)
W X Z Y A U S N
DESCRIO (MSGAVS)
Sim, todos os dgitos coincidem. O CEP e CPF coincidem, endereo no coincide. Endereo e CPF coincidem, CEP no coincide. O CEP coincide, CPF e endereo no coincidem. CPF coincide, CEP e endereo no coincidem. O CEP e CPF no coincidem, endereo coincide. O CEP e endereo coincidem, CPF no coincide. Nada coincide.
Em alguns casos, o parmetro RESPAVS pode retornar cdigos compostos por dois dgitos numricos, conforme tabela abaixo. O parmetro MSGAVS, nesta situao, retornar a mensagem correspondente ao cdigo e ser esse dado que constar no Relatrio de Transaes.
CDIGO DESCRIO (MSGAVS) (RESPAVS)

53 74 81 Transao Invlida (AVS no contratado) Instituio sem comunicao Banco no pertence rede ou Carto Corporativo
CDIGO TRANSAO *
R R B
RELATRIO
Nos casos acima, os cdigos apresentados no Relatrio de Transao Komerci so os que constam na coluna CODIGO RELATORIO TRANSACAO. Caso seja retornado algum cdigo diferente destes citados acima, vide tpico Tabela de Cdigos e Mensagens de Retorno na pgina 25. Orientao ao desenvolvedor: No sistema AVS, cada cdigo de retorno possui um significado diferente (conforme tabela de descrio da resposta AVS) A deciso de confirmar ou negar uma transao dependendo do cdigo de retorno AVS, uma deciso da loja virtual. No caso de confirmao, a loja-virtual dever enviar para a Redecard os parmetros da terceira etapa do fluxo, conforme especificado neste manual. Para recusar a transao, basta terminar o fluxo nesta etapa, ou seja, no enviar a terceira etapa do fluxo da transao
23
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.
24
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, Transao no autorizada 78, 79, 80, 82, 83, 84, 85, 87, 89, 90, 91, 93, 94, 95, 97, 99 51, 92, 98
Estabelecimento Invlido
Por favor, entre em contato com o estabelecimento que est efetuando a venda.
53
Transao Invlida
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, Por favor, verifique os dados de seu carto. 72, 77, 96 Caso o erro persista- entre em contato com a central de atendimento de seu carto.
56, 60
Dado Invlido
74 81
Instituio sem comunicao Banco no pertence rede Para outros detalhes das possveis causas dos erros acima descritos, ver Anexo 3 Motivos das Mensagens de Erro.
25
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: https://ecommerce.redecard.com.br/pos_virtual/confirma.asp: A etapa de confirmao deve ocorrer somente quando a etapa anterior (Autorizao) no tiver apresentado nenhum retorno de erro e tenha retornado os dados da autorizao, tais como: NUMCV, NUMAUTOR e NUMSQN.Ou seja, essa etapa somente deve ser executada se a transao teve o retorno positivo. 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 que permitam a comunicao Server x Server atravs de protocolo HTTPS. Este procedimento garante a segurana do trfego dos dados entre a Redecard e a sua loja-virtual. NOME DATA TRANSACAO TRANSORIG PARCELAS FILIACAO DISTRIBUIDOR TOTAL NUMPEDIDO NUMAUTOR NUMCV NUMSQN NUMDOC1 PAX1 NUMDOC2 PAX2 NUMDOC3 PAX3 NUMDOC4 PAX4 IATA TAXAEMBARQUE TAMANHO 8 3 2 2 9 9 15 16 6 9 12 14 26 14 26 14 26 14 26 8 15 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 N do Bilhete Nome do Passageiro N do Bilhete Nome do Passageiro N do Bilhete Nome do Passageiro N do Bilhete Nome do Passageiro Nmero do cdigo IATA Taxa de embarque da transao
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.
26
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 lojavirtual no campo PARCELAS na primeira etapa do fluxo.
Cartes emitidos no exterior no podem conter transaes parceladas, essa uma determinao dos emissores internacionais. FILIACAO
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.
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. Este parmetro s dever ser preenchido se o estabelecimento do campo FILIACAO for um fornecedor. Em caso negativo, enviar este parmetro, porm vazio.
TOTAL
O parmetro TOTAL dever conter o valor da transao que foi informado pela loja virtual no campo TOTAL na primeira etapa do fluxo. Este valor dever ser separado obrigatoriamente por . (ponto). Exemplo: 34.60 obrigatria a existncia de duas casas decimais, ou seja da mesma forma que foi enviado na 1 etapa. No deve conter separador de milhar.
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 (a loja virtual no deve suprimir o valor 0 - zero). Podem ocorrer casos em que nesse parmetro constam letras, portanto, tambm ser necessrio retornar exatamente a informao enviada. Ex. Caso tenha letra maiscula no poder ser enviada minscula, pois a mesma no ser confirmada.
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.
27
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.
PAX1
O parmetro PAX1 de preenchimento opcional para ramos de atividade que no so do segmento de Companhias Areas. Neste caso, este campo pode ser utilizado como livre para incluso de dados adicionais. Caso o nmero de pedido ultrapasse as 16 posies permitidas para NUMPEDIDO, as demais posies podero ser includas em PAX1. No caso de segmento de Companhias Areas o parmetro PAX1 obrigatrio e deve conter o nome do passageiro principal.
PAX2, PAX3 e PAX 4

Estes parmetros so enviados somente quando a transao a ser confirmada for de Companhia Area. Os parmetros PAX2, PAX3 e PAX4 so de preenchimento opcional. Eles podem ser utilizados para o registro do nome dos passageiros, correspondentes ao nmero dos bilhetes informados nos parmetros NUMDOC.
NUMDOC1, NUMDOC2, NUMDOC3 e NUMDOC4

Estes parmetros so enviados somente quando a transao for do segmento de Companhia Area. Os parmetros NUMDOC2, NUMDOC3 e NUMDOC4 so de preenchimento opcional. Eles podem ser utilizados para o registro do nmero dos bilhetes das passagens areas transacionadas.
A nica exceo para o NUMDOC1, que um parmetro obrigatrio no caso do segmento de Companhia Area. IATA
Este parmetro enviado somente quando a transao a ser confirmada for de Companhia Area. O parmetro IATA" dever conter o Cdigo IATA do estabelecimento fornecedor. O preenchimento deste parmetro opcional. O cdigo IATA um registro da Companhia area fornecido pela Associao Internacional de Transporte Areo (IATA). Esse dado no armazenado e nem validado pela Redecard, apenas trafegado no momento da transao.
TAXAEMBARQUE
Este parmetro enviado somente quando a transao a ser confirmada for de Companhia Area. O parmetro TAXAEMBARQUE dever conter o valor referente taxa de embarque da transao que foi informado pela loja-virtual na primeira etapa do fluxo.
ATENO
Caso a loja-virtual decida no confirmar a transao, por motivo qualquer, basta que o estabelecimento no execute esta etapa de confirmao do fluxo da transao. Neste caso, a transao ser automaticamente desfeita.
28
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 HTTPS.
29
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 cdigo HTML. retornado somente uma nica linha de texto. Como por exemplo: CODRET=0&MSGRET=CONFIRMACAO+COM+SUCESSO. Desta forma, o tratamento do retorno ser realizado atravs de outro componente, como um servio, servlet ou outra rotina programada.
Cdigos e Mensagens de retorno:

0 = "CONFIRMACAO COM SUCESSO" 1 = "JA CONFIRMADA" A confirmao foi realizada com sucesso e efetivada;
A transao j foi confirmada anteriormente; A transao de confirmao foi negada pelo autorizador;
2 = "TRANSACAO NEGADA"
3 = "TRANSACAO DESFEITA" A transao foi desfeita pois o tempo disponvel de dois minutos para confirmao foi ultrapassado; 4 = "TRANSACAO ESTORNADA" estorno de transao; 5 = "TRANSACAO ESTORNADA" estorno de transao; A transao foi estornada anteriormente pelo processo de A transao foi estornada anteriormente pelo processo de
8 = "DADOS NAO COINCIDEM" Dados de Total e Nmero de Pedido no conferem com o Nmero de Comprovante e Autorizao passados como parmetro; 9 = "TRANSACAO NAO ENCONTRADA" No foi encontrada nenhuma transao para os respectivos campos passados como parmetro: NUMCV, NUMAUTOR e DATA; 88 = DADOS AUSENTES. TRANSAAO NAO PODE SER CONCLUIDA Algum dado obrigatrio no foi informado como parmetro (DATA, TRANSACAO, TRANSORIG, PARCELAS, TOTAL, NUMPEDIDO, NUMAUTOR, NUMCV, NUMSQN e FILIACAO)
30
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.
31
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). Podem ocorrer casos em que nesse parmetro constem letras.
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 loja-virtual exibir o comprovante de venda, preferencialmente em uma nova janela, de forma que o comprador consiga imprimir os dados. Exceto para a modalidade de transao =73, pois se trata de um pedido de Pr-Autorizao. Contudo, cabe a loja virtual informar ao cliente atravs de uma mensagem se a transao da modalidade de Pr-Autorizaco foi aprovada ou no, o Comprovante de Vendas nesse caso poder ser apresentada na ETAPA de CONFIRMAAO da Pr-Autorizao. 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. O comprovante de vendas somente apresentado para transaes aprovadas.
LANGUAGE
O parmetro LANGUAGE dever conter o cdigo correspondente ao idioma utilizado na 1 etapa do fluxo de transao. Onde:
32
Cdigo E
Forma de Captura Ingls
No caso de idioma Portugus este parmetro deve ser enviado em branco.
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
VISA
DINERS
Ateno!
Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima), configure o pop-up para 280 X 440 pixels.
33
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; Else if (navigator.appName == 'Microsoft Internet Explorer' && (event.button == 2 || event.button == 3)) { Alert("REDECARD ONLINE"); Return false; } } 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>
34
Teste na Loja-Virtual
Para efetuar os testes na plataforma do Komerci Integrado antes de disponibilizar na loja virtual, a Redecard recomenda que o estabelecimento realize transaes em ambiente produtivo, estornando-as no mesmo dia da submisso da transao , atravs do portal da Redecard (www.redecard.com.br) na opo ESTORNO. Nesse caso a loja virtual deve possuir o N de credenciamento vlido e carto de teste vlido.
Gerenciamento de Vendas
O Komerci possui uma srie de funcionalidades para gerenciamento das transaes processadas das Bandeiras, MASTERCARD, VISA e DINERS, tais como: Estorno de Transaes: O Estorno permite que o estabelecimento possa cancelar transaes on-line que foram realizadas atravs do Komerci Integrado. 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. 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 15 dias, a partir da data de solicitao do relatrio, a consulta de todos os dados pertinentes s transaes efetuadas atravs de qualquer tipo de Komerci. Manuais: Esta funo armazena a ltima verso dos manuais operacionais do Komerci Integrado 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.
35
Importante
Os procedimentos que confirmam a realizao da compra pelo cliente, como o envio de e-mail, a confirmao por telefone, procedimentos de monitoring e a consulta de banco de dados interno, so prticas complementares que devem ser realizadas pelo estabelecimento. Esses procedimentos podem reduzir o risco de fraude de 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 atravs do portal Redecard) que devem ser consideradas como bem sucedidas, exceto se tiverem sido canceladas posteriormente. Sempre conferir a efetivao da transao no Relatrio de Transaes do Komerci antes de submeter a entrega do produto ou servio. Transaes DESFEITAS no so faturadas, ou seja, no so creditadas pela Redecard. Os status das transaes podem ser consultados atravs do Relatrio de Transaes do Komerci. Indicao referente a empresas de Hosting, desenvolvedores, ou empresas de monitoring, no so fornecidas pela Redecard. Essas empresas podem ser encontradas atravs de sites de busca. A deciso final de efetivao da venda de inteira responsabilidade da loja virtual. Deve-se ter principal ateno na comparao de informaes que so digitadas e, conseqentemente, passveis de erros. A loja virtual que utiliza a Internet como canal de vendas, submete-se s regras de Marketing Direto e, ficar sujeita s clusulas contratuais previstas para este tipo de comercializao.
36
Anexo 1 Guia de Edio
Este guia s est disponvel para a bandeira Diners. Caso o estabelecimento popule estes parmetros em transaes da bandeira 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
37
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 hexadecimal (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 hexadecimal (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 subttulo superior: Voc est em um ambiente de compra seguro... no formato RGB hexadecimal (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 hexadecimal (RRGGBB).
38
Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro. 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 hexadecimal (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 hexadecimal (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 hexadecimal (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 hexadecimal (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 hexadecimal (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 3.0)
39
CORPOPUP2
O parmetro CORPOPUP2 dever conter a cor de fonte do ttulo do pop-up Por que Seguro? no formato RGB hexadecimal (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 hexadecimal (RRGGBB).
Caso o estabelecimento deixe de enviar este parmetro, o envie em branco ou incorretamente, o sistema carregar a cor de fonte padro.
40
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. Contudo, recomendado que essa prtica seja adotada para que o portador visualize as informaes da loja virtual no ambiente do Komerci.
CORPOPUP2
CORPOPUP1
CORPOPUP3
CORBTN1
CORBTN2
41
Anexo 2 - Confirmao / Desfazimento / Estorno de Confirmao de PrAutorizao / Relatrio de Transaes do Komerci

As operaes de confirmao, desfazimento e estorno de confirmao de pr-autorizao esto disponveis no site da Redecard cuja URL : www.redecard.com.br. Ou atravs do WebService (Vide Manual de WebServices). Ao acess-lo, o usurio dever acionar o menu de Pr-Autorizao e, em seguida, selecionar a opo desejada.
Confirmao de Pr-Autorizao A ilustrao abaixo demonstra a tela Confirmao de Pr-Autorizao. Atravs desta tela possvel confirmar uma transao 73 referente Pr-Autorizao. possvel, neste processo, informar se o valor ser parcelado atravs da opo forma de pagamento. Aps este procedimento, a transao de pr-autorizao e sua forma de pagamento so confirmadas para faturamento. Os seguintes dados devero ser digitados para que a operao seja efetuada: N do comprovante de vendas, N de autorizao, Data em que a transao foi solicitada, Valor da venda (em Reais), Forma de Pagamento e Parcelas (se a forma de pagamento escolhida for Parcelado Estabelecimento).
42
43
Estornar a Pr Autorizao A ilustrao abaixo demonstra a tela de Desfazimento de Pr-Autorizao. Atravs desta tela possvel estornar uma pr-autorizao (Transao 73). Desta forma, essa transao de pr-autorizao estornada e no ser faturada. Os seguintes dados devero ser digitados para que a transao seja efetuada: N do comprovante de vendas, N de autorizao, Data em que a transao foi solicitada e Valor da venda (em Reais).
44
Estorno de Confirmao de Pr-Autorizao A ilustrao abaixo demonstra a tela de Estorno de Confirmao de Pr-Autorizao. Aps a confirmao de pr-autorizao possvel ainda estorn-la atravs desta tela. A transao de pr-autorizao cancelada e no ser faturada. Os seguintes dados devero ser digitados para que a transao seja efetuada: N do comprovante de vendas, N de autorizao, Data em que a transao foi solicitada e Valor da venda (em Reais).
45
Relatrio de Transaes do Komerci
A ilustrao abaixo demonstra a tela de Relatrio de Transaes do Komerci. Este relatrio permite a consulta das transaes efetuadas e seus respectivos status. importante a visualizao desse relatrio para a conferncia da realizao das transaes realizadas. O perodo mximo para pesquisa de quinze dias, da data da solicitao do relatrio. No possvel emitir este relatrio quando a diferena entre a data final e a data inicial superar o limite mximo estabelecido de 15 dias.
46
Anexo 3 Motivos das Mensagens de Erro

Cdigo 0 - Transao Aprovada
Quando for retornado o respectivo cdigo, as informaes de nmero de autorizao, nmero do comprovante e nmero de sequncia (Utilizadas como parmetros para confirmao monetria da transao Etapa 2) sero enviadas ao estabelecimento.
Cdigos (50, 52, 54, 55, 57, 59, 61, 62, 64, 66, 67, 68, 70, 71, 73, 75, 78, 79, 80, 82, 83, 84, 85, 87, 89, 90, 91, 93, 94, 95, 97, 99) Transao no autorizada
A transao no foi autorizada e no poder ser seguida pela etapa de Confirmao.
Cdigos (76, 86) Refaa a Transao

Ocorreram problemas na respectiva autorizao e esta dever ser enviada novamente.
Cdigos (58, 63, 65, 69, 72, 77, 96) Problemas com o carto.
Ocorre quando os dados do carto esto incorretos. Para que as informaes do carto sejam validadas, devem-se respeitar as seguintes condies: O carto de bandeira Mastercard ou Visa devem ser numricos com 16 posies. O carto de bandeira Diners deve possuir de 14 a 16 posies. O sistema valida a quantidade de caracteres que o cliente digita, e no aceitar menos de 14 algarismos e nem mais de 16. No h preenchimento automtico com zeros esquerda, que deve ser programado. O dgito do carto deve estar correto. A data de validade do carto deve estar correta conforme o nmero do carto informado. O cdigo de segurana deve estar correto conforme o nmero do carto informado. Este erro ocorre quando algum dado do carto esta incorreto. A resposta do emissor do carto. Solicitar que o cliente verifique se digitou corretamente os dados do carto. Caso o erro persista, solicitar que o portador entre em contato com a central de atendimento do seu carto.
Cdigos (56, 60) Dados Invlidos

Ocorre nos seguintes casos: Os campos de: TOTAL, TRANSACAO, PARCELAS, FILIACAO, NUMPEDIDO, BANDEIRA esto vazios ou nulos na primeira etapa de autorizao. O campo de TOTAL no est no formato correto (Sem ponto de milhar e sem separador decimal igual a .). Obrigatoriamente deve possuir separador decimal e duas casas decimais.
47
O campo DISTRIBUIDOR, caso preenchido, no corresponde a um campo numrico ou contm espaos. O campo FILIACAO no numrico ou contem espaos ou no corresponde a uma Filiao cadastrada previamente na Redecard O campo PARCELAS: No corresponde a um campo numrico ou contm espaos o o Possui valor acima de 0 quando o tipo de transao vista. No possui valor acima de 1 quando a transao for parcelado emissor, parcelado estabelecimento ou parcelado IATA, respectivamente cdigo 06, 08, 40.
O tipo de transao incorreto. Vide os tipos de transao vlidos na pgina 8 A bandeira Visa no possui servio AVS (o parmetro AVS deve ser vazio ou igual a N). O campo TAXAEMBARQUE, caso informado, no corresponde a um campo numrico com separador decimal (.), sem ponto de milhar. Ou contm espaos. O campo ENTRADA, caso informado, no corresponde a um campo numrico com separador decimal (.), sem ponto de milhar. Ou contm espaos.
48
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 Integrado. 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 FILIACAO do estabelecimento / loja-virtual. O nmero de filiao importante para que o suporte identifique o estabelecimento, e para que possa prestar informaes especficas. Caso seja desenvolvedor verifique com a loja virtual e pea essa informao, pois somente assim a Central de Atendimento dar andamento ocorrncia. 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, a loja virtual deve 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 ou pelo site: http://www.komerciredecard.com.br/.
Contato: Suporte Tcnico Telefones de Atendimento: Capitais e Regies Metropolitanas: 4001-4433 Outras localidades: 0800-784433
Horrio de Atendimento:
Das 08h s 20h40, segunda sexta (exceto feriados) Email: loja.virtual@redecard.com.br
Acesse sempre www.redecard.com.br e confira alguns dos nossos servios: Extrato On-Line, Servios 48h (Pesquisas de Dbito e Crdito) e Cancelamento de vendas.
49

Manual KomerciIntegrado

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual KomerciIntegrado

Enviado por

Direitos autorais:

Formatos disponíveis

Manual do Desenvolvedor Komerci Integrado

Histrico de Atualizao do Manual

2.8 2.8.1 2.9 3.0

07/07/09 09/06/10 01/07/10 20/09/10

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Credenciamento da tecnologia Komerci, Produtos e Servios

Manual do Desenvolvedor (Verso 3.0)

Certificado digital obrigatrio

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Descrio das Etapas:

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

PAX2, PAX3 e PAX 4

Manual do Desenvolvedor (Verso 3.0)

NUMDOC1, NUMDOC2, NUMDOC3 e NUMDOC4

Manual do Desenvolvedor (Verso 3.0)

Seguem abaixo algumas restries de utilizao deste parmetro:

Manual do Desenvolvedor (Verso 3.0)

AVS (Parmetro Opcional)

IATA (Parmetro Opcional)

TAXAEMBARQUE (Parmetro Opcional)

LANGUAGE (Parmetro Opcional)

Manual do Desenvolvedor (Verso 3.0)

Instrues para Instalao do Cdigo de Verificao

Sem nenhum parmetro, ser exibido um pequeno help.

Manual do Desenvolvedor (Verso 3.0)

Sugesto para as lojas virtuais que operam com ASP

Manual do Desenvolvedor (Verso 3.0)

Modelo de Cdigo Fonte

Manual do Desenvolvedor (Verso 3.0)

MASTERCARD Sem AVS

Manual do Desenvolvedor (Verso 3.0)

MASTERCARD Com AVS

Manual do Desenvolvedor (Verso 3.0)

DINERS Sem AVS

DINERS Com AVS

Manual do Desenvolvedor (Verso 3.0)

VISA SEM AVS

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Servio de Verificao de dados Cadastrais AVS

Manual do Desenvolvedor (Verso 3.0)

CDIGO DESCRIO (MSGAVS) (RESPAVS)

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Tabela de Cdigos e Mensagens de Retorno:

Mensagem Transao Aprovada

Problemas com o carto

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

PAX2, PAX3 e PAX 4

NUMDOC1, NUMDOC2, NUMDOC3 e NUMDOC4

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

Cdigos e Mensagens de retorno:

Manual do Desenvolvedor (Verso 3.0)

Manual do Desenvolvedor (Verso 3.0)

IMPORTANTE: LEIA COM ATENO OS ITENS ABAIXO.

Manual do Desenvolvedor (Verso 3.0)

Forma de Captura Ingls