Manual Komerci Integrado

Manual do Desenvolvedor Komerci Integrado

Apresentao
Parabns! Ao adquirir o Komerci, voc optou por ter em seu negcio muito mais facilidades
e tecnologia em suas vendas.
E para que voc aproveite ao mximo todas as vantagens que o servio oferece,
desenvolvemos este manual que ir auxiliar voc no desenvolvimento e congurao do seu acesso,
bem como na utilizao de todos os recursos e facilidades proporcionadas por essa tecnologia.
Importante:
O estabelecimento dever desenvolver uma rotina prpria para a utilizao do Komerci
em sua loja-virtual, porm sempre seguindo os padres denidos neste manual.
Mesmo que voc conhea as verses anteriores do Komerci, a leitura deste manual
obrigatria.
ndice
1
Para implantao da soluo do Komerci Integrado e WebService em sua empresa,
voc precisa efetuar o credenciamento prvio junto a Redecard.
Servios de AVS, Mastercard SecureCode e Veried By Visa devem ser contratados previamente
para sua habilitao.
Para isso, basta entrar em contato com a Central de Atendimento nos seguintes telefones:
4004 3298
(capitais e regies metropolitanas)
0800 726 3298
(demais localidades)
Disponvel 24h por dia, 7 dias por semana com especialistas bilngues treinados para atender
de maneira rpida e eciente as solicitaes internacionais.
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
Conguraes
Certicado digital obrigatrio:
Certicado de Segurana SSL 2048 bits (criptograa)
So de inteira responsabilidade do estabelecimento a seleo e negociao com a empresa
certicadora. A Redecard no possui nenhuma relao de empresas homologadas para a emisso
do certicado digital.
Credenciamento
ndice
2
Suporte tcnico
Se voc tiver qualquer problema nos procedimentos descritos a seguir,
basta entrar em contato com o suporte tcnico. Trata-se de uma equipe que est
sua disposio para sanar dvidas e ajudar voc em qualquer diculdade.
Antes de entrar em contato:
Tenha em mos seu nmero de liao (estabelecimento). Caso seja desenvolvedor

informe o n do CNPJ da empresa;
Certique-se de ter lido completamente o(s) manual e que o desenvolvimento est de acordo;
O suporte tcnico Komerci no est autorizado a fornecer ou receber nmeros de cartes de crdito,
vlidos ou no, ainda que para testes;
O suporte tcnico Komerci no est autorizado a fornecer, receber, ou prestar suporte para cdigos
fonte do estabelecimento ou linguagens de programao;
O suporte tcnico Komerci no est habilitado a fornecer informaes comerciais.

