Você está na página 1de 64

Manual de Captura e Gerenciamento WebService Komerci

Apresentao

Manual do Desenvolvedor Komerci Integrado


A Redecard faz questo de oferecer muito mais do que produtos e servios que facilitem sua vida. Queremos levar todas as informaes que voc precisa, alm de dar o suporte necessrio para seu negcio. Por isso desenvolvemos este manual do WebService. WebService uma soluo tecnolgica capaz de integrar aplicaes e componentes de negcios entre diferentes entidades, utilizando como meio a Internet. As principais vantagens de utilizar webservices so: interoperabilidade entre aplicaes distintas e fisicamente distantes, portabilidade entre diferentes plataformas, facilidade de integrao, reduo de custos para transporte de dados e formato universal. Para a captura Komerci, o webservice foi desenvolvido em plataforma Microsoft .NET, oferecendo aos desenvolvedores a possibilidade de integrao em trs meios diferentes: .NET/.NET, SOAP/XML, HTTP/ POST. Desta forma, o estabelecimento que quiser utilizar o webservice, no necessita instalar novos sistemas, podendo operar em sua plataforma atual, sem mudanas ou adaptaes. A seguir, voc vai saber tudo sobre os mdulos de Captura e Gerenciamento de vendas.

ndice

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:
Estabelecimento

Tudo isso em at segundos!

12

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 eficiente as solicitaes internacionais.

m Manual do Desenvolvedor Informaes Importantes KomerciPIntegrado


Dial-Up Conexo com fio Contactless GPRS Touch Screen

mkt

Endereo Webservice: Endereo WSDL:

X C

https://ecommerce.redecard.com.br/pos_virtual/wskomerci/cap.asmx https://ecommerce.redecard.com.br/pos_virtual/wskomerci/cap.asmx?WSDL

Toda forma de comunicao e transferncia de dados ocorrer obrigatoriamente em server-side, ou seja, realizada entre o servidor do estabelecimento e o servidor da Redecard. Para transacionar no webservice necessrio ter o IP do servidor habilitado na Redecard. (Anexo F) Toda chamada ao webservice dever ser realizada atravs de comunicao segura (SSL / HTTPS) e em mtodo POST. O sistema no difere letras maisculas ou minsculas na informao dos parmetros dos mtodos WebService. Caso haja algum detalhe adicional quanto informao de um determinado parmetro, este ser encontrado em sua descrio.

ndice

Suporte tcnico Komerci


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 dificuldade. Antes de entrar em contato:

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


informe o n do CNPJ da empresa;

Certifique-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:

Manual do Desenvolvedor Komerci Integrado

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 eficiente 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

ndice
Clique nos hiperlinks para navegar no material do Manual de Captura e Gerenciamento Webservice Komerci.

5 14

Autorizao em um pass0

A transao autorizada junto ao emissor do carto com liquidao imediata.

Autorizao em dois passos (Pr-Autorizao)

Neste modelo de transao o emissor autoriza a transao sensibilizando o saldo do portador, e a mesma fica pendente aguardando a confirmao at que ela seja efetivada e assim liquidada. A confirmao pode ser feita at 30 dias depois da autorizao.

28

Servio AVS

O Servio de Verificao de Dados Cadastrais (AVS) um servio de verificao on-line de dados cadastrais dos portadores de cartes MasterCard, emitidos no Brasil que tem como objetivo 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.

Manual do Vendas 34 Relatrio de Desenvolvedor


43 46 50 51 54 59 60 61

Este servio retorna um relatrio de todas as transaes de vendas realizadas em um determinado perodo.

Komerci Integrado

Resumo de Vendas
Anexo A Anexo B Anexo C Anexo D Anexo E Anexo F Anexo G

Este servio retorna a extrao do resumo de vendas que contm um sumrio das vendas efetuadas na data corrente. Confirmao Manual Gerenciamento de Usurios WebServices Comprovante de Vendas Cdigos e Motivos de Erro de Parametrizao Cdigos de Erro para Autorizao Validao de IP Operaes de Teste

Autorizao em um passo
Autorizao em um passo Autorizao
Para esta transao deve ser utilizado o mtodo GetAuthorized descrito abaixo. Em caso de sucesso, este mtodo retorna informaes sobre a autorizao (Nmero do CV, Nmero da Autorizao entre outros). Em caso de erro ou autorizao negada, envia cdigo e mensagem com o motivo de negativa da transao. O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome TOTAL TRANSACAO PARCELAS FILIACAO NUMPEDIDO NRCARTAO CVC2 ANO IATA DISTRIBUIDOR CONCENTRADOR TAXAEMBARQUE ENTRADA NUMDOC1 a NUMDOC4 PAX1 a PAX4 CONFTXN ADD_Data Tamanho 10 2 2 9 16 16 3 Descrio Valor total da compra Tipo de Transao Nmero de parcelas Nmero de filiao do estabelecimento (fornecedor) Nmero do pedido gerado pelo estabelecimento Nmero do carto CVC2

MES 2 Ms da validade do Manual do Desenvolvedor Komercicarto Integrado 2 Ano da validade do carto Nome do Portador N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio S N/A Enviar parmetro com valor vazio PORTADOR 30 9 9 5 10 10 16 26 1 N/I

obrigatrio o envio de todos os parmetros detalhados acima. Mesmo que algum deles no seja utilizado, o estabelecimento dever envi-lo com valor vazio. Os dados do portador do carto (carto, validade, CVC2, etc) no devem ser armazenados pelo estabelecimento. Apenas devem ser trafegados no momento do pedido do cdigo de autorizao da transao.

ndice

ToTAl
O parmetro TOTAL dever conter o valor total da transao.

Autorizao em um passo

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: Tipo de Transao vista Parcelado Emissor Parcelado Estabelecimento IATA vista Cdigo 04 06 08 39

Manual do Desenvolvedor Komerci Integrado IATA Parcelado 40


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, isto , vista.

No possvel efetuar transaes parceladas para cartes emitidos fora do Brasil. Trata-se de uma regra dos emissores estrangeiros.

FiliAcAo
O parmetro FILIAO dever conter o n de filiao do estabelecimento cadastrado com a Redecard.

ndice

numPedido
O parmetro NUMPEDIDO dever conter o n do pedido referncia da loja. Este campo poder ser preenchido de acordo com a poltica interna do estabelecimento e deve ser tratado nos casos de pedidos duplicados pelo prprio sistema do estabelecimento. O sistema da Redecard no valida esse parmetro.

Autorizao em um passo

No utilizar caracteres especiais (acentuao) Campo Obrigatrio

numcArTAo
O parmetro NRCARTAO dever conter o nmero do carto de crdito do portador, podendo ser MasterCard, Diners ou Visa. No so aceitos cartes de Dbito.

cvc2
O parmetro CVC2 dever conter o cdigo de segurana do carto com trs posies numricas.

Manual do Desenvolvedor Komerci Integrado

mes
O parmetro MES dever conter o ms de validade do carto do portador com duas posies (FORMATO MM).

Ano
O parmetro ANO dever conter o ano de validade do carto do portador com duas posies (FORMATO AA).

PorTAdor
O parmetro PORTADOR dever conter o nome do portador da forma que foi informado por ele.

ndice

conFTxn
Caso este parmetro no seja preenchido com S, o sistema entende que necessrio fazer uma confirmao manual utilizando o mtodo ConfirmTxn. O estabelecimento tem at 2 minutos para executar esta confirmao manual aps a autorizao. Mais detalhes no anexo A Confirmao Manual.

Autorizao em um passo

ATENO

obrigatrio o envio de todos os parmetros detalhados acima. Mesmo que algum deles no seja utilizado, o estabelecimento dever envi-lo com valor vazio.

reTorno dA oPerAo geTAuThorized


A mensagem de retorno da operao GetAuthorized ser enviada em XML:

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8?> <AUTHORIZATION> <CODRET>9</CODRET> <MSGRET>Mensagem</MSGRET> <NUMPEDIDO>string</NUMPEDIDO> <DATA>99999999</DATA> <NUMAUTOR>999999</NUMAUTOR> <NUMCV>999999999</NUMCV> <NUMAUTENT>999999</NUMAUTENT> <NUMSQN>999999999</NUMSQN> <ORIGEM_BIN>XXX</ORIGEM_BIN> <CONFCODRET>9</CONFCODRET> <CONFMSGRET>Mensagem</CONFMSGRET> </AUTHORIZATION>

ndice

Nome CODRET MSGRET DATA NUMPEDIDO NUMAUTOR NUMCV NUMAUTENT NUMSQN ORIGEM_BIN CONFCODRET CONFMSGRET

Tamanho 2 160 8 16 6 9 27 12 3 2 160

Descrio Cdigo de retorno Descrio do cdigo de retorno Data da transao Nmero do Pedido Nmero de Autorizao Nmero do Comprovante de Venda (NSU) Nmero de Autenticao Nmero seqencial nico Cdigo do pas emissor Cdigo de retorno da confirmao automtica Descrio do cdigo de retorno

Autorizao em um passo

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. Vide tabela Cdigo de Erro para Autorizao. Este cdigo devolvido apenas para transaes no autorizadas.

