Escolar Documentos
Profissional Documentos
Cultura Documentos
Apresentao
ndice
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.
mkt
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
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;
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
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.
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
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
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.
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.
<?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
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
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).
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.
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.
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.
Tamanho 2 250
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
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
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.
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.
16
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.
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.
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.
<?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
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.
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.
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).
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.
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.
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.
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).
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.
22
Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.
Tamanho 2 250
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
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
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.
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).
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.
25
Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.
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
FiliAcAo
O parmetro FILIACAO dever conter o n de filiao do estabelecimento* cadastrado junto a Redecard.
ndice
ToTAl
O parmetro TOTAL dever conter o valor da transao realizada.
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).
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.
27
Pwd
O parmetro PWD dever conter a senha de acesso cadastrado seguindo as instrues do Anexo B.
Tamanho 2 250
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
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.
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.
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.
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.
Tamanho 2 80
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
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.
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
dATA_FinAl
O parmetro DATA_FINAL obrigatrio. Ele dever conter a data final do perodo de transaes a ser pesquisado (no formato AAAAMMDD).
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.
ndice
Relatrio de Vendas
37
<?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
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
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
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
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.
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.
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.
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
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.
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.
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.
ndice
Anexo A
Tamanho 2 200
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.
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
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
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
<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>
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.
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
56
O nmero de filiao no esta em seu formato correto. Este campo deve ser numrico e conter at 9 posies.
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.
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.
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.
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
57
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.
Transaes, com valores maiores de R$ 4,00, no podem ser efetuadas em ambiente de teste.
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.
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.
ndice
Anexo D
58
Manual do Desenvolvedorum campo numrico com separador Komerci Integrado O campo ENTRADA, caso informado, no corresponde a
ndice
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
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
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:
GetAuthorizedTst
Manual ConfirmTxnTst
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