Dvidas, referentes ao desenvolvimento do Komerci devero ser esclarecidas com o nosso
Suporte Tcnico Komerci.
Telefones de Atendimento:
4004 3298
(capitais e regies metropolitanas)
0800 726 3298
(demais localidades)
Disponvel 24h por dia, 7 dias por semana com especialistas bilngues treinados para atender
de maneira rpida e eciente as solicitaes internacionais.
Email: loja.virtual@redecard.com.br
Lembre-se:
No Portal Redecard voc pode acessar muitos servios, tais como Extrato On-Line, Servios 48h
(Pesquisas de Dbito e Crdito) e Cancelamento de vendas.
Acesse www.redecard.com.br
ndice
Banco
Estabelecimento
Tudo
isso em at
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
3
ndice
Clique nos hiperlinks para navegar no material do Manual do Desenvolvedor Komerci Integrado.
Fluxo de Transao Komerci
Autorizao
Como feita junto ao emissor do carto com liquidao imediata.
Conrmao
Como feita junto ao emissor do carto com at 30 dias depois da autorizao.
Cupom
Como funciona o envio de cupom para suas vendas on-line.
Servio AVS
Servio de Vericao de Dados Cadastrais (AVS) dos portadores de cartes MasterCard.
Comprovante de Vendas
Como enviado e como funciona o comprovante da transao.
Gerenciamento de Vendas
Para extrair informaes de todas as transaes de vendas realizadas em um
determinado perodo.
Anexo A Banners
Anexo B Cdigo de Vericao
Anexo C Modelo de Cdigo Fonte
Anexo D Telas de Captura
Anexo E Cdigos de Retorno/Erro para Autorizao
Anexo F Dicas de Segurana
Anexo G Operaes de Teste
Anexo H Conrmao de Pr-Autorizao / Desfazimento / Estorno de Conrmao
de Pr-Autorizao / Relatrio de Transaes do Komerci
Anexo I Motivos das Mensagens de Erro
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
6
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
5
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
13
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
19
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
21
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
25
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
26
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
27
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
28
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
30
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
31
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
33
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
34
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
35
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
36
Banco
Estabelecimento
Tudo
isso emat
12
segundos!
Dial-Up
Conexo
com fio
P
C
X 1
m
Contactless
GPRS
Touch
Screen
mkt
40
4
Fluxo de Transao Komerci
Disponvel 24h por dia, 7 dias por semana com especialistas bilngues treinados
para atender de maneira rpida e eciente as solicitaes internacionais.
LOJA VIRTUAL LOJA VIRTUAL
Obrigado
por efetuar sua
compra!
1
$
Checkout Comprar
OOOO
CARRINHO
DE COMPRAS
PRODUTO
FORMA DE
PAGAMENTO
COMPROVANTE
DE VENDA
5
ndice
Autorizao
LOJA VIRTUAL REDECARD
A loja virtual dever enviar os seguintes parmetros
para a Redecard a partir da chamada para a tela de captura do Komerci:
Nome Tamanho Descrio
TOTAL 15 Valor total da compra
TRANSACAO 3 Cdigo do tipo de transao
PARCELAS 2 Nmero de parcelas
FILIACAO 25 Nmero de liao do estabelecimento (fornecedor)

DISTRIBUIDOR 9 Nmero de liao do estabelecimento (distribuidor)
BANDEIRA 10 Bandeira do carto
NUMPEDIDO 16 Nmero do pedido
CODVER 32 Cdigo de Vericao
URLBACK 250 Endereo para retorno dos dados da transao

URLCIMA 250 Endereo de URL da pgina ou imagem superior
TARGET 40 Nome do frame para onde ser retornado a URLBACK
INIFRAME 1 Indica se a tela do Komerci ser apresentada em IFRAME
AVS 1 Servio de AVS
LANGUAGE 3 Idioma para apresentao dos textos
Todos os parmetros citados nesta etapa do uxo 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 conguraes / 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.
6
ndice
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 TRANSAO for 04 ou 39, ser vista.
FILIACAO
O parmetro FILIAO dever conter o n de liao do estabelecimento cadastrado com a Redecard.
TOTAL
O parmetro TOTAL dever conter o valor total da transao.
O parmetro TOTAL deve ser enviado em todas as etapas e sempre da mesma forma.
Este valor dever ser separado por . (ponto). Exemplo: 34.60
No deve conter separador de milhar
obrigatria a existncia de duas casas decimais.
TRANSACAO
O parmetro TRANSAO dever conter o cdigo do tipo de transao a ser processada,
de acordo com a tabela a seguir:
No caso de Pr-Autorizao, o parmetro TRANSAO dever conter o cdigo 73. Este cdigo
nico para transaes vista ou parceladas. A escolha da forma de pagamento ( vista ou parcelada)
feita no momento da conrmao da transao (vide pgina https://ecommerce.redecard.com.br/
pos_virtual/conrma.asp:).
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 solicitao do pedido de autorizao, somente na etapa de
conrmao da Pr-Autorizao dever ser informado se a transao ser vista ou parcelada.
Se a opo for parcelada deve ser informado o n de parcelas.
Tipo de Transao Cdigo
vista 04
Parcelado Emissor 06
Parcelado Estabelecimento 08