msgreT

Manual do Desenvolvedor Komerci Integrado

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. Vide tabela Cdigo de Erro para Autorizao.

dATA
O parmetro DATA retornar a data em que a transao foi autorizada (no formato AAAAMMDD).

numPedido
O parmetro NUMPEDIDO retornar o n do pedido que foi informado pelo estabelecimento na chamada da operao. O sistema da Redecard no far consistncia deste parmetro.

numAuTor
O parmetro NUMAUTOR retornar o n de autorizao da transao.

ndice

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

Autorizao em um passo

10

numAuTenT
O parmetro NUMAUTENT retornar o n de autenticao da transao.

numsQn
O parmetro NUMSQN retornar o nmero seqencial nico da transao.

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).

Manual do Desenvolvedor Komerci Integrado


O estabelecimento poder optar por rejeitar transaes de emissores estrangeiros atravs do tratamento deste parmetro. Caso o estabelecimento opte por aceitar cartes emitidos no exterior, dever sempre analisar ou monitorar a solicitao antes de confirmar a transao.

conFcodreT
O parmetro CONFCODRET devolver o cdigo de retorno da confirmao da transao.

Caso tenha optado por confirmao manual ou a transao no seja aprovada, este campo no ser retornado.

ndice

conFmsgreT
O parmetro CONFMSGRET devolver a mensagem de retorno da confirmao da transao. Caso tenha optado por confirmao manual ou a transao no seja aprovada, este campo no ser retornado.

Autorizao em um passo

11

VERIFICAO DE APROVAO OU NO APROVAO Assuma uma transao como APROVADA somente quando o parmetro CODRET estiver zerado (0) e o parmetro NUMCV estiver diferente de vazio. Em qualquer outra situao, a transao NO est APROVADA.

esTorno dA AuTorizAo em um PAsso


Para realizar o estorno de uma transao necessrio utilizar o mtodo VoidTransaction.

Manual do Desenvolvedor Komerci Integrado


A operao de estorno s pode ser solicitada no mesmo dia em que a transao de captura foi realizada, isto , at as 23:59h do horrio oficial de Braslia. Este mtodo requer autenticao de Usurio e Senha e validao do cadastramento atravs do Anexo B: Gerenciamento de Usurios Webservices.

O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome TOTAL FILIACAO NUMCV NUMAUTOR CONCENTRADOR USR PWD Tamanho 10 9 9 6 5 16 20 Descrio Valor total da compra Nmero de filiao do estabelecimento Nmero do Comprovante de Venda (NSU) Nmero de Autorizao N/A Enviar parmetro com valor vazio Cdigo do usurio Master Senha de acesso do usurio Master

ndice

ToTAl
O parmetro TOTAL dever conter o valor da transao realizada.

Autorizao em um passo

12

No caso especfico de Companhias Areas, este parmetro dever conter o valor resultante da somatria dos valores das passagens areas sem a Taxa de Embarque. Este valor dever ser separado por . (ponto). Exemplo: 34.60 obrigatria a existncia de duas casas decimais.

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

Fornecedor, no caso de venda atravs de distribuidores ou B2B.

Manual do Desenvolvedor Komerci Integrado


numcv
O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi retornado pela Redecard.

numAuTor
O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao que foi retornado pela Redecard. Por exemplo: Se foi retornado o n 012345, o estabelecimento dever enviar o n 012345 e no 12345 (suprimindo o valor 0 - zero).

concenTrAdor
O parmetro CONCENTRADOR dever conter o cdigo do concentrador.

Este dado no est sendo utilizado atualmente. Envie este parmetro com valor vazio, a menos que receba instruo contrria.

ndice

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

Autorizao em um passo

13

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

reTorno dA soliciTAo de esTorno dA TrAnsAo


O retorno da operao VoidTransaction ser enviado em XML.

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8?> <CONFIRMATION> <root> <codret>9</codret> <msgret>Mensagem</msgret> </root> </CONFIRMATION>

Nome CODRET MSGRET

Tamanho 2 250

Descrio Cdigo de retorno Descrio do cdigo de retorno

codreT
O parmetro CODRET retornar um cdigo referente ao status da solicitao. Caso o estorno tenha sido concretizado com sucesso, o valor retornado neste parmetro ser 0 (zero). Caso contrrio, isto , se o estorno no for concretizado por qualquer motivo, o webservices retornar um cdigo de erro. Vide tpico Tabela de Erros em Parametrizao.

msgreT
O parmetro MSGRET retornar a mensagem de status da solicitao correspondente ao cdigo retornado no parmetro CODRET.

ndice

Autorizao em dois passos (Pr-Autorizao)


Passo 1: Utilizar o mtodo GetAuthorized. Passo 2: Utilizar o mtodo ConfPreAuthorization

14

PAsso 1: geTAuThorized
Em caso de sucesso, este mtodo retorna informaes sobre a autorizao (Nmero do CV, Nmero da Autorizao entre outros). Em caso de erro ou autorizao negada, envia cdigo e mensagem com o motivo de negativa da transao. O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome TOTAL TRANSACAO PARCELAS Tamanho 10 2 2 Descrio Valor total da compra Tipo de Transao (73) Nmero de parcelas

FILIACAO 9 Nmero de filiao do estabelecimento (fornecedor) Manual do Desenvolvedor Komerci Integrado NUMPEDIDO NRCARTAO CVC2 MES ANO PORTADOR IATA DISTRIBUIDOR CONCENTRADOR TAXAEMBARQUE ENTRADA NUMDOC1 a NUMDOC4 PAX1 a PAX4 CONFTXN ADD_Data 16 3 2 2 30 9 9 5 10 10 16 26 1 N/I Nmero do pedido gerado pelo estabelecimento Nmero do carto CVC2 Ms da validade do carto Ano da validade do carto Nome do Portador N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio S N/A Enviar parmetro com valor vazio 16

ndice

Autorizao em dois passos

15
obrigatrio o envio de todos os parmetros detalhados acima. Mesmo que algum deles no seja utilizado, o estabelecimento dever envi-lo com valor vazio. Os dados do portador do carto (carto, validade, CVC2, etc) no devem ser armazenados pelo estabelecimento. Apenas devem ser trafegados no momento do pedido do cdigo de autorizao da transao.

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.

Manual do Desenvolvedor Komerci Integrado


TrAnsAcAo
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 ( vista ou parcelada) feita no momento da confirmao da transao (Passo 2).

PArcelAs
Ele dever ser preenchido com vazio, pois o nmero de parcelas s ser enviado no passo2.

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

ndice

numPedido
O parmetro NUMPEDIDO dever conter o n do pedido referncia da loja. Este campo poder ser preenchido de acordo com a poltica interna do estabelecimento e deve ser tratado nos casos de pedidos duplicados pelo prprio sistema do estabelecimento. O sistema da Redecard no valida esse parmetro.

Autorizao em dois passos

16

No utilizar caracteres especiais (acentuao) Campo Obrigatrio

numcArTAo
O parmetro NRCARTAO dever conter o nmero do carto de crdito do portador, podendo ser MasterCard, Diners ou Visa. No so aceitos cartes de Dbito.

cvc2
O parmetro CVC2 dever conter o cdigo de segurana do carto com trs posies numricas.

Manual do Desenvolvedor Komerci Integrado

mes
O parmetro MES dever conter o ms de validade do carto do portador com duas posies (FORMATO MM).

Ano
O parmetro ANO dever conter o ano de validade do carto do portador com duas posies (FORMATO AA).

PorTAdor
O parmetro PORTADOR dever conter o nome do portador da forma que foi informado por ele.

ndice

conFTxn
Caso este parmetro no seja preenchido com S, o sistema entende que necessrio fazer uma confirmao manual utilizando o mtodo ConfirmTxn. O estabelecimento tem at 2 minutos para executar esta confirmao manual aps a autorizao. Mais detalhes no anexo A Confirmao Manual.

Autorizao em dois passos

17

ATENO

obrigatrio o envio de todos os parmetros detalhados acima. Mesmo que algum deles no seja utilizado, o estabelecimento dever envi-lo com valor vazio.

reTorno dA oPerAo geTAuThorized


A mensagem de retorno da operao GetAuthorized ser enviada em XML:

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8?> <AUTHORIZATION> <CODRET>9</CODRET> <MSGRET>Mensagem</MSGRET> <NUMPEDIDO>string</NUMPEDIDO> <DATA>99999999</DATA> <NUMAUTOR>999999</NUMAUTOR> <NUMCV>999999999</NUMCV> <NUMAUTENT>999999</NUMAUTENT> <NUMSQN>999999999</NUMSQN> <ORIGEM_BIN>XXX</ORIGEM_BIN> <CONFCODRET>9</CONFCODRET> <CONFMSGRET>Mensagem</CONFMSGRET> </AUTHORIZATION>

ndice

Autorizao em dois passos

Nome CODRET MSGRET DATA NUMPEDIDO NUMAUTOR NUMCV NUMAUTENT NUMSQN ORIGEM_BIN CONFCODRET CONFMSGRET

Tamanho 2 160 8 16 6 9 27 12 3 2 160

