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 16. HISTÓRICO DE VERSÕES... 27 Página 1 de 27 Versão 1.0 Data: 04/11/2014
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 Página 2 de 27 Versão 1.0 Data: 04/11/2014
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. Página 3 de 27 Versão 1.0 Data: 04/11/2014
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 VisualizadorTabelas.exe Visualizador de Tabelas 1.1.2.3 Página 4 de 27 Versão 1.0 Data: 04/11/2014
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. Em seguida selecione a Guia BIN, apresentando as opções abaixo: Página 5 de 27 Versão 1.0 Data: 04/11/2014
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. Após, selecionar o botão Salvar e Retornar. Página 6 de 27 Versão 1.0 Data: 04/11/2014
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. Após, selecionar o botão Salvar em seguida Retornar. Página 7 de 27 Versão 1.0 Data: 04/11/2014
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. Após selecionar o botão Salvar e Retornar; Página 8 de 27 Versão 1.0 Data: 04/11/2014
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>). Página 9 de 27 Versão 1.0 Data: 04/11/2014
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=HL Página 10 de 27 Versão 1.0 Data: 04/11/2014
9. 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á assumir o novo roteamento. e reiniciar o serviço da aplicação SiTef para 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 Configuração Bin realizada com sucesso! Página 11 de 27 Versão 1.0 Data: 04/11/2014
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. Página 12 de 27 Versão 1.0 Data: 04/11/2014
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. Atenção: As informações abaixo são apenas ilustrações de simulação (Dados Fictícios). Página 13 de 27 Versão 1.0 Data: 04/11/2014
Na guia Range, informa o range de bins e o produto associado. Na guia Bins Especiais, informa o range de bins especiais e o produto associado. Página 14 de 27 Versão 1.0 Data: 04/11/2014
Na guia Issuer, trás as informações para cada código issuer. Na guia Issuer Especiais, trás as informações para cada código issuer especial. Página 15 de 27 Versão 1.0 Data: 04/11/2014
Na guia Func. Habilitadas, informa as transações que estão habilitadas. Página 16 de 27 Versão 1.0 Data: 04/11/2014
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) Compra Crédito Parcelada com Juros (Magnético e Digitado) Página 17 de 27 Versão 1.0 Data: 04/11/2014
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. Página 18 de 27 Versão 1.0 Data: 04/11/2014
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. Ou através do menu direto de Cancelamento (função 200). Página 19 de 27 Versão 1.0 Data: 04/11/2014
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. Ou através do menu direto de Cancelamento (função 200). Página 20 de 27 Versão 1.0 Data: 04/11/2014
No momento do cancelamento é solicitado o código da autorização, o qual é informado no cupom da transação de Pré-Autorização. Página 21 de 27 Versão 1.0 Data: 04/11/2014
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. Selecionar a opção e siga com o fluxo. Página 22 de 27 Versão 1.0 Data: 04/11/2014
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. Página 23 de 27 Versão 1.0 Data: 04/11/2014
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 Página 24 de 27 Versão 1.0 Data: 04/11/2014
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. Página 25 de 27 Versão 1.0 Data: 04/11/2014
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 O mesmo terminal enviou duas transações TEF em seguida sem aguardar a andamento 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 A transação foi feita através de um client (CliSiTef, Cliente Modular, etc...) não minima suportado pelo módulo. FF Fallback nao O fallback está desabilitado por configuração, mas o módulo recebeu uma perm. 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 digitada Esta transação precisa ser digitada. Página 26 de 27 Versão 1.0 Data: 04/11/2014
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 Melhorias da versão da especificação enviada na mensagem ISO; 3.0.0.7 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; Página 27 de 27 Versão 1.0 Data: 04/11/2014