Pr-Autorizao 73
IATA vista 39
IATA Parcelado 40
Autorizao
ndice
7
DISTRIBUIDOR
O parmetro DISTRIBUIDOR dever conter o n de liao do estabelecimento
distribuidor. Este parmetro s dever ser preenchido se o estabelecimento do campo
FILIAO 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:
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.
CODVER
O parmetro CODVER dever conter o cdigo de vericao gerado pelo aplicativo
CodVer.class. A instruo para instalao do cdigo est descrita no Anexo B Instrues
para Instalao do Cdigo de Vericao.
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. Maiores informaes de configurao
do parmetro URLCIMA disponveis no Anexo A Banners.
Bandeira Valor que deve ser informado
Mastercard
MASTERCARD
Diners
DINERS

Visa
VISA

Autorizao
8
ndice
URLBACK
O parmetro URLBACK dever conter o endereo e pgina para onde os dados
da transao devero ser retornados.
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.
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.
Recomenda-se a abertura da tela de captura do Komerci na prpria pgina
da loja-virtual 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.
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.
Autorizao
9
ndice
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 no link SERVIO AVS.
LANGUAGE (parmetro Opcional)
O parmetro LANGUAGE dever conter o valor referente ao idioma no qual se quer exibir os textos
da tela do Komerci.
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):
REDECARD LOJA VIRTUAL
1
Idioma Cdigo
Ingls
ENG
Portugus
POR
DATA 8 Data da transao
NUMPEDIDO 16 Nmero do Pedido
NR_CARTAO 19 Nmero do Carto mascarado
ORIGEM_BIN 3 Cdigo de Nacionalidade do Emissor

NUMAUTOR
6 Nmero de Autorizao
NUMCV
12 Nmero do Comprovante de Venda (NSU)

NUMAUTENT
6 Nmero de Autenticao

NUMSQN 12 Nmero seqencial nico

PAX1

26

Companhia Area Nome do Passageiro Principal

Demais Ramos Texto livre para digitao.
DATA_EXPI

8
Data de Expirao da Transao
1 de inteira responsabilidade da loja-virtual fazer o tratamento de quaisquer informaes retornadas pela Redecard.
Autorizao
10
ndice
DATA
O parmetro DATA retornar a data em que a transao foi efetuada
(no formato aaaammdd).
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.
NUMPEDIDO
O parmetro NUMPEDIDO retornar o n do pedido que foi informado pela loja-virtual
na primeira etapa do uxo.
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).
Autorizao
11
ndice
NUMSQN
O parmetro NUMSQN retornar o nmero sequencial nico da transao.
PAX1
O parmetro PAX1 retornar o mesmo valor do PAX1 que foi informado pela loja-virtual
na primeira etapa do uxo.
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 conrmao
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 conrmao.
Autorizao
12
ndice
Conrmao
Caso a transao tenha sido aprovada pelo emissor, a loja-virtual dever conrm-la,
retornando os parmetros abaixo para o endereo:
https://ecommerce.redecard.com.br/pos_virtual/conrma.asp:
A etapa de conrmao deve ocorrer somente quando a etapa anterior (Autorizao) no apresentou
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.
TRANSACAO 3 Cdigo da transao de conrmao
TRANSORIG 3 Cdigo do tipo da transao original
PARCELAS 2 Nmero de parcelas da transao
FILIACAO 25 Filiao do estabelecimento (fornecedor)

DISTRIBUIDOR 9 Filiao do estabelecimento (distribuidor)

TOTAL 15 Valor da transao

NUMPEDIDO 16 Nmero do pedido

NUMAUTOR 6 Nmero da autorizao
NUMCV 12 Nmero do Comprovante de Vendas

NUMSQN 12 Nmero seqencial nico

NUMDOC1 16 N do Bilhete