Descrio Cdigo de retorno Descrio do cdigo de retorno Data da transao Nmero do Pedido Nmero de Autorizao Nmero do Comprovante de Venda (NSU) Nmero de Autenticao Nmero seqencial nico Cdigo do pas emissor Cdigo de retorno da confirmao automtica Descrio do cdigo de retorno

18

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. Vide tabela Cdigo de Erro para Autorizao. Este cdigo devolvido apenas para transaes no autorizadas.

Manual do Desenvolvedor Komerci Integrado

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. Vide tabela Cdigo de Erro para Autorizao.

dATA
O parmetro DATA retornar a data em que a transao foi autorizada (no formato AAAAMMDD).

numPedido
O parmetro NUMPEDIDO retornar o n do pedido que foi informado pelo estabelecimento na chamada da operao. O sistema da Redecard no far consistncia deste parmetro.

numAuTor
O parmetro NUMAUTOR retornar o n de autorizao da transao.

ndice

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

Autorizao em dois passos

19

numAuTenT
O parmetro NUMAUTENT retornar o n de autenticao da transao.

numsQn
O parmetro NUMSQN retornar o nmero seqencial nico da transao.

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).

Manual do Desenvolvedor Komerci Integrado


O estabelecimento poder optar por rejeitar transaes de emissores estrangeiros atravs do tratamento deste parmetro. Caso o estabelecimento opte por aceitar cartes emitidos no exterior, dever sempre analisar ou monitorar a solicitao antes de confirmar a transao.

conFcodreT
O parmetro CONFCODRET devolver o cdigo de retorno da confirmao da transao.

Caso tenha optado por confirmao manual ou a transao no seja aprovada, este campo no ser retornado.

ndice

conFmsgreT
O parmetro CONFMSGRET devolver a mensagem de retorno da confirmao da transao. Caso tenha optado por confirmao manual ou a transao no seja aprovada, este campo no ser retornado.

Autorizao em dois passos

20

VERIFICAO DE APROVAO OU NO APROVAO Assuma uma transao como APROVADA somente quando o parmetro CODRET estiver zerado (0) e o parmetro NUMCV estiver diferente de vazio. Em qualquer outra situao, a transao NO est APROVADA.

PAsso 2: conFPreAuThorizATion
Realizar a confirmao do passo1 da transao de pr-autorizao para que esta possa ser faturada.

Manual do Desenvolvedor Komerci Integrado


O estabelecimento tem at 30 dias para realizar este passo. Este mtodo requer autenticao de Usurio e Senha e validao do cadastramento atravs do Anexo B: Gerenciamento de Usurios Webservices.

O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome FILIACAO DISTRIBUIDOR TOTAL PARCELAS DATA NUMAUTOR NUMCV CONCENTRADOR USR PWD Tamanho 9 9 10 2 8 6 9 5 16 20 Descrio Nmero de filiao do estabelecimento N/A - Enviar parmetro com valor vazio Valor total da transao Nmero de parcelas da transao Data da transao Nmero de autorizao da transao Nmero do comprovante de vendas da transao N/A Enviar parmetro com valor vazio Cdigo do usurio Master Senha de acesso do usurio Master

ndice

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

Autorizao em dois passos

21

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.

PArcelAs
O parmetro PARCELAS dever conter o n de parcelas da transao no formato 99. A deciso sobre o parcelamento ou no da transao tomada neste momento de confirmao, e no na solicitao de captura de pr-autorizao (Passo 1). Para efetuar transaes vista, o parmetro PARCELAS dever ser preenchido com o valor 00 (zero zero).

Manual do Desenvolvedor Komerci Integrado

dATA
O parmetro DATA retornar a data em que a transao foi autorizada (no formato AAAAMMDD).

numAuTor
O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao que foi retornado pela Redecard no Passo 1. Por exemplo: Se foi retornado o n 012345, o estabelecimento dever enviar o n 012345 e no 12345 (suprimindo o valor 0 - zero).

numcv
O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi retornado pela Redecard no Passo 1.

ndice

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

Autorizao em dois passos

22

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

reTorno dA soliciTAo de conFirmAo do PAsso 2 (conFirmAo de Pr-AuTorizAo)


O retorno da operao ConfPreAuthorization ser enviado em XML.

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8?> <CONFIRMATION> <root> <codret>9</codret> <msgret>Mensagem</msgret> </root> </CONFIRMATION>

Nome CODRET MSGRET

Tamanho 2 250

Descrio Cdigo de retorno Descrio do cdigo de retorno

codreT
O parmetro CODRET retornar um cdigo referente ao status da solicitao. Caso o estorno tenha sido concretizado com sucesso, o valor retornado neste parmetro ser 0 (zero). Caso contrrio, isto , se o estorno no for concretizado por qualquer motivo, o webservices retornar um cdigo de erro. Vide tpico Tabela de Erros em Parametrizao.

msgreT
O parmetro MSGRET retornar a mensagem de status da solicitao correspondente ao cdigo retornado no parmetro CODRET.

ndice

esTorno de AuTorizAo em dois PAssos (esTorno de Pr-AuTorizAo)


Estorno do Primeiro Passo
Essa operao tem como objetivo cancelar a sensibilizao do saldo do carto do portador utilizando o mtodo VoidPreAuthorization. Nome FILIACAO DISTRIBUIDOR TOTAL DATA NUMAUTOR NUMCV CONCENTRADOR USR PWD Tamanho 9 9 10 8 6 9 5 16 20 Descrio Nmero de filiao do estabelecimento

Autorizao em dois passos

23

Nmero de filiao do estabelecimento distribuidor ou da empresa compradora (B2B) Valor total da transao Data da transao. Nmero de autorizao da transao Nmero do comprovante de vendas da transao Cdigo do Concentrador Cdigo do usurio Master Senha de acesso do usurio Master

Manual do Desenvolvedor Komerci Integrado


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

Fornecedor, no caso de venda atravs de distribuidores ou B2B.

disTribuidor
O parmetro DISTRIBUIDOR especfico para estabelecimentos que vendem atravs de distribuidores ou que realizam B2B. Ele dever conter o n de filiao do estabelecimento responsvel pela transao (distribuidor ou empresa compradora de B2B), cadastrado junto a Redecard. Caso o estabelecimento no pertena aos segmentos citados acima ou caso o prprio fornecedor que seja o responsvel pela transao em questo, basta enviar este parmetro com valor vazio.

O distribuidor s pode confirmar as transaes de pr-autorizao que ele mesmo realizou, em nome e em favor de seu fornecedor.

ndice

ToTAl
O parmetro TOTAL dever conter o valor da transao realizada.

Autorizao em dois passos

24

No caso especfico de Companhias Areas, este parmetro dever conter o valor resultante da somatria dos valores das passagens areas sem a Taxa de Embarque. Este valor dever ser separado por . (ponto). Exemplo: 34.60 obrigatria a existncia de duas casas decimais.

dATA
O parmetro DATA dever conter a data em que a transao foi autorizada (no formato AAAAMMDD).

numAuTor
O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao que foi retornado pela Redecard. Por exemplo: Se foi retornado o n 012345, o estabelecimento dever enviar o n 012345 e no 12345 (suprimindo o valor 0 - zero).

Manual do Desenvolvedor Komerci Integrado

numcv
O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi retornado pela Redecard.

concenTrAdor
O parmetro CONCENTRADOR dever conter o cdigo do concentrador.

Este dado no est sendo utilizado atualmente. Envie este parmetro com valor vazio, a menos que receba instruo contrria.

ndice

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

Autorizao em dois passos

25

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

Estorno do Segundo Passo


Essa operao tem como objetivo cancelar uma transao de pr-autorizao utilizando o mtodo VoidConfPreAuthorization. A operao de estorno s pode ser solicitada no mesmo dia em que a transao de captura foi realizada, isto , at as 23:59h do horrio oficial de Braslia. Este mtodo requer autenticao de Usurio e Senha e validao do cadastramento atravs do Anexo B: Gerenciamento de Usurios Webservices.

O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome FILIACAO TOTAL PARCELAS DATA NUMAUTOR NUMCV CONCENTRADOR USR PWD Tamanho 9 10 2 8 6 9 5 16 20 Descrio

Manual do Desenvolvedor Komerci Integrado


Nmero de filiao do estabelecimento Valor total da transao Nmero de parcelas da transao Data da transao Nmero de autorizao da transao Nmero do comprovante de vendas da transao Cdigo do Concentrador Cdigo do usurio Master Senha de acesso do usurio Master

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

Fornecedor, no caso de venda atravs de distribuidores ou B2B.

ndice

ToTAl
O parmetro TOTAL dever conter o valor da transao realizada.

Autorizao em dois passos

26

No caso especfico de Companhias Areas, este parmetro dever conter o valor resultante da somatria dos valores das passagens areas sem a Taxa de Embarque. Este valor dever ser separado por . (ponto). Exemplo: 34.60 obrigatria a existncia de duas casas decimais.

PArcelAs
O parmetro PARCELAS dever conter o n de parcelas da transao no formato 99 que foi informado pelo estabelecimento na confirmao da transao. O parmetro PARCELAS dever ser preenchido com o valor 00 (zero zero) quando a transao tiver sido realizada vista.

