Roteiro de Instalação e Configuração
Módulo BIN
Conteúdo
1. INTRODUÇÃO ... 2
2. DESCRIÇÃO DO NEGÓCIO ... 2
3. QUAL O TIPO DE CARTÃO ... 2
4. PRÉ REQUISITOS ... 2
5. INSTALAÇÃO DO MÓDULO ... 3
6. COMPONENTES DO MÓDULO ... 4
7. CONFIGURAÇÃO DO MÓDULO BIN NO SITEF ... 5
8. CONFIGURAÇÃO GATEWAY ... 10
9. CONFIGURAÇÃO MULTIBANDEIRA ... 11
10. CARGA DE TABELAS ... 12
11. VISUALIZADOR DE TABELAS ... 13
12. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA BIN ... 17
13. CONFIGURAÇÃO DO PONTO DE VENDA (PDV) ... 18
13.1 INTERFACE CLISITEF ... 18
13.1.1 Compra Débito / Voucher ... 18
13.1.2 Cancelamento Compra Débito / Voucher ... 18
13.1.3 Compra Crédito ... 18
13.1.4 Cancelamento Compra Crédito ... 19
13.1.5 Pré-Autorização ... 19
13.1.6 Estorno de Pré-Autorização ... 19
13.1.7 Captura de Pré-Autorização ... 20
13.1.8 Estorno de Captura de Pré-Autorização ... 20
13.2 INTERFACE CLIENT MODULAR ... 22
13.2.1 Compra Débito ... 22
13.2.2 Cancelamento Compra Débito ... 22
13.2.3 Compra Crédito ... 22
13.2.4 Cancelamento Compra Crédito ... 22
13.2.5 Pré-Autorização ... 23
13.2.6 Estorno de Pré-Autorização ... 23
13.2.7 Captura de Pré-Autorização ... 23
13.2.8 Estorno de Captura de Pré-Autorização ... 24
14. RELATÓRIOS ... 24
15. TABELA DE ERROS ... 25
1. Introdução
Este documento destina-se ao usuário que pretende instalar e configurar o módulo BIN no SiTef.
2. Descrição do Negócio
Este módulo trata transações de cartões de crédito, débito e voucher bandeirados com processamento full grade EMV.
3. Qual o Tipo de Cartão
Este módulo processa cartões bandeirados: – Visa Crédito – Mastercard Crédito – Visa Electron – Maestro – Cabal Voucher – Cabal Crédito – Cabal Débito
4. Pré Requisitos
► Interface PDV (Client Modular ou CliSiTef) com as versões mínimas:
CliSiTef versão igual ou superior a 4.0.111.19
Client Sitef Modular versão igual ou superior a 4.0.4.25
► SiTef versão igual ou superior a 3.0.18.0 ► SiTefWeb versão 03/11/2014
► Exportadores:
Expcli – Exportador Cliente versão igual ou superior a 1.12.1-1 ExServ – Exportados Servidor versão igual ou superior a 1.13.2-2
► Gateway – versão igual ou superior a 6.00.06
Link para download das versões atualizadas:
CliSiTef - Win 32 bits
https://www.softwareexpress.com.br/distri/aplicativos/clisitefwin32.zip CliSiTef – Linux https://www.softwareexpress.com.br/distri/aplicativos/linuxclisitef.zip Client Modular https://www.softwareexpress.com.br/distri/aplicativos/clientsitef.zip SiTef Produção https://www.softwareexpress.com.br/distri/aplicativos/sitef.zip
SiTefWeb e Exportadores , solicitar versões com suporte.sitefweb@softwareexpress.com.br
5. Instalação do Módulo
5.1 Backup
a) Efetuar uma cópia de backup das pastas \SiTef\CONFIG e \SiTef\APLIC.WIN
5.2 Instalação
a) Efetuar o download da versão Módulo BIN, conforme o link temporário enviado por e-mail b) Descompactar o arquivo bin.zip em uma pasta temporária, por exemplo, c:\instalacao\
c) Finalizar o serviço do SiTef - Solução Inteligente através dos serviços do Windows
d) Acessar o diretório temporário criado (c:\instalacao\), executar o programa Instala.exe e seguir os passos Next ► Finish
e) Efetuar configuração conforme item Configuração do Módulo BIN no SiTef, abaixo.
f) Em seguida ativar o serviço do SiTef - Solução Inteligente através dos serviços do Windows.
5.3 RollBack – Retorno da versão quando houver problemas
**Recomendado quando realizado atualização no mesmo dia**
Caso ocorram problemas em dias posteriores à atualização, contate nosso suporte suporte@softwareexpress.com.br (11) 3170-5353, para ser orientado com as instruções corretas.
a) Renomear a pasta \\sitef\config\ para \config_BIN_erro b) Renomear a pasta \\sitef\aplic.win para \aplic.win_BIN_erro
c) Voltar as pastas backupeadas no item 6.1 Backup -> a) \SiTef\CONFIG e \SiTef\APLIC.WIN para o mesmo diretório \sitef\
6. Componentes do Módulo
NOME DESCRIÇÃO VERSÃO MÍNIMA
Carga_Tabelas.exe Carga de Tabelas 1.2.2.0
CfSiTef.exe Configurador do SiTef 1.1.3.9
CnfMultibandeiras.exe Configurador Multibandeira 1.1.0.5
Drvcom.exe Driver de Comunicação 4.0.0.40
Gerpdv.exe Gerenciador de PDV’s 4.0.0.34
sitbin.exe Módulo do SiTef 3.0.0.7
SiTefRel.exe Relatório do SiTef 0.0.12.14
SeBIN.bpl Biblioteca de configuração 0.0.0.0
7. Configuração do Módulo BIN no SiTef
A configuração do módulo BIN é feita através do Configurador Geral do SiTef.
Acessar o menu Iniciar Programas SiTef Menu Principal Configurador Geral do SiTef
O instalador valida a informação *Ultima versão* no regedit.exe (Editor de registro do Windows) Software Software Express Informática Ltda SiTef , qual a ultima versão instalada, onde:
Se versão 3.0.x.x será instalado o arquivo \sitef\aplic.win\cfsitef.exe sem controle de acesso usuário Windows.
Ex: Configurador Geral do SiTef sem controle de usuário do Windows:
Usuário: Informar o código de acesso que deve ser o mesmo usado no acesso à máquina com permissão de
administrador.
Senha: Informar a senha do usuário com permissão de administrador.
Se versão 4.0.x.x, será instalado o arquivo \sitef\aplic.win\cfsitef.exe com controle de acesso usuário do Windows, onde precisa dos usuário cadastrados no grupo SiTef-Adm e SiTef-Rel do Windows.
Na guia BIN ► Estabelecimento, configurar:
Empresa: Selecione a empresa desejada no qual deseja configurar.
Caso SiTef esteja configurado como monoempresa a empresa utilizada é a 00000000, não permitindo selecionar outra empresa.
Código de Estabelecimento: Informar o código de estabelecimento fornecido pela administradora BIN,
tamanho de 15 dígitos.
Terminal Virtual: Informar o código do terminal para o autorizador BIN, tamanho de 08 dígitos.
Na guia BIN ► Comunicação, configurar:
A configuração de comunicação é padrão do SiTef. O sistema foi homologado utilizando TCP/IP. Para a utilização em produção de outro protocolo, será necessário validar a comunicação.
Selecionar a Interface Host utilizada: Se Interface Host – TCPIP/Direto
Endereço IP Primário: Informar o endereço IP de destino Porta TCP: Informar a porta TCP de destino
Formato do Tamanho:
► Se a comunicação for através do Gateway, selecionar a opção Binário (Low High).
► Se a comunicação for direta com a BIN , verificar com o Autorizador o tipo de formato mensagem
esperado.
Configuração Geral- Habilita Sitef-Gw: Selecionar esta opção se o seu ambiente utiliza o gateway de
comunicação SiTef-GW utilizando VPN com as provedoras homologadas.
Caso tenha duas conexões IP, sendo uma primária e a outra secundária, efetuar a mesma configuração com os dados da conexão secundária.
Se Interface Host – Roteador Cyclades ou Aligera ou Cisco RBP
Endereço IP Primário: Informar o endereço IP do roteador
Porta TCP: Informar a porta “socket” onde foi configurado o X25 da BIN no roteador.
Caso tenha dois roteadores sendo um primário e o outro secundário efetuar a mesma configuração com os dados do roteador secundário.
Se Interface Host – Eicon ou NetOpen
Endereço Local: Informar o número da sua X25
Endereço Remoto: Informar o número da X25 da BIN (fornecido pela administradora) User Data: Informar o User Data da BIN (fornecido pela administradora)
Obs: Se o lojista possui um link X.25 de uma determinada operadora de telefonia que não seja a mesma
operadora na qual deseja se conectar, deve-se observar o prefixo da operadora da “nuvem destino”. Exemplos:
Um lojista possui um link Telemar (OI) e as redes adquirentes lhe passaram um endereço RenPac (Embratel), logo a “nuvem destino” será Embratel e portanto, o prefixo a ser inserido antes do numero X.25 (DTE Address) será “0724” (0724+<DTE Address>).
Um lojista possui um link RenPac (Embratel) e as redes adquirentes lhe passaram um endereço SPPac (Telefônica), logo a “nuvem destino” será a da Telefônica e portanto, o prefixo a ser inserido antes do numero X.25 (DTE Address) será “0725” (0725+<DTE Address>).
Já para “nuvem destino” Telemar (OI) o prefixo a ser inserido antes do numero X.25 será “07243” (07243+<DTE Address>).
Envia Endereço Local: Não precisa selecionar (à menos que este parâmetro não seja de envio default pela
Operadora do Link X25).
Canal da Placa: (PLACA MODEM)
Canal 0: Selecionar a opção Canal 0 se a placa estiver no PORT0
Canal 1: Selecionar a opção Canal 1 se a placa estiver no PORT1
Depois de configurado, pressione o botão , em seguida .
Configuração BIN realizada com sucesso!
8. Configuração Gateway
Se a comunicação for através do Gateway, utilizar a versão mínima 6.00.06 e a configuração
descrita abaixo:
[Geral] Habilitada=S Nome=22013:Bin TempoMaximoFila=30 IntervaloTransmissao=0 FazLogMsg=S DriveDirLog=c:\gw\log Canais=1 Alertas=0 Ebcdic=N PreAmbulo=10 MascaraChave=000000000000000 CodigoLog=13 TipoMensagem=ISO8583_1987 QtdeMsg=20 [CANAL_1] Tipo=2 Tratamento=1 EnderecoIp=189.2.6.194 Porta=51024 FormatoInfoTam=HL9. Configuração MultiBandeira
Neste item mostraremos como realizar o roteamento dos cartões bandeirados para autorização junto à adquirente BIN.
Pelo menu Iniciar ► Programas ► ► , selecione a
empresa a ser configurada, ou opte por uma configuração padrão para todas as empresas/lojas do servidor, segue:
Na sequência, escolher a Bandeira do cartão e na coluna Autorizador, marcar a opção desejada.
A configuração deve ser feita para cada bandeira. Na coluna, Autorizador, clique no combobox e escolha qual será a rede adquirente que irá processar a bandeira em questão.
Veja o exemplo abaixo:
ATENÇÃO 1: Certifique com o autorizador BIN quais as bandeiras de cartões são autorizadas para roteamento multibandeira. A informação acima serve apenas de EXEMPLO.
ATENÇÃO 2: Renomear os arquivos \sitef\config\Tbins e Tcred.cnf para .old, assim serão criados dois novos arquivos sem quaisquer roteamento.
Após as alterações acima, deverá e reiniciar o serviço da aplicação “SiTef” para assumir o novo roteamento.
Caso a opção BIN não apareça na coluna Autorizador, verificar no arquivo \sitef\config\basemultibandeira.ini se contem o valor abaixo:
[Autorizadores] Bin=229
10.
Carga de Tabelas
Na primeira inicialização que o SiTef faz com o autorizador Bin, o SiTef enviará uma solicitação de carga. Se houver necessidade de realizar uma nova carga de tabelas forçada, utilize o aplicativo Carga de
Tabelas conforme abaixo:
Acesse o menu, , Iniciar ► Programas ► ► selecionando a lojas/estabelecimentos cadastrado no Sitef, observe:
Bin: executar duplo na opção Carga
Empresa: selecionar cada empresa antes de clicar
No campo Status, apresentará o status da carga de tabelas, se concluído com sucesso a mensagem apresentada é “Transação OK”.
11.
Visualizador de Tabelas
Este aplicativo permite apenas visualizar os dados que desceram na tabela do autorizador Bin.
Qualquer alteração se faz necessário solicitar junto ao fornecedor de fidelidade e após realizar uma carga de tabelas.
Para consultar o que desceu na tabela, acesse o menu Iniciar ► Programas ►
► onde é possível visualizar o conteúdo da tabela.
Na guia Bin Estabelecimento, informa dados do estabelecimento.
Na guia Range, informa o range de bins e o produto associado.
Na guia Issuer, trás as informações para cada código issuer.
12.
Transações Permitidas junto a Administradora BIN
TRANSAÇÕES CARTÃO
Pré-Autorização (Magnético e Digitado)
Captura de Pré-Autorização à Vista e Parcelada Sem Juros Estorno da Pré-Autorização
Estorno da Captura de Pré-Autorização Compra Débito / Voucher à Vista (Magnético) Estorno de Compra Débito e Voucher
Compra Crédito à Vista (Magnético e Digitado)
Compra Crédito Parcelada Sem Juros (Magnético e Digitado) Estorno de Compra Crédito (Magnético e Digitado)
13.
Configuração do Ponto de venda (PDV)
13.1 Interface CliSitef
13.1.1 Compra Débito / Voucher
Não há parâmetros para serem configurados.
Essa transação está disponível no menu de Pagamentos (função 0). Selecione a forma de pagamento Cartão de Débito e siga com o fluxo.
13.1.2 Cancelamento Compra Débito / Voucher
Não há parâmetros para serem configurados.
Pode ser realizado através do menu Administrativo (função 110). Selecionar a opção Cancelamento de Transação e siga com o fluxo.
Ou através do menu de Cancelamento (função 200).
13.1.3 Compra Crédito
Não há parâmetros para serem configurados.
Essa transação está disponível no menu de Pagamentos (função 0). Selecionar a forma de pagamento Cartão de Crédito e siga com o fluxo.
13.1.4 Cancelamento Compra Crédito
Não há parâmetros para serem configurados.
Pode ser realizado através do menu Administrativo (função 110). Selecionar a opção Cancelamento de Transação e siga com o fluxo.
Ou através do menu de Cancelamento (função 200).
13.1.5 Pré-Autorização
Não há parâmetros para serem configurados.
Essa transação está disponível no menu Administrativo (função 110). Selecione a opção Pré-autorização e seguir com o fluxo.
13.1.6 Estorno de Pré-Autorização
Não há parâmetros para serem configurados.
Pode ser realizado através do menu Administrativo (função 110).
Selecionar a opção Cancelamento de Transação, em seguida selecionar a opção de
Cancelamento de Pré-autorização e seguir com o fluxo.
No momento do cancelamento é solicitado o código da autorização, o qual é informado no cupom da transação de Pré-Autorização.
13.1.7 Captura de Pré-Autorização
Não há parâmetros para serem configurados.
Essa transação está disponível no menu de Pagamentos (função 0).
Selecione a forma de pagamento Confirmação de Pré-autorização e siga com o fluxo.
No momento da captura de pré-autorização é solicitado o código da autorização, o qual é informado no cupom da transação de Pré-Autorização.
13.1.8 Estorno de Captura de Pré-Autorização
Não há parâmetros para serem configurados.
Pode ser realizado através do menu Administrativo (função 110).
Selecionar a opção Cancelamento de Transação, em seguida selecionar a opção de
Cancelamento de Confirmação de Pré-autorização e seguir com o fluxo.
No momento do cancelamento é solicitado o código da autorização, o qual é informado no cupom da transação de Pré-Autorização.
13.2 Interface Client Modular
13.2.1 Compra Débito / Voucher
Não há configurações adicionais.
Essa transação está disponível no menu de Pagamentos (função CRT).
Selecionar a opção e siga com o fluxo.
13.2.2 Cancelamento Compra Débito / Voucher
Não há configurações adicionais.
Essa transação está disponível no menu de transações administrativas (função ADM).
Clicar no botão .
Selecionar a opção e siga com o fluxo.
13.2.3 Compra Crédito
Não há configurações adicionais.
Essa transação está disponível no menu de Pagamentos (função CRT).
Selecionar a opção e siga com o fluxo.
13.2.4 Cancelamento Compra Crédito
Não há configurações adicionais.
Essa transação está disponível no menu de transações administrativas (função ADM).
Clicar no botão .
13.2.5 Pré-Autorização
Não há configurações adicionais.
Essa transação está disponível no menu de Pré-Autorização de Cartão de Crédito (função PRE).
Selecionar a opção e siga com o fluxo.
13.2.6 Estorno de Pré-Autorização
Não há configurações adicionais.
Essa transação está disponível no menu de funções administrativas (função ADM).
Clicar no botão .
Selecionar a opção .
Após selecione e siga com o fluxo.
No momento do cancelamento é solicitado o código da pré-autorização, o qual é informado no cupom da transação de Pré-Autorização.
13.2.7 Captura de Pré-Autorização
Não há configurações adicionais.
Essa transação está disponível no menu de Pré-Autorização de Cartão de Crédito (função PRE).
Selecionar a opção ,
ou e siga com o fluxo.
No momento da captura de pré-autorização é solicitado o código da pré-autorização, o qual é informado no cupom da transação de Pré-Autorização.
13.2.8 Estorno de Captura de Pré-Autorização
Não há configurações adicionais.
Essa transação está disponível no menu de funções administrativas (função ADM).
Clicar no botão .
Selecionar a opção .
Após selecione e siga com o fluxo.
No momento do cancelamento é solicitado o código da pré-autorização, o qual é informado no cupom da transação de Pré-Autorização.
14.
Relatórios
Para listar as transações utilizar o Relatório do Sitef, através do menu Iniciar ► Programas ►
►
Tipo de Log: log_mmdd.dat Versão Mínima: 0.0.12.14
15.
Tabela de Erros
Mensagens do Autorizador
Código Display Descrição
00 Transação OK A transação foi aprovada pelo autorizador 03 Invalid merchant Estabelecimento não cadastrado.
04 Capture card Problemas com o cartão.
05 Declined A transação foi negada pelo autorizador. 12 Invalid transaction Transação inválida para o autorizador. 22 Invalid installments Número de parcelas inválido.
24 Manual entry not allowed Transações digitadas não permitidas. 70 Denied, call issuer Transação negada EMV.
Mensagens do TEF
Código Display Descrição
00 Transacao OK Transação que foi aprovada pelo TEF. TM Servico indisp. A transação caiu por timeout.
S0 Servico indisp. Sem conexão com o autorizador.
S2 Subtrn. indef. O TEF recebeu uma subtransação desconhecida. S2 Trn. Indefinida O TEF recebeu uma transação desconhecida.
S3 DOC nao existe A transação original não foi encontrada na Log do SiTef com o estado correto. S4 AID chip ausente O AID do chip não foi recebido.
S4 Campo invalido Algum campo previsto na interface PDV está ausente. S4 Cartao invalido O cartão não possui um formato válido.
S4 CNPJ invalido O CNPJ está mal formatado.
S4 Cod. autent. inv. O código de autenticação é inválido. S4 Cod.autoriz. inv. O código de autorização é inválido. S4 CPF invalido O CPF está mal formatado.
S4 Dados inválidos Dado genérico com formato inválido. S4 Data invalida Alguma data fornecida ao módulo é inválida. S4 Data venc. inv. A data de vencimento é inválida.
S4 Exige CVC2 A transação exige a captura de código de segurança, mas o mesmo estava ausente. S4 Operac. invalida A operação selecionada não é esperada para a transação.
S4 Parc. invalidas Número de parcelas inválido. S4 Senha invalida A senha é inválida.
S4 Tipo p. invalido O tipo de parcelamento não é esperado para a transação. S4 Trilha2 invalida O dado recebido não corresponde à uma trilha2 válida. S4 Valor invalido O valor da transação é inválido.
S5 Nao existe conf. A empresa não está configurada corretamente para este módulo.
S6 Tamanho invalido Algum dado recebido do PDV não seguiu o tamanho definido na interface PDV.
S7 Dados inconsist. Algum dado recebido do PDV não seguiu o formato definido na interface PDV ou quebrou o layout ISO-8583.
S8 Senha bloqueada A senha está bloqueada. S8 Senha invalida A senha não está correta.
V1 Campo indefinido O bit ISO-8583 não está presente na transação. V2 Estabel. indef. Falha na montagem do bit 42.
V3 CPF/CGC
invalido CPF com formato inválido.
V6 Cartao vencido Data de vencimento do cartão já expirou.
V7 Trn em andamento
O mesmo terminal enviou duas transações TEF em seguida sem aguardar a conclusão da primeira.
FF AID 9F06 ausente O chip não devolveu a tag 9F06 na 1st Generate AC mesmo quando solicitado.
FF AidChip Ausente A transação não recebeu o AID após a chamada da PP_getCard( ) da biblioteca compartilhada.
FF Carga bloqueada Devolvido se a empresa está com a carga bloqueada.
FF Carga em andam. Módulo recebeu uma transação de carga de tabelas quando a empresa já estava executando uma carga.
FF Emissor invalido Produto (card issuer) não tratado pelo módulo. FF Erro desconhec. Erro que não foi mapeado no módulo.
FF Exige interface minima
A transação foi feita através de um client (CliSiTef, Cliente Modular, etc...) não suportado pelo módulo.
FF Fallback nao perm.
O fallback está desabilitado por configuração, mas o módulo recebeu uma transação de fallback.
FF Transacao negada Transação negada pelo autorizador que não veio com uma mensagem descrevendo o erro.
FF Trn. duplicada O módulo recebeu duas transações de registro com o mesmo ID sequencial. Provavelmente é falha da automação comercial.
FF Trn dig nao perm Esta transação não pode ser digitada.
FF Trn. deve ser
16.
Histórico de Versões
VERSÃO ALTERAÇÃO
3.0.0.1 Versão Inicial do Módulo
3.0.0.2 Melhorias nos cupons
3.0.0.3 Alterações do tratamento de tags EMV
3.0.0.4 Melhorias do tratamento dado à mensagens negados pelo autorizador
3.0.0.5 Inclusão do tratamento dos produtos vouchers, crédito e débito da bandeira Cabal
3.0.0.6 Alterações nos cupons
3.0.0.7
Melhorias da versão da especificação enviada na mensagem ISO;
Exibição do saldo disponível quando uma transação de voucher é negada;
Alterações nas transações de captura de pré-autorização para que a senha deixe de ser solicitada;