PAX1 26 Nome do Passageiro





IATA 8 Nmero do cdigo IATA
TAXAEMBARQUE 12 Taxa de embarque da transao
ndice
13
DATA
O parmetro DATA dever conter a data em que a transao foi efetuada
(no formato aaaammdd).
TRANSACAO
O parmetro TRANSAO dever conter o cdigo de conrmao da transao: 203.
TRANSORIG
O parmetro TRANSORIG dever conter o cdigo do tipo de transao que foi informado pela
loja-virtual no campo TRANSAO na primeira etapa do uxo.
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 uxo.
FILIACAO
O parmetro FILIAO dever conter o n de liao do estabelecimento (cadastrado junto
a Redecard), que foi informado pela loja-virtual no campo FILIAO na primeira etapa do uxo.
DISTRIBUIDOR
O parmetro DISTRIBUIDOR dever conter o n de liao do estabelecimento distribuidor que
foi informado pela loja-virtual no campo DISTRIBUIDOR na primeira etapa do uxo. Este parmetro
s dever ser preenchido se o estabelecimento do campo FILIAO for um fornecedor.
Em caso negativo, enviar este parmetro, porm vazio.
Cartes emitidos no exterior no podem conter transaes parceladas,
essa uma determinao dos emissores internacionais.
Conrmao
14
ndice
TOTAL
O parmetro TOTAL dever conter o valor da transao que foi informado pela loja
virtual no campo TOTAL na primeira etapa do uxo. 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 uxo.
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 uxo. 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 constem 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 conrmada. Por exemplo:
Se for informado T12345 a loja-virtual dever enviar T12345, e no t12345.
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 uxo.
NUMSQN
O parmetro NUMSQN dever conter o n sequencial nico da transao que foi informado pela
Redecard no campo NUMSQN na segunda etapa do uxo.
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.
Conrmao
15
ndice
PAX2, PAX3 E PAX4
Estes parmetros so enviados somente quando a transao a ser conrmada
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, 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.
IATA
Este parmetro enviado somente quando a transao a ser conrmada 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 conrmada 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 uxo.
A nica exceo para o NUMDOC1, que um parmetro obrigatrio
no caso do segmento de Companhia Area.
ATENO
Caso a loja-virtual decida no conrmar a transao, por motivo qualquer, basta que
o estabelecimento no execute esta etapa de conrmao do uxo da transao.
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 conrmao. Caso a transao no seja conrmada neste
perodo, ela ser automaticamente desfeita.
Os dados da conrmao devem ser enviados atravs do mtodo GET, em conexo HTTPS.
Conrmao
16
ndice
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):
REDECARD LOJA VIRTUAL
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 conrmao da transao for bem sucedida, este parmetro retornar o Comprovante
de Vendas para o portador do carto.
CDIGOS E MENSAGENS DE RETORNO:
0 = CONFIRMAO COM SUCESSO A conrmao foi realizada com sucesso e efetivada;
1 = JA CONFIRMADA A transao j foi conrmada anteriormente;
2 = TRANSAO NEGADA A transao de conrmao foi negada pelo autorizador;
3 = TRANSAO DESFEITA A transao foi desfeita, pois o tempo disponvel de dois minutos
para conrmao foi ultrapassado;
CODRET 4 Cdigo de retorno