dATA

O parmetro DATA dever conter a data em que a transao foi autorizada (no formato AAAAMMDD).

Manual do Desenvolvedor Komerci Integrado

numAuTor
O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao que foi retornado pela Redecard. Por exemplo: Se foi retornado o n 012345, o estabelecimento dever enviar o n 012345 e no 12345 (suprimindo o valor 0 - zero)

numcv
O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi retornado pela Redecard.

concenTrAdor
O parmetro CONCENTRADOR dever conter o cdigo do concentrador.

Este dado no est sendo utilizado atualmente. Envie este parmetro com valor vazio, a menos que receba instruo contrria.

ndice

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

Autorizao em dois passos

27

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

reTorno dA soliciTAo de esTorno de Pr-AuTorizAo)


O retorno da operao VoidPreAuthorization ser enviado em XML.

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8?> <CONFIRMATION> <root> <codret>9</codret> <msgret>Mensagem</msgret> </root> </CONFIRMATION>

Nome CODRET MSGRET

Tamanho 2 250

Descrio Cdigo de retorno Descrio do cdigo de retorno

codreT
O parmetro CODRET retornar um cdigo referente ao status da solicitao. Caso o estorno tenha sido concretizado com sucesso, o valor retornado neste parmetro ser 0 (zero). Caso contrrio, isto , se o estorno no for concretizado por qualquer motivo, o webservices retornar um cdigo de erro. Vide tpico Tabela de Erros em Parametrizao.

msgreT
O parmetro MSGRET retornar a mensagem de status da solicitao correspondente ao cdigo retornado no parmetro CODRET.

ndice

Servios AVS
Este servio pode ser utilizado nas transaes de Autorizaao em um passo ou Autorizao em dois passos, substituindo o mtodo GetAuthorized pelo mtodo GetAuthorizedAVS. A implementao de AVS depende da contratao de servios adicionais. Para transaes VISA esta opo no est disponvel. Para este servio necessrio fazer a confirmao manual, pois o estabelecimento pode tomar decises diferentes de acordo com a resposta AVS. (Anexo B)

28

Nome TOTAL TRANSACAO PARCELAS FILIACAO NUMPEDIDO CVC2 MES ANO PORTADOR CPF ENDERECO NUM1 COMPLEMENTO CEP2 IATA DISTRIBUIDOR CONCENTRADOR TAXAEMBARQUE ENTRADA NUMDOC1 a NUMDOC4 PAX1 a PAX4 CEP1

Tamanho 10 2 2 9 16 3

Descrio Valor total da compra Tipo de Transao Nmero de parcelas Nmero de filiao do estabelecimento (fornecedor) Nmero do pedido gerado pelo estabelecimento CVC2

Manual do Desenvolvedor Komerci Integrado NRCARTAO 16 Nmero do carto


2 2 50 11 50 6 30 5 3 9 9 5 10 10 16 26 Ms da validade do carto Ano da validade do carto Nome do Portador Nmero do CPF Endereo Nmero do endereo Complemento do endereo Complemento do nmero do CEP N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio Nmero do CEP

ndice

Servios AVS

cPF
O parmetro CPF dever conter o nmero do CPF do titular do carto, sem pontos e/ou traos.

29

endereo
O parmetro ENDERECO dever conter o logradouro do endereo de entrega da fatura do carto de crdito do portador, sem nmero e/ou complemento.

num1
O parmetro NUM1 dever conter o nmero do endereo de entrega da fatura do carto de crdito do portador, sem complemento.

comPlemenTo
O parmetro COMPLEMENTO dever conter o complemento do endereo de entrega da fatura do carto de crdito do portador, caso exista.

ceP1 e ceP2 do Desenvolvedor Komerci Integrado Manual


Os parmetros CEP1 e CEP2 devero conter o CEP do endereo de entrega da fatura do carto de crdito do portador, no formato XXXXX-YYY, sendo que o primeiro parmetro dever conter os 5 primeiros dgitos e o segundo, os 3 ltimos.

reTorno dA oPerAo geTAuThorizedAvs


Nome CODRET MSGRET DATA NUMPEDIDO NUMAUTOR NUMCV NUMAUTENT NUMSQN ORIGEM_BIN DISTRIBUIDOR IATA Tamanho 2 160 8 16 6 9 27 12 3 12 12 Descrio Cdigo de retorno Descrio do cdigo de retorno Data da transao Nmero do Pedido Nmero de Autorizao Nmero do Comprovante de Venda (NSU) Nmero de Autenticao Nmero seqencial nico Cdigo do pas emissor N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio

ndice

Servios AVS

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. Vide tabela Cdigo de Erro para Autorizao. Este cdigo devolvido apenas para transaes no autorizadas.

30

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. Vide tabela Cdigo de Erro para Autorizao.

dATA
O parmetro DATA retornar a data em que a transao foi autorizada (no formato AAAAMMDD).

numPedido

O parmetro NUMPEDIDO retornar o n do pedido que foi informado pelo estabelecimento na chamada da operao. O sistema da Redecard no far consistncia deste parmetro.

Manual do Desenvolvedor Komerci Integrado

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.

ndice

Servios AVS

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).

31

O estabelecimento poder optar por rejeitar transaes de emissores estrangeiros atravs do tratamento deste parmetro. Caso o estabelecimento opte por aceitar cartes emitidos no exterior, dever sempre analisar ou monitorar a solicitao antes de confirmar a transao.

Manual do Desenvolvedor Komerci Integrado <RESPAVS>XX</RESPAVS>


<MSGAVS>Mensagem</MSGAVS>

Se a transao for aprovada e bem sucedida, a Redecard enviar ao estabelecimento, o retorno da operao GetAuthorizedAVS em XML, com estes 2 campos acrescidos aos demais.

Nome RESPAVS MSGAVS

Tamanho 2 80

Descrio Cdigo de retorno do AVS Mensagem de retorno do AVS

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.

ndice

Servios AVS