MSGRET 1024 Mensagem de retorno
Estes parmetros so retornados aps a chamada para conrmao
da transao. No retornado qualquer comando ou cdigo HTML.
retornado somente uma nica linha de texto. Como por exemplo:
CODRET=0&MSGRET=CONFIRMAO+COM+SUCESSO. Desta forma,
o tratamento do retorno ser realizado atravs de outro componente,
como um servio, servlet ou outra rotina programada.
Conrmao
17
ndice
4 = TRANSAO ESTORNADA A transao foi estornada anteriormente
pelo processo de estorno de transao;
8 = DADOS NAO COINCIDEM Dados de Total, Nmero de Comprovante
ou Nmero de Autorizao no conferem com o Nmero de Comprovante
e Autorizao passados como parmetro;
9 = TRANSAO NO ENCONTRADA No foi encontrada nenhuma transao para
os respectivos campos passados como parmetro: NUMCV, NUMAUTOR e DATA;
88 = DADOS AUSENTES. TRANSAO NAO PODE SER CONCLUDA Algum dado obrigatrio
no foi informado como parmetro (DATA, TRANSACAO, TRANSORIG, PARCELAS, TOTAL,
NUMPEDIDO, NUMAUTOR, NUMCV, NUMSQN e FILIACAO)
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 conrmao novamente (repetir a terceira etapa do uxo).
Recomenda-se que, ao nal 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.
Conrmao
18
ndice
Cupom
Devidamente conrmada a transao, a loja-virtual dever exibir o comprovante de venda,
enviando os seguintes parmetros (GET ou POST)
preenchidos na URL: https://ecommerce.redecard.com.br/pos_virtual/cupom.asp
TRANSACAO 3 Cdigo 201
NUMAUTOR 6 Nmero da autorizao
NUMCV 12 Nmero do Comprovante de Vendas
LANGUAGE 1 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 uxo
TRANSACAO
O parmetro TRANSAO 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 uxo. 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, neste caso,
se for informada uma autorizao T12345 a loja-virtual dever enviar T12345 e no t12345.
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 uxo.
ndice
19
IMPORTANTE: LEIA COM ATENO OS TENS ABAIXO.
Apesar de tratar-se de uma etapa independente do uxo, 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 trata-se 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 apresentado na ETAPA de CONFIRMAO
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 conrmada
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 uxo de transao. Onde:
Cdigo Forma de captura
E
Ingls
No caso de idioma Portugus este parmetro deve ser enviado em branco.
Cupom
20
ndice
O Servio de Vericao de Dados Cadastrais (AVS) um servio de vericao on-line
de dados cadastrais dos portadores de cartes MasterCard 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.
Em caso de servio AVS, os seguintes dados complementares sero retornados quando a transao
for aprovada e bem sucedida:
Servio de Vericao
de Dados Cadastrais
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 est 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 / Veried by Visa).
ENDERECO 45 Endereo de recebimento de fatura do carto (rua/avenida)
NUMERO 5 Nmero do endereo de recebimento de fatura do carto
COMPLEMENTO 18 Complemento do endereo de recebimento de fatura do 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 200 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).
ndice
21
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).
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).
RESPAVS
O parmetro RESPAVS retornar o cdigo referente consulta dos dados cadastrais digitados
pelo portador do carto.
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).
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:
Cdigos (RESPAVS) Descrio (MSGAVS)
W Sim, todos os dgitos coincidem.
X O CEP e CPF coincidem, endereo no coincide.
Z Endereo e CPF coincidem, CEP no coincide.
Y O CEP coincide, CPF e endereo no coincidem.
A CPF coincide, CEP e endereo no coincidem.

U O CEP e CPF no coincidem, endereo coincide.

S O CEP e endereo coincidem, CPF no coincide.