Os dados que podero ser retornados nos parmetros RESPAVS e MSGAVS so: Cdigos (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.

32

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 quele cdigo.

Cdigos (RESPAVS) 53 81

Descrio (MSGAVS) Transao Invlida (AVS no contratado)

Cdigo Relatrio Transao* R

74 Instituio sem comunicao R Manual do Desenvolvedor Komerci Integrado Banco no pertence rede ou Carto Corporativo B

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: A deciso de confirmar ou negar uma transao dependendo de seu cdigo de retorno uma deciso poltica do estabelecimento. No caso de confirmao, o estabelecimento dever prosseguir as instrues deste manual. Para recusar a transao, basta terminar o fluxo nesta etapa. de inteira responsabilidade do estabelecimento fazer o tratamento de quaisquer informaes retornadas pela Redecard.

ndice

Servios AVS

33
VERIFICAO DE APROVAO OU NO APROVAO Assuma uma transao como APROVADA somente quando o parmetro CODRET estiver zerado (0) e o parmetro NUMCV estiver diferente de vazio. Em qualquer outra situao, a transao NO est APROVADA.

No caso de transaes no aprovadas, o fluxo termina nesta etapa. O fato de o parmetro RESPAVS conter erro, no significa que a transao foi negada. O resultado desse parmetro independe da aprovao ou no da transao pelo emissor.

Manual do Desenvolvedor Komerci Integrado

ndice

Relatrio de Vendas
eTAPA 1 - soliciTAo do servio de relATrio de vendAs.
Realizar a solicitao do relatrio de vendas. O mtodo CouncilReport retorna as transaes efetuadas com seus respectivos status.

34

Este relatrio extrai informaes com o perodo mximo (DATA_INICIAL e DATA_FINAL) de 15 dias da data da solicitao do Relatrio.

O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome FILIACAO USR Tamanho 9 16 Descrio Nmero de filiao do estabelecimento Cdigo de usurio Master (Portal Redecard)

Manual do Desenvolvedor Komerci Integrado PWD 20 Senha de acesso do USR (Portal Redecard)
Filtros de Pesquisa DISTRIBUIDOR DATA_INICIAL DATA_FINAL TIPO_TRX STATUS_TRX SERVICO_AVS 9 8 8 2 1 1 N/A - Enviar parmetro com valor vazio Data inicial do perodo de transaes a ser pesquisado Data final do perodo de transaes a ser pesquisado Cdigo do tipo de transao a ser pesquisado Cdigo de status da transao a ser pesquisado Cdigo de restrio AVS a ser pesquisado

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

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

ndice

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

Relatrio de Vendas

35

FilTros de PesQuisA: dATA_iniciAl


O parmetro DATA_INICIAL obrigatrio. Ele dever conter a data inicial do perodo de transaes a ser pesquisado (no formato AAAAMMDD).

dATA_FinAl
O parmetro DATA_FINAL obrigatrio. Ele dever conter a data final do perodo de transaes a ser pesquisado (no formato AAAAMMDD).

Manual TiPo_Trx do Desenvolvedor Komerci Integrado


O parmetro TIPO_TRX facultativo. Ele poder conter o cdigo do tipo de transao a ser pesquisado para filtrar ainda mais o relatrio (vide tabela de cdigos a seguir). Para visualizar todos os tipos de transao, o estabelecimento dever enviar este parmetro com valor vazio. Cdigos 04 06 08 73 39 40 Descrio vista Parcelado Emissor Parcelado Estabelecimento Pr-Autorizao Crdito IATA (apenas para Companhias Areas) Parcelado Estabelecimento IATA (apenas para Companhias Areas)

ndice

sTATus_Trx
O parmetro STATUS_TRX facultativo. Ele poder conter o status de transao a ser pesquisado para filtrar ainda mais o relatrio (vide tabela de cdigos a seguir). Para visualizar todas as transaes, independente de seu status, o estabelecimento dever enviar este parmetro com valor vazio. Cdigos 0 1 2 3 4 Descrio Pendente Confirmada No Aprovada Desfeita Estornada

Relatrio de Vendas

36

servio_Avs
O parmetro SERVICO_AVS facultativo. Ele poder conter o cdigo que exibe apenas transaes com ou sem AVS para filtrar ainda mais o relatrio (vide tabela de cdigos a seguir). Para visualizar todas as transaes, com e sem AVS simultaneamente, o estabelecimento dever enviar este parmetro com valor vazio.

Manual do Desenvolvedor Komerci Integrado


Cdigos S N Descrio Apenas transaes realizadas com AVS. Apenas transaes realizadas sem AVS.

ndice

reTorno dA soliciTAo do relATrio de vendAs


O retorno da operao CouncilReport ser enviado em XML no formato a seguir:

Relatrio de Vendas

37

Manual do Desenvolvedor Komerci Integrado

<?xml version=1.0 encoding=utf-8 ?> <COUNCIL> <HEADER> <PERIODO>string</PERIODO> <DATA_REQUISICAO>string</DATA_REQUISICAO> <HORA_REQUISICAO>string</HORA_REQUISICAO> <FILIACAO>string</FILIACAO> </HEADER> <REGISTRO> <DES_DSTR>string</DES_DSTR> <FILIACAO_DSTR>string</FILIACAO_DSTR> <TRANSACAO>string</TRANSACAO> <PARCELAS>string</PARCELAS> <DATA>string</DATA> <HORA>string</HORA> <TOTAL>string</TOTAL> <MOEDA>string</MOEDA> <NUMPEDIDO>string</NUMPEDIDO> <NUMAUTOR>string</NUMAUTOR> <NUMCV>string</NUMCV> <COD_RET>string</COD_RET> <MSG_RET>string</MSG_RET> <STATUS>string</STATUS> <NR_CARTAO>string</NR_CARTAO> <NOM_PORTADOR>string</NOM_PORTADOR> <RESP_AVS>string</RESP_AVS> <MSG_AVS>string</MSG_AVS> <DATA_EXP_PRE_AUT>string</DATA_EXP_PRE_AUT> <DATA_CON_PRE_AUT>string</DATA_CON_PRE_AUT> <TAXA_EMBARQUE>string</TAXA_EMBARQUE> <USUARIO>string</USUARIO> <CEP>string</CEP> <NU_ENDERECO>string</NU_ENDERECO> <ENDERECO>string</ENDERECO> </REGISTRO> </COUNCIL>

Como se pode observar, o retorno do relatrio de transaes separado em duas partes distintas:

1 2

O cabealho, contendo informaes do perodo solicitado (data e hora da solicitao do relatrio e filiao do estabelecimento) O corpo, contendo os ns ou nodes de registro que trazem os detalhes das transaes que atenderam ao filtro descrito na chamada da operao.

ndice

TAbelA descriTivA dos reTornos:


Em virtude do retorno do relatrio possuir duas partes, o cabealho e o corpo, sero descritos os parmetros retornados de forma agrupada:

Relatrio de Vendas

38

Cabealho do Relatrio
Trecho do relatrio compreendido entre os ns/nodes <HEADER></HEADER> Nome PERIODO DATA_REQUISIACAO HORA_REQUISICAO FILIACAO Tamanho 20 8 8 9 Descrio Perodo selecionado Data da requisio do relatrio Hora da requisio do relatrio Nmero de filiao utilizado na consulta

Periodo

O parmetro PERIODO retornar o perodo de pesquisa solicitado no formato: (AAAAMMDD a AAAAMMDD).

Manual do Desenvolvedor Komerci Integrado

dATA_reQuisicAo
O parmetro DATA_REQUISICAO retornar a data em que o relatrio foi solicitado e emitido no formato (AAAAMMDD).

horA_reQuisicAo
O parmetro HORA_REQUISICAO retornar a hora em que o relatrio foi solicitado e emitido no formato (HH:MM:SS).

FiliAcAo
O parmetro FILIACAO retornar o nmero de filiao do estabelecimento fornecido para pesquisa de transaes.

ndice

Corpo do Relatrio
Trecho do relatrio compreendido entre os ns/nodes <REGISTRO></REGISTRO>. Nome DES_DSTR FILIACAO_DSTR TRANSACAO PARCELAS DATA HORA TOTAL MOEDA NUMPEDIDO NUMAUTOR NUMCV COD_RET MSG_RET Tamanho 40 9 30 2 8 6 10 10 16 6 9 2 160 16 2 80 8 8 10 16 9 6 150 Descrio Nome comercial do estabelecimento distribuidor Nmero de filiao do estabelecimento distribuidor ou empresa compradora responsvel pela transao Descrio do tipo de transao Nmero de parcelas da transao Data de efetivao da transao Hora da efetivao da transao Valor total da transao Tipo de moeda da transao

Relatrio de Vendas

39

Nmero do pedido gerado pelo estabelecimento para a transao Nmero de autorizao da transao Nmero do comprovante de vendas da transao Cdigo de retorno da transao Mensagem de retorno da transao

STATUS 20 Manual do Desenvolvedor Status da transao Komerci Integrado NR_CARTAO RESP_AVS MSG_AVS DATA_EXP_PRE_AUT DATA_CON_PRE_AUT TAXA_EMBARQUE USUARIO CEP NU_ENDERECO ENDERECO Nmero mascarado do carto utilizado na transao Nome do portador que foi informado na transao Cdigo de retorno da consulta de AVS Mensagem de retorno da consulta de AVS Data de expirao da pr-autorizao Data de concluso da pr-autorizao Valor da taxa de embarque da transao Cdigo do usurio ou canal CEP informado na consulta de AVS Nmero do endereo informado na consulta AVS Logradouro informado na consulta AVS NOM_PORTADOR 100

des_dsTr
Caso o valor informado no parmetro FILIACAO da solicitao deste servio tenha sido preenchido com o nmero de um estabelecimento fornecedor, o parmetro DES_DSTR retornar o nome comercial do estabelecimento distribuidor ou empresa compradora (B2B), cadastrado(a) junto a Redecard e responsvel pela transao em questo. Caso o parmetro DISTRIBUIDOR tenha sido enviado de forma preenchida na solicitao deste servio, o relatrio s retornar transaes do distribuidor / empresa compradora informado(a).

ndice

FiliAcAo_dsTr
O parmetro FILIACAO_DSTR retornar o nmero de filiao do estabelecimento correspondente ao valor retornado no parmetro DES_DSTR.

Relatrio de Vendas

40

TrAnsAcAo
O parmetro TRANSACAO retornar a descrio do tipo de transao realizada.

PArcelAs
O parmetro PARCELAS retornar o nmero de parcelas que a transao foi realizada.

dATA
O parmetro DATA retornar a data de efetivao da transao no formato (AAAAMMDD).

horA

O parmetro HORA retornar a hora de efetivao da transao no formato (HHMMSS).

Manual do Desenvolvedor Komerci Integrado

ToTAl
O parmetro TOTAL retornar o valor total da transao. Nesta operao, especificamente, este valor retorna com vrgula (,) no separador de decimal.

moedA
O parmetro MOEDA retornar o tipo de moeda em que a transao foi realizada.

numPedido
O parmetro NUMPEDIDO retornar o nmero de pedido informado pelo estabelecimento na transao. Caso este parmetro no tenha sido informado, ele ser retornado com valor vazio no relatrio.

ndice

numAuTor
O parmetro NUMAUTOR retornar o nmero de autorizao da transao.

Relatrio de Vendas

41

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

cod_reT
O parmetro COD_RET retornar o cdigo de retorno da autorizao da transao.

msg_reT
O parmetro MSG_RET retornar a mensagem correspondente ao cdigo de retorno COD_RET da autorizao da transao.

sTATus

O parmetro STATUS retornar a condio (posio) atual da transao.

Manual do Desenvolvedor Komerci Integrado

nr_cArTAo
O parmetro NR_CARTAO retornar o nmero mascarado do carto utilizado na transao.

nom_PorTAdor
O parmetro NOM_PORTADOR retornar o nome do portador informado na transao.

resP_Avs
O parmetro RESP_AVS retornar o cdigo de retorno da consulta de AVS, caso este servio tenha sido utilizado na transao.

msg_Avs
O parmetro MSG_AVS retornar a mensagem da consulta de AVS, correspondente ao cdigo RESP_AVS retornado, caso este servio tenha sido utilizado na transao.
ndice

dATA_exP_Pre_AuT
O parmetro DATA_EXP_PRE_AUT retornar a data de expirao da transao de pr-autorizao, no formato (AAAAMMDD), caso este tipo de transao tenha sido utilizado.

Relatrio de Vendas

42

dATA_con_Pre_AuT
O parmetro DATA_CON_PRE_AUT retornar a data de concluso da transao de pr-autorizao, no formato (AAAAMMDD), caso este tipo de transao tenha sido utilizado.

TAxA_embArQue
O parmetro TAXA_EMBARQUE retornar o valor da taxa de embarque informado na transao. Caso este parmetro no tenha sido informado, ele ser retornado com valor vazio no relatrio.

usuArio
O parmetro USUARIO retornar o cdigo do usurio que realizou a transao, caso ela tenha sido efetivada via Portal Redecard ou o canal em que ela foi realizada, caso ela tenha sido efetivada via WebServices. Caso contrrio, o parmetro USUARIO ser retornado com valor vazio no relatrio.

Manual do Desenvolvedor Komerci Integrado

ceP
O parmetro CEP retornar o CEP informado na transao, caso ela tenha sido realizada com consulta AVS.

nu_endereco
O parmetro NU_ENDERECO retornar o nmero do endereo informado na transao, caso ela tenha sido realizada com consulta AVS.

endereco
O parmetro ENDERECO retornar o logradouro informado na transao, caso ela tenha sido realizada com consulta AVS.

Para cada transao haver um novo n ou node denominado REGISTRO.

ndice

Resumo de Vendas
Etapa 1 - Solicitao do Servio Resumo de Vendas
Descrio:
Realizar a extrao do resumo de vendas que contm um sumrio das vendas efetuadas na data corrente. O estabelecimento dever enviar os seguintes parmetros para a Redecard: Nome FILIACAO USR PWD Tamanho 9 16 20 Descrio Nmero de filiao do estabelecimento Cdigo do usurio Master Senha de acesso do usurio Master

43

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

Manual do Desenvolvedor Komerci Integrado

usr
O parmetro USR dever conter um cdigo de usurio cadastrado seguindo as instrues do Anexo B.

Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.

ndice

reTorno dA soliciTAo de resumo de vendAs


O retorno da operao VoidPreAuthorization ser enviado em XML. <?xml version=1.0 encoding=utf-8 ?> <REPORT> <HEADER> <DATA_REQUISICAO>String</DATA_REQUISICAO> <HORA_REQUISICAO>String</HORA_REQUISICAO> <FILIACAO>String</FILIACAO> </HEADER> <root> <codret>String</codret> <msgret>String</msgret> <resumoVendas row_count=1> <12341 dt_rv=12/12/12 qtd_cv=123 val_totl_pago=123 val_ totl_lqdo=123 text=texto> </12341> </resumoVendas> </root> </REPORT>

Resumo de Vendas

44

Assim como o retorno da operao CouncilReport, o retorno da operao SalesSumm composto de duas partes: o cabealho e o corpo.

Manual do Desenvolvedor Komerci Integrado


Cabealho do Resumo

dATA_reQuisicAo
O campo DATA_REQUISICAO retornar a data em que o relatrio foi solicitado e emitido em formato (AAAAMMDD).

horA_reQuisicAo
O campo HORA_REQUISICAO retornar a hora em que o relatrio foi solicitado e emitido em formato (HH:MM:SS).

FiliAcAo
O campo FILIACAO retornar o nmero de filiao do estabelecimento fornecido para pesquisa de transaes.

ndice

Corpo do Resumo

Resumo de Vendas

45

codreT
O parmetro CODRET retornar um cdigo referente ao status da solicitao. Caso a solicitao do Resumo de Vendas tenha sido concretizada com sucesso, o valor retornado neste parmetro ser 0 (zero). Caso contrrio, isto , se o Resumo de Vendas no for executado por qualquer motivo, o webservices retornar um cdigo de erro. Vide tpico Tabela de Erros em Parametrizao.

msgreT
O parmetro MSGRET retornar a mensagem de status da solicitao correspondente ao cdigo retornado no parmetro CODRET.

resumovendAs
O parmetro RESUMOVENDAS retornar o contedo do resumo de vendas, onde: Este parmetro do Desenvolvedor Komerci (DD/MM/AA). Manualconter a data de gerao do resumo de vendas no formatoIntegrado QTD_CV Este parmetro conter a quantidade de vendas. VAL_TOTL_PAGO Este parmetro conter o valor total das vendas. VAL_TOTL_LQDO Este parmetro conter o valor lquido faturado. DT_RV

ndice

Anexo A
conFirmAo mAnuAl
Realizar a confirmao das transaes que passaram pelo processo de autorizao atravs do mtodo ConfirmTxn. Caso a transao tenha sido aprovada pelo emissor e a transao no tenha sido executada automaticamente pelo valor S do parmetro CONFTXN, o estabelecimento dever confirm-la. A etapa de confirmao deve ocorrer somente quando a etapa anterior (Autorizao) no tenha tido 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. Nome DATA NUMSQN NUMCV NUMAUTOR PARCELAS TRANSORIG TOTAL Tamanho 8 12 9 6 2 2 15 Descrio Data da transao Nmero seqencial nico Nmero do Comprovante de Vendas Nmero da autorizao Nmero de parcelas da transao Cdigo do tipo da transao Valor da transao

46

FILIACAO 9 Filiao estabelecimento fornecedor Manual do DesenvolvedordoKomerci Integrado DISTRIBUIDOR NUMPEDIDO NUMDOC1 a NUMDOC4 PAX1a PAX4 9 16 16 26 Filiao do estabelecimento distribuidor / portador do carto no caso de B2B Nmero do pedido N/A - Enviar parmetro com valor vazio N/A - Enviar parmetro com valor vazio

dATA
O parmetro DATA dever conter a data em que a transao foi autorizada (no formato AAAAMMDD), que foi informado pela Redecard no campo DATA no passo anterior.

numsQn
O parmetro NUMSQN dever conter o n seqencial nico da transao que foi informado pela Redecard no campo NUMSQN no passo anterior.

ndice

Anexo A

numcv
O parmetro NUMCV dever conter o n do comprovante de vendas da transao que foi informado pela Redecard no campo NUMCV no passo anterior.

47

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 (o estabelecimento 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.

PArcelAs
O parmetro PARCELAS dever conter o n de parcelas da transao que foi informado pela loja-virtual no campo PARCELAS no passo anterior.

Manual do Desenvolvedor Komerci Integrado Cartes emitidos no exterior no podem conter transaes parceladas, essa
uma determinao dos emissores internacionais.

TrAnsorig
O parmetro TRANSORIG dever conter o cdigo do tipo de transao que foi informado pelo estabelecimento no campo TRANSACAO no passo anterior.

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: R$ 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.

ndice

Anexo A

FiliAcAo
O parmetro FILIACAO dever conter o n de filiao do estabelecimento fornecedor (cadastrado junto a Redecard), que foi informado pelo estabelecimento no campo FILIACAO no passo anterior.

48

numPedido
O parmetro NUMPEDIDO dever conter o n do pedido que foi autorizado e retornado pela Redecard no campo NUMPEDIDO no passo anterior.

ATENO
Caso o estabelecimento decida no confirmar a transao, por motivo qualquer, basta que o estabelecimento no execute esta etapa do fluxo. Neste caso, a transao ser automaticamente desfeita. Transaes desfeitas no so faturadas para o Estabelecimento e nem debitadas do cliente portador do carto.

Manual do Desenvolvedor Komerci Integrado


A confirmao da transao significa que o estabelecimento deseja seguir com a transao e no est vinculada ao processamento ou no do pedido.

Aps a autorizao da transao, o estabelecimento ter 2 minutos aps o retorno da autorizao para efetuar a confirmao. Caso a transao no seja confirmada neste perodo, ela ser automaticamente desfeita.

reTorno dA oPerAo conFirmTxn


A mensagem de retorno da operao ConfirmTxn ser enviada em formato XML:

<CONFIRMATION> <CODRET>99</CODRET> <MSGRET>Mensagem</MSGRET> </CONFIRMATION>

ndice

Anexo A

Nome CODRET MSGRET

Tamanho 2 200

Descrio Cdigo de retorno Mensagem de retorno

49

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.

cdigos e mensAgens de reTorno:


0 = CONFIRMAO COM SUCESSO 1 = JA CONFIRMADA A confirmao foi realizada com sucesso e efetivada; A transao j foi confirmada anteriormente;

2 = TRANSAO NEGADA

Manual do Desenvolvedor Komerci autorizador; Integrado A transao de confirmao foi negada pelo

3 = TRANSAO DESFEITA A transao foi desfeita, pois o tempo disponvel de dois minutos para confirmao foi ultrapassado; 4 = TRANSAO ESTORNADA A transao foi estornada anteriormente pelo processo de estorno de transao; 8 = DADOS NAO COINCIDEM da transao. Os dados informados no conferem com a 1 e 2 etapa

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)

O estabelecimento dever tratar cada uma das mensagens de retorno e informar o portador dependendo da situao.

ndice

Anexo B
gerenciAmenTo de usurios webservices
Caso o estabelecimento ainda no tenha efetuado seu cadastro no Portal Redecard, basta acess-lo na URL: www.redecard.com.br, clicar em Cadastre-se e preencher as informaes solicitadas at o trmino do processo. Ao final da operao, o estabelecimento dever cadastrar um cdigo de usurio e senha de acesso ao Portal Redecard. Com este usurio Portal Redecard o estabelecimento tem acesso ao Portal de Servios e consegue criar o usurio Komerci (menu de servios na opo Komerci Usurios do Komerci). este usurio que o estabelecimento dever utilizar no parmetro USR para autenticar-se perante a solicitao de qualquer servio via webservices.

50

Manual do Desenvolvedor Komerci Integrado

ndice

Anexo C
comProvAnTe de vendAs
Endereo: https://ecommerce.redecard.com.br/pos_virtual/cupom.asp: Camadas: Request HTTP/POST
Caso o estabelecimento queira um comprovante de vendas, o mesmo dever ser emitido atravs de uma solicitao HTTPS. O retorno do cupom NO disponibilizado atravs de um mtodo Web Service. Devidamente confirmada a transao, o estabelecimento dever solicitar o Comprovante de Venda, enviando os seguintes parmetros preenchidos: Nome DATA TRANSACAO NUMAUTOR NUMCV FILIACAO Tamanho 8 3 6 9 9 Descrio Data da transao Cdigo 201 Nmero da autorizao Nmero do Comprovante de Vendas Filiao do Estabelecimento Fornecedor

51

Manual do Desenvolvedor Komerci Integrado


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

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

numAuTor
O parmetro NUMAUTOR dever conter exatamente o mesmo n de autorizao da transao que foi retornado pela Redecard no campo NUMAUTOR na segunda etapa do fluxo. Por exemplo: Se foi retornado o n 012345, a loja-virtual dever enviar o n 012345 e no 12345 (suprimindo o valor 0 - zero).

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

Anexo C

FiliAcAo
O parmetro FILIACAO dever conter o n de filiao do estabelecimento fornecedor (cadastro junto a Redecard) que foi informado pelo estabelecimento no campo FILIACAO na primeira etapa do fluxo.

52

reTorno do comProvAnTe de vendAs


O resultado gerado pelo WebService quando da solicitao da tela ... cupom.asp est disposto no cdigo-fonte a seguir. Este resultado dever ser tratado pelo aplicativo do estabelecimento.

Manual do Desenvolvedor Komerci Integrado

<html><head><title>Redecard</title> <script> function janela() { window.open(,vpos_cv,scrollbars=yes,location=no,directories=no,status=yes,menubar=no ,resizable=yes, toolbar=no,top=50,left=50,width=680,height=460 ); } </script> <STYLE> .Button { BORDER-RIGHT: #000000 1px solid; BORDER-TOP: #000000 1px solid; FONT-WEIGHT: bold; FONT-SIZE: 11px; BACKGROUND-IMAGE: url(FundoBotao.gif); BORDER-LEFT: #000000 1px solid; CURSOR: hand; COLOR: #ffffff; BORDER-BOTTOM: #000000 1px solid; BACKGROUND-REPEAT: repeat-x; FONT-FAMILY: Helvetica, Arial, sans-serif; BACKGROUND-COLOR: #003399; TEXT-DECORATION: none } </STYLE> </head> <body bgcolor=FFFFFF marginheight=0 marginwidth=0 topmargin=0 leftmargin=0 onLoad=javascript:return true; >

ndice

Anexo C

53
<center> <table border=0 width=280><tr><td align=center> <IMG SRC=mcardcv.gif BORDER=0> </td></tr><tr><td> <CENTER><FONT FACE=TAHOMA SIZE=1> REDECARD <BR><BR> MASTERCARD <BR><BR><BR>COMPR:003866085 VALOR: 0,01<BR><BR>ESTAB:011373822 TESTE E-COMMERCE <BR>26.05.03-16:53:48 TERM:PVxxxxxx/xxxxxx<BR>CARTAO: 5476.xxxx.xxxx.xxxx <BR>AUTORIZACAO: 027740 <BR> RECONHECO E PAGAREI A DIVIDA <BR> AQUI REPRESENTADA <BR><BR><BR> ____________________________ <BR> <BR> NOME DO PORTADOR </msgret><show_aut > </CENTER></FONT></td></tr></table><br><center> <TABLE BORDER=0 WIDTH=280 ><FORM ACTION=javascript:window.print() name=frmprint> <TD WIDTH=50% ALIGN=CENTER><INPUT TYPE=IMAGE SRC=imprimirA.gif name=btnprint> </TD></FORM><FORM ACTION=Cupom_salvar.asp id=form4 name=form4><input type=hidden name=data value=20030526> <input type=hidden name=numcv value=3866085> <input type=hidden name=numautor value=027740> <TD WIDTH=50% ALIGN=CENTER><INPUT TYPE=IMAGE SRC=salvarA.gif id=IMAGE3 name=IMAGE3> </TD></FORM></TABLE> </center> </body></html>

Manual do Desenvolvedor Komerci Integrado

ndice

Anexo D
cdigos e moTivos de erro em PArAmeTrizAo
Cdigos 20 21 22 23 24 25 26 27 28 29 30 32 33 34 35 36 37 38 39 40 41 Descrio Parmetro obrigatrio ausente Nmero de filiao em formato invlido Nmero de parcelas incompatvel com a transao Problemas no cadastro do estabelecimento. Problemas no cadastro do estabelecimento. Formatao incorreta da transao. Formatao incorreta da transao. Carto invlido. CVC2 em formato invlido. Operao no permitida. Nmero do pedido de referncia da transao IATA maior que 13 posies Parmetro AVS ausente.

54

Manual do Desenvolvedor Komerci Integrado 31 Nmero do pedido maior que o permitido (16 posies).
Cdigo IATA invlido ou inexistente. Cdigo IATA invlido. Distribuidor invlido ou inexistente. Problemas no cadastro do estabelecimento. Operao no permitida. Distribuidor invlido ou inexistente. Operao no permitida no ambiente de teste. Operao no permitida para o cdigo IATA informado. Cdigo IATA invlido ou inexistente. Problemas no cadastro do estabelecimento.

ndice

Anexo D

55
Cdigos 42 43 44 45 56 Descrio Problemas no cadastro do usurio do estabelecimento. Problemas na autenticao do usurio. Usurio incorreto para testes. Problemas no cadastro do estabelecimento para testes. Dados Invlidos.

Para os tens que apresentarem a indicao:

O estabelecimento deve solicitar uma anlise geral no desenvolvimento e caso o erro persista, entre em contato com o SuporteTcnico: 4004-3298 Capitais e regies metropolitanas 0800 726 Manual 32 98 Demais regies do Desenvolvedor Komerci Integrado Disponvel 24h por dia, 7 dias por semana com especialistas bilngues treinados para atender de maneira rpida e eficiente as solicitaes internacionais.

Os erros acima so devolvidos pela aplicao e nestes casos a transao ainda no foi enviada para a autorizao no ambiente REDECARD, (Deve-se verificar a soluo desenvolvida). Para mais detalhes sobre essas mensagens ver o tem da prxima pgina Motivos das Mensagens de Erro de Parametrizao

ndice

Anexo D

moTivos dAs mensAgens de erro de PArAmeTrizAo


Cdigo 20 Parmetro obrigatrio ausente
Nem todos os parmetros que so obrigatrios foram enviados. Devem-se verificar os parmetros obrigatrios em cada mtodo WebService.

56

Cdigo 21 Nmero de filiao em formato invlido

O nmero de filiao no esta em seu formato correto. Este campo deve ser numrico e conter at 9 posies.

Cdigo 22 Nmero de parcelas incompatvel com a transao

O nmero de parcelas incompatvel com o tipo de transao recebido. Caso o tipo de transao no seja parcelado emissor, parcelado estabelecimento ou parcelado IATA, a transao no deve conter o nmero de parcelas. Caso contrrio, a quantidade de parcelas deve ser informada.

Cdigo 23 Problemas no cadastro do estabelecimento

O IP de requisio no esta cadastrado para o respectivo estabelecimento (Filiao ou Distribuidor). Desta forma, o sistema recusa a transao. Vide cadastro dos parmetros do estabelecimento. Alm disso, caso o IP esteja cadastrado para o respectivo estabelecimento e se est acessando mtodo WebService de Teste, este erro pode ocorrer.

Cdigo 24 Problemas no cadastro do estabelecimento Cdigo 25 Estabelecimento no cadastrado

O respectivo estabelecimento (Filiao ou Distribuidor) no est parametrizado para efetuar transaes WebService pelo Komerci. Vide cadastro dos parmetros do estabelecimento. O respectivo estabelecimento (Filiao ou Distribuidor) no esta cadastrado no Komerci.

Manual do Desenvolvedor Komerci Integrado

Cdigo 26 Estabelecimento no cadastrado Cdigo 27 Carto Invlido

O respectivo estabelecimento (Filiao ou Distribuidor) no esta cadastrado no Komerci. O nmero de carto informado esta incorreto, por um ou mais dos seguintes motivos: O carto de bandeira Mastercard ou Visa no numrico com 16 posies. O carto de bandeira Diners no possui de 14 a 16 posies numricas. O dgito do carto esta inconsistente.

Cdigo 28 CVC2 em formato invlido Cdigo 29 Operao no permitida Cdigo 30 Parmetro AVS Ausente

O cdigo de segurana do carto est incorreto e no possui 3 posies, caso informado. O tamanho do nmero de pedido maior que 13 caracteres para transao do tipo IATA (39 ou 40). Algum dos campos inerentes s transaes AVS enviadas pelo mtodo GetAuthorizedAVS esta ausente (Endereo, CPF, Nmero do Endereo e CEP). Nos casos de Autorizao com AVS estes campos so obrigatrios.

ndice

Anexo D

Cdigo 31 Nmero do pedido maior que o permitido (16 posies)


O nmero do pedido maior que 16 posies.

57

Cdigo 32 Cdigo IATA invlido ou inexistente


O cdigo IATA informado no existe ou invlido.

Cdigo 33 Cdigo IATA invlido


O cdigo IATA informado invlido.

Cdigo 34 Distribuidor invlido ou inexistente


O cdigo do distribuidor invlido ou inexistente.

Cdigo 35 Problemas no cadastro do estabelecimento Cdigo 36 Operao no permitida

O IP de requisio no esta cadastrado para o respectivo estabelecimento (Filiao ou Distribuidor). Desta forma, o sistema recusa a transao. Vide cadastro dos parmetros do estabelecimento. O respectivo estabelecimento (Filiao ou Distribuidor) no esta parametrizado para efetuar transaes WebService pelo Komerci. Vide cadastro dos parmetros do estabelecimento.

Cdigo 37 Distribuidor invlido ou inexistente


O cdigo do distribuidor invlido ou inexistente.

Cdigo 38 Operao no permitida no ambiente de teste

Transaes, com valores maiores de R$ 4,00, no podem ser efetuadas em ambiente de teste.

Manual do Desenvolvedor Komerci Integrado

Cdigo 39 Operao no permitida para o cdigo IATA informado Cdigo 40 Cdigo IATA invlido ou inexistente
O cdigo IATA informado invlido ou inexistente.

A operao referente ao cdigo de transao selecionado no permitida para o cdigo IATA informado.

Cdigo 41 Problemas no cadastro do estabelecimento

O estabelecimento (Filiao ou distribuidor) no esta habilitado para executar transaes WebService no Komerci com o respectivo usurio e senha enviados como parmetro.

Cdigo 42 Problemas no cadastro do usurio do estabelecimento Cdigo 43 Problemas na autenticao do usurio Cdigo 44 Usurio incorreto para testes
Usurio incorreto para WebService de Teste. Usurio incorreto para WebService de Teste.

O estabelecimento (Filiao ou distribuidor) no esta habilitado para executar transaes WebService no Komerci com o respectivo usurio e senha enviados como parmetro. Ou usurio e senha incorretos. O estabelecimento (Filiao ou distribuidor) no esta habilitado para executar transaes WebService no Komerci com o respectivo usurio e senha enviados como parmetro. Ou usurio e senha incorretos.

Cdigo 45 Problemas no cadastro do estabelecimento para testes

ndice

Anexo D

Cdigo 56 Dados Invlidos


Este erro ocorre quando: Algum campo foi enviado com valor numrico incorreto CPF invlido Os campos de: TOTAL, TRANSACAO, PARCELAS, FILIACAO, NUMPEDIDO, BANDEIRA esto vazios ou vazios 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. O campo FILIACAO no numrico ou contem espaos ou no corresponde a uma Filiao cadastrada previamente na Redecard. O campo DISTRIBUIDOR, caso preenchido, no corresponde a um campo numrico ou contm espaos. O campo PARCELAS: No corresponde a um campo numrico 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 (na hora de repaginar acertar todas as referencias de paginas para enviar erros) 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. decimal (.), sem ponto de milhar. Ou contm espaos.

58

Manual do Desenvolvedorum campo numrico com separador Komerci Integrado O campo ENTRADA, caso informado, no corresponde a

ndice

Anexo E - Cdigos de Erro para Autorizao


Cdigo 0 50, 52, 54, 55, 57, 59, 61, 62, 64, 80, 82, 83, 84, 85, 87, 89, 90, 91, 93, 94, 95, 97, 99 51, 92, 98 66, 67, 68, 70, 71, 73, 75, 78, 79, Mensagem Transao Aprovada

59

Transao no autorizada

Estabelecimento Invlido Por favor, entre em contato com o Suporte Tcnico do Komerci para analisar os parmetros e cadastro. Transao Invlida Por favor, entre em contato com o Suporte Tcnico para analisar o seu cadastro. Refaa a transao Sua transao no pode ser concluda. Por favor, tente novamente.

53

Manual do Desenvolvedor Komerci Integrado


58, 63, 65, 69, 72, 77, 96

56, 76, 86

Problemas com o carto Por favor, verifique os dados de seu carto. Caso o erro persista, entre em contato com a central de atendimento de seu carto. Valor Invlido Verifique se o parmetro foi informado corretamente. Instituio sem comunicao - Resposta AVS Banco no pertence rede Resposta do AVS de emissores no participantes e carto Corporativo.

60 74 81

ndice

Anexo F
vAlidAo de iP
A validao de IP uma camada de segurana que garante que a transao de um determinado estabelecimento s ser efetivada se a transao for originada por um IP que est devidamente cadastrado em uma WhiteList no Portal Redecard. Caso o estabelecimento ainda no tenha efetuado seu cadastro no Portal Redecard, basta acess-lo na URL: www.redecard.com.br, clicar em Cadastre-se e preencher as informaes solicitadas at o trmino do processo. Ao final da operao, o estabelecimento dever cadastrar um cdigo de usurio e senha de acesso ao Portal Redecard. Com este usurio Portal Redecard o estabelecimento tem acesso ao Portal de Servios e deve acessar o menu Dados Cadastrais Informaes Cadastrais e clicar no cone Dados Cadastrais. Clicar na opo + inserir os respectivos IPs dos servidores origem de transaes.

60

Manual do Desenvolvedor Komerci Integrado

ndice

Anexo G
oPerAes de TesTe
As operaes para teste das WebServices esto disponveis em:

61

https://ecommerce.redecard.com.br/pos_virtual/wskomerci/cap_teste.asmx.
As respostas das operaes de teste sero aleatrias e devem ser consideradas apenas para efeito de demonstrao e teste entre as mensagens de requisio e resposta do servio. Para as operaes que possurem usurio e senha como parmetros, informar os seguintes dados:

Usurio: testews Senha: testews


Com a finalidade de testar o sistema sem a necessidade de submeter transaes reais em produo, so disponibilizadas dentro deste WebService, duas operaes especficas para auxiliar o desenvolvedor durante a fase de testes. Deve-se alterar o mtodo correspondente adicionando o complemento Tst no final do mtodo. Exemplo:

GetAuthorizedTst

Manual ConfirmTxnTst

do Desenvolvedor Komerci Integrado Substitui a operao ConfirmTxn

Substitui a operao GetAuthorized

Os mtodos disponveis para testes so: GetAuthorizedTst ConfirmTxnTst VoidTransactionTst ConfPreAuthorizationTst VoidPreAuthorizationTst VoidConfPreAuthorizationTst CouncilReportTst SalesSummTst Realiza a autorizao da transao de crdito. Realiza a captura/confirmao da transao. Realiza o estorno de transaes de crdito. Realiza a confirmao de transaes de pr-autorizao. Realiza o desfazimento de transaes de pr-autorizao. Realiza o estorno de confirmao de transaes de pr-autorizao. Realiza a extrao de relatrio de transaes. Realiza a extrao de resumo de vendas.

As operaes acima funcionam dentro do mesmo escopo das operaes descritas anteriormente, com parmetros e retornos idnticos. As mensagens de retorno sero aleatrias, de acordo com as probabilidades pr-programadas: Probabilidades na autorizao: 80% de sucesso, 20% de erros. Probabilidades na confirmao: 50% com CODRET=0, 20% com CODRET=1 e 30% nas demais mensagens.

ndice

Anexo G

62

Estas probabilidades so pr-programadas, podendo ser alteradas sem aviso prvio. Pode-se utilizar qualquer dado para o carto, como qualquer nmero, validade e portador. No haver autorizao, uma vez que as respostas so aleatrias. Porm, os dados do estabelecimento devero ser reais. As duas operaes acima disponveis so monitoradas, a fim de garantir alta disponibilidade ao webservice. Nestas operaes de teste sero aceitas, no mximo, 10 chamadas por minuto para um mesmo estabelecimento/endereo IP. Esta opo s pode ser utilizada com PV fictcio, ou seja, PV no vlido e no cadastrado REDECARD. Para este teste o IP do estabelecimento no deve estar cadastrado ou devolvemos erro de IP. O IP cadastrado quer dizer que o PV est em produo. O cadastro do IP pode ser feito via Portal.

As transaes de Desenvolvedor Komerci Integrado Manual doteste devem ser feitas at o valor de R$ 0.01

ATENO

ndice

Manual do Desenvolvedor Komerci Integrado

Você também pode gostar