N Nada coincide.
Servio de Vericao
de Dados Cadastrais
22
ndice
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.
TRANSAO NO APROVADA
Cdigos (RESPAVS) Descrio (MSGAVS) Cdigo Relatrio Transao*
53 Transao Invlida (AVS no contratado) R
74 Instituio sem comunicao R
81 Banco no pertence rede ou Carto Corporativo R
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.
Orientao ao desenvolvedor: No sistema AVS, cada cdigo de retorno possui
um signicado diferente (conforme tabela de descrio da resposta AVS). A deciso
de conrmar ou negar uma transao dependendo do cdigo de retorno AVS, uma
deciso da loja virtual. No caso de conrmao, a loja-virtual dever enviar para
a Redecard os parmetros da terceira etapa do uxo, conforme especicado neste
manual. Para recusar a transao, basta terminar o uxo nesta etapa, ou seja,
no enviar a terceira etapa do uxo da transao.
NUMPEDIDO 16 Nmero do Pedido
CODRET 4 Cdigo de erro
MSGRET 1024 Mensagem de erro
NUMPEDIDO
O parmetro NUMPEDIDO retornar o n do pedido que foi informado pela loja-virtual na primeira
etapa do uxo.
Dependendo do cdigo do erro, este parmetro pode no retornar.
ndice
Servio de Vericao
de Dados Cadastrais
23
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 uxo termina nesta etapa.
Servio de Vericao
de Dados Cadastrais
24
ndice
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 uxo:
MASTERCARD VISA DINERS

Ateno!

ATENO
Para exibir o comprovante de vendas neste mesmo formato (ilustrado acima),
congure o pop-up para 280 X 440 pixels.
ndice
25
MASTERCARD DINERS VISA
Gerenciamento de vendas
O Komerci possui uma srie de funcionalidades para gerenciamento das transaes
processadas das Bandeiras, MASTERCARD, DINERS e VISA, 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 ocial de Braslia).
Resumo de Vendas:
O Resumo de Vendas um documento que exibe a somatria diria de todas as transaes
conrmadas. Ele ca 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
e Webservice em Portugus e Ingls e o Codver para download.
Estas funcionalidades esto disponveis no Portal Redecard. Para utilizar o Portal Redecard,
basta que o estabelecimento efetue o cadastro no endereo: www.redecard.com.br com sua liao
da tecnologia Komerci.
ndice
26
Anexo A - Banners
As ilustraes abaixo indicam aonde ser visualizada a URL congurada
no parmetro URLCIMA:
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.
O tamanho da rea que o parmetro URLCIMA abrange xa em 120 X 780 pixels.
Este parmetro est disponvel tanto para a bandeira MasterCard quanto para as bandeiras
Diners e Visa.
ndice
27
Anexo B - Instrues para
instalao do Cdigo de Vericao
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 Vericao,
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 <numl> <total> <ip address>
Onde:
<numl>: Nmero de liao 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 Vericao.
Caso seja digitado apenas:
# java CodVer
Sem nenhum parmetro, ser exibido um pequeno help.
ndice
28
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 Vericao,
seguindo, entretanto, as instrues aqui dispostas.
A Redecard disponibiliza para download o arquivo Cdigo de Vericao, a m 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 vericao;
Arquivos de suporte ao funcionamento do componente;
Cdigos fonte do componente;
Instrues detalhadas;
O arquivo Cdigo de Vericao est disponvel para download no Portal
Redecard (www.redecard.com.br), nos links VANTAGENS PARA CLIENTES >
Downloads > Em assunto, selecionar Komerci e baixar o codver.
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.
SUGESTO PARA AS LOJAS VIRTUAIS
QUE OPERAM COM ASP
ndice
Anexo B
29
Este um modelo de cdigo-fonte que a loja virtual poder utilizar para fazer a chamada
para a tela de captura do Komerci:
Anexo C - Modelo de Cdigo Fonte
<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>

</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>
ndice
30
Anexo D - Telas de Captura
MASTERCARD (Sem AVS)
MASTERCARD (Com AVS)
As interfaces de pagamento sero exibidas de acordo com a solicitao que a loja-virtual
zer no parmetro BANDEIRA. Caso tenha sido atribudo o parmetro AVS (Este parmetro
disponvel apenas para bandeiras MASTERCARD), a tela apresentar dados referentes
a essa modalidade. Conforme diagrama abaixo:
ndice
31
DINERS (Sem AVS)
ndice
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.
Anexo D
32
Cdigo Mensagem
Transao no autorizada
Transao Aprovada
Instituio sem comunicao
Banco no pertence rede
Estabelecimento Invlido
Por favor, entre em contato com o estabelecimento

que est efetuando a venda.
Problemas com o carto
Por favor, verique os dados de seu carto. Caso o erro persista,
entre em contato com a central de atendimento de seu carto.
Dado Invlido
Refaa a transao
Sua transao no pode ser concluda.
Por favor, refaa a transao, dados obrigatrios ausentes.
Transao Invlida

Anexo E - Tabela de Cdigos
e Mensagens de Retorno
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
51, 92, 98
58, 63, 65, 69, 72, 77, 96
56, 60
76, 86
53
0
74
81
Para maiores detalhes das possveis causas dos erros acima descritos,
vericar Anexo I Motivos das Mensagens de Erro.
ndice
33
Anexo F - 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.
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 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>
<Script language=JavaScript>

</Script>
ndice
34
Anexo G - 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.
Outra forma de teste efetuar uma transao tambm em ambiente produtivo e com carto vlido,
porm no valor de R$ 0,01. A transao vai at o emissor, recebe a autorizao, mas no gera crdito
ao estabelecimento ou cobrana para o Portador.
IMPORTANTE
Os procedimentos que conrmam a realizao da compra pelo cliente, como
o envio de e-mail, a conrmao 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 vericar 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 Conrmada (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 nal de efetivao da venda de inteira responsabilidade da loja virtual. Deve-se
ter principal ateno na comparao de informaes que so digitadas e, consequentemente,
passveis de erros. A loja virtual que utiliza a Internet como canal de vendas, submete-se
s regras de Marketing Direto e, car sujeita s clusulas contratuais previstas para este tipo
de comercializao.
ndice
35
Anexo H - Conrmao/
Desfazimento/Estorno
de Conrmao de Pr-Autorizao/
Relatrio de Transaes do Komerci
As operaes de conrmao, desfazimento e estorno de conrmao 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 Conrmao de Pr-Autorizao.
Atravs desta tela possvel conrmar 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 conrmadas
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).
ndice
36
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 devem ser inseridos para que a transao seja efetuada:
N de autorizao,
Data em que a transao foi solicitada e
Valor da venda (em Reais).
ndice
Anexo H
37
ESTORNO DE COFIRMAO DE PR-AUTORIZAO
A ilustrao abaixo demonstra a tela de Estorno de Conrmao de Pr-Autorizao.
Aps a conrmao de pr-autorizao possvel ainda estorn-la atravs desta tela.
A transao de pr-autorizao cancelada e no ser faturada.
Os seguintes dados devem ser digitados para que a transao seja efetuada:
N de autorizao,
Data em que a transao foi solicitada
Valor da venda (em Reais).
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 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 nal e a data inicial superar
o limite mximo estabelecido de 15 dias.
Anexo H
38
ndice
ndice
39
Anexo H
ndice
Anexo I - 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 conrmao 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 Conrmao.
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 a informada no carto.
O cdigo de segurana deve estar correto conforme o nmero do carto informado.
Este erro ocorre quando algum dado do carto est incorreto. A resposta do emissor do carto.
Solicitar que o cliente verique 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:
Ocorrem nos seguintes casos:
Os campos: TOTAL, TRANSACAO, PARCELAS, FILIACAO, NUMPEDIDO, BANDEIRA esto vazios ou nulos
na primeira etapa de autorizao.
O campo 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.
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.
40
O campo PARCELAS: No corresponde a um campo numrico
ou contm espaos
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 7.
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.
Anexo I
41
ndice

Manual Komerci Integrado

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 Komerci Integrado

Enviado por

Direitos autorais:

Formatos disponíveis

Manual do Desenvolvedor Komerci Integrado

Manual do Desenvolvedor Komerci Integrado

Tenha em mos seu nmero de liao (estabelecimento). Caso seja desenvolvedor

O suporte tcnico Komerci no est habilitado a fornecer informaes comerciais.

Você também pode gostar