DmCard - Guia de Instalação

Roteiro de Instalação e Configuração
Módulo DmCard
Para segurança de seu ambiente, consulte sempre o documento Guia de Implementação SiTef PCI que pode
ser encontrado na pasta de instalação do SiTef ou no link
https://www.softwareexpress.com.br/distri/aplicativos/GuiaImplementacaoSiTefPCI.zip. Ele contém as
orientações de configurações do seu servidor SiTef para atender as regras do PCI PA-DSS.
Conteúdo
1. INTRODUÇÃO ........................................................................................................................................ 3
2. DESCRIÇÃO DO NEGÓCIO ................................................................................................................ 3
3. PRÉ-REQUISITOS ................................................................................................................................. 3
4. INSTALAÇÃO DO MÓDULO DMCARD ............................................................................................ 4
4.1 BACKUP................................................................................................................................................... 4
4.2 INSTALAÇÃO ............................................................................................................................................ 4
4.3 ROLLBACK .............................................................................................................................................. 4
5. COMPONENTES DO MÓDULO .......................................................................................................... 5
6. CONFIGURAÇÃO DO MÓDULO DMCARD NO SITEF/SITDEMO ............................................... 6
7. RELATÓRIOS ....................................................................................................................................... 11
8. SITEFWEB............................................................................................................................................. 12
9. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA DMCARD ................................ 13
10. CONFIGURAÇÃO DO PONTO DE VENDA (PDV) ........................................................................ 14
10.1 INTERFACE CLISITEF.............................................................................................................................. 14
10.1.1 Venda Crédito (magnético e digitado) ............................................................................................... 14
10.1.2 Cancelamento Venda Crédito (magnético e digitado) ................................................................... 14
10.1.3 Consulta Saldo Credito (magnético e digitado) .............................................................................. 14
10.1.4 Consulta Parcelas Crédito (magnético e digitado) ........................................................................ 15
10.1.5 Consulta Credito Pré-Aprovado .......................................................................................................... 15
10.1.6 Pagamento de Fatura ............................................................................................................................. 15
10.1.7 Cancelamento de Pagamento de Fatura ........................................................................................... 16
10.1.8 Resgate de Vale Compra de Fidelidade .............................................. Erro! Indicador não definido.
10.1.9 Resgate de Pontos de Fidelidade ......................................................... Erro! Indicador não definido.
10.2 INTERFACE CLIENT MODULAR ................................................................................................................. 16
10.2.1 Venda Crédito (Magnética e Digitada) ............................................................................................... 16
10.2.2 Cancelamento Venda Crédito (Magnética e Digitada) ................................................................... 16
10.2.3 Consulta Saldo Credito (magnético e digitado) .............................................................................. 17
10.2.4 Consulta Parcelas Crédito (magnético e digitado) ........................................................................ 17
10.2.5 Consulta Credito Pré Aprovado .......................................................................................................... 17
10.2.6 Pagamento de Fatura (magnético e digitado).................................................................................. 18
10.2.7 Cancelamento de Pagamento de Fatura (magnético e digitado) ................................................ 18
10.2.8 Resgate de Vale Compra de Fidelidade .............................................. Erro! Indicador não definido.
10.2.9 Resgate de Pontos de Fidelidade ......................................................... Erro! Indicador não definido.
11. TABELA DE CÓDIGOS DE RETORNO DA ADMINISTRADORA. ............................................. 19
12. INFORMAÇÕES GERAIS ................................................................................................................... 20
13. HISTÓRICO DE VERSÕES ................................................................................................................ 20
Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Página 2 de 21 Versão 2.2 Data: 23/11/2017
1. Introdução
Este documento destina-se ao usuário que pretende instalar e configurar o módulo DmCard no SiTef 5, SiTef
6 ou no SitDemo 6.
2. Descrição do Negócio
O autorizador DMCard processa cartões de crédito à vista ou parcelada, consulta saldo crédito, consulta
plano de pagamento, consulta crédito pré-aprovado e pagamento de fatura.
3. Pré-Requisitos
Abaixo apresentamos as versões mínimas das interfaces, conforme a versão do SiTef ou SitDemo utilizada:
Versão mínima para Versão mínima para Versão mínima para

Nome
o SiTef 5 o SiTef 6 o SitDemo 6
Client Modular 4.0.6.4 6.1.2.38P 6.0.0.0
CliSiTef 4.0.112.23 r1 6.1.114.14.r2 6.0.114.0S
As interfaces dos PDV’s somente são compatíveis com a versões específicas do SiTef/SitDemo informadas
acima.
Link para download das versões atualizadas:
Versões para serem utilizadas com o SiTef 5
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
Versões para serem utilizadas com o SiTef 6
CliSiTef – Win 32 bits https://www.softwareexpress.com.br/distri/aplicativos/vrs6/clisitefwin32.zip
CliSiTef Linux https://www.softwareexpress.com.br/distri/aplicativos/vrs6/linuxclisitef.zip
Client Modular https://www.softwareexpress.com.br/distri/aplicativos/vrs6/clientsitef.zip

Versões para serem utilizadas com o SitDemo 6
CliSiTef – Win 32 bits https://www.softwareexpress.com.br/distri/aplicativos/simulado/clisitefwin32.zip
CliSiTef Linux https://www.softwareexpress.com.br/distri/aplicativos/simulado/linuxclisitef.zip
Client Modular https://www.softwareexpress.com.br/distri/aplicativos/simulado/clientsitef.zip
4. Instalação do Módulo DmCard
4.1 Backup
a) Efetuar uma cópia de backup das pastas \SiTef\CONFIG e \SiTef\APLIC.WIN
4.2 Instalação
a) Descompactar o módulo em uma pasta temporária, por exemplo C:\Instalacao\
b) Acessar o diretório temporário criado (C:\Instalacao), executar o programa Instala.exe e seguir os
passos Next ► Finish
c) Efetuar a configuração conforme item “Configuração do Módulo” abaixo.
Observações:
 Se a instalação estiver sendo realizada em ambiente de Produção, antes de iniciar o procedimento,

é necessário parar o serviço do SiTef - Solução Inteligente através dos serviços do Windows, e
após concluída a configuração, ativar novamente.
 Se a instalação estiver sendo realizada em ambiente Simulado, antes de iniciar o procedimento, é

necessário fechar o Console do Controle Geral, e após concluída a configuração, iniciar novamente
o SitDemo.
4.3 RollBack
a) Renomear a pasta \SiTef\Config\ para \Config_DmCard
b) Renomear a pasta \SiTef\Aplic.win para \Aplic.win_DmCard
c) Voltar as pastas que foram feitas backup no item 4.1 Backup ► \SiTef\CONFIG e
\SiTef\APLIC.WIN para o mesmo diretório \SiTef\

5. Componentes do Módulo
Componentes do módulo para instalação no SiTef 5
Nome Descrição Versão Mínima
DrvCom.exe Driver de Comunicação 5.0.1.24
Gerpdv.exe Gerenciador de PDV’s 5.0.0.30
Sitdmcard.exe Módulo DmCard 5.0.0.12
Componentes do módulo para instalação no SiTef 6
DrvCom-p.exe Driver de Comunicação 6.1.1.24
Gerpdv-p.exe Gerenciador de PDV’s 6.1.0.30
Sitdmcard-p.exe Módulo DmCard 6.1.0.12
Componentes do módulo para instalação no SitDemo 6
Gerpdv-s.exe Gerenciador de PDV’s 6.1.3.30
Sitdmcard-s.exe Módulo DmCard 6.1.0.12
simcomu-s.exe Simulador de Comunicação 6.1.1.103

6. Configuração do Módulo DmCard no SiTef/SitDemo
Acessar o menu Iniciar ► Programas ►
SiTef Produção: ►
SiTef Simulado: ►
Em seguida selecione a guia DMCard, serão apresentadas as opções abaixo:
Na guia Estabelecimento, configurar:
Empresa: Selecione a empresa no qual deseja configurar. Caso o SiTef esteja configurado como
monoempresa a empresa utilizada é a 00000000, não permitindo selecionar outra empresa.

Código de Estabelecimento:
SiTef Produção: Informar o código da loja fornecido pela DmCard.
SiTef Simulado: Informar um código de estabelecimento fictício. Por Exemplo: 11111111111111.
Depois de configurado, pressione o botão , em seguida .
Na guia Tabela Bins, configurar:
Empresa: Selecionar qual empresa deseja configurar. Se a configuração for igual para todas, selecionar a
opção Todas. Caso contrário à configuração será feita por empresa.
Bin ou Intervalo de Bins: Efetuar o cadastro de Bins, informando o número do BIN do cartão (6 a 9 primeiros
números do cartão) fornecido pela DMCard, e de acordo com a preferência do estabelecimento selecionar a
opção .
Após configuração dos Bin, conforme orientação da Administradora DMCard, pressionar a seta para
inserir os mesmos.

Na guia Transações Habilitadas, configurar:
Empresa: Selecione a empresa no qual deseja configurar. Caso o SiTef esteja configurado como
monoempresa a empresa utilizada é a 00000000, não permitindo selecionar outra empresa.
Na aba Crédito, selecionar as opções que o estabelecimento irá transacionar.

Na guia Comunicação, configurar a interface utilizada para comunicação com o autorizador.
SiTef Produção:
 Caso a interface utilizada seja roteador (Cylades, Aligera ou Cisco RBP) deve-se configurar o IP e
Porta do roteador onde foram configurados os dados de conexão fornecidos pela DmCard.
 Caso a interface utilizada seja placa (Eicon ou NetOpen) deve-se configurar os dados de conexão
fornecidos pela DmCard (DTE e UserData) e em qual canal a placa está conectada.
 Caso a interface utilizada seja TCPIP/Direto, realizar a configuração conforme informado abaixo:
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 TCP/IP direto com a autorizadora DmCard, selecionar a opção ASCII 4.
 Se a comunicação for com o Gateway, configurar ASCII 4.
Configuração Geral: Selecionar as opções SiTef-GW e S.E (essas opções devem ser marcadas
quando a comunicação está sendo apontada para a Software Express).

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.
SiTef Simulado:
 Por se tratar de um ambiente Simulado, os dados de comunicação são dados fictícios, não
havendo a comunicação real com o Host/Autorizador, quem responde a comunicação é um
simulador interno.
Dessa forma pode ser utilizada qualquer interface, informando dados fictícios, por exemplo:
Endereço IP Primário: Informar um endereço IP fictício, exemplo 1.2.3.4

Porta TCP: Informar uma porta “socket” fictícia, por exemplo 7001.
Ao retornar para a tela do configurador, selecionar a opção Arquivo – Sair.
Configuração DmCard realizada com sucesso!

7. Relatórios
Para listar as transações utilizar o Relatório do SiTef, através do menu Iniciar ► Programas ►
SiTef Produção: ►
SiTef Simulado: ►
Tipo de Log: log_mmdd.dat



8. SiTefWeb
Abaixo apresentamos as versões mínimas das aplicações para usuários do SiTefWeb:
SitefWeb Aplicativo SiTefWeb 9083
ExpCli Exportador Cliente 1.13.1-1
ExpServ Exportador Servidor 1.13.5-3

9. Transações Permitidas junto a Administradora DmCard
DESCRIÇÃO
Compra Crédito à Vista Magnética
Compra Crédito à Vista Digitada
Compra Crédito Parcelado Sem Juros Magnético
Compra Crédito Parcelado Sem Juros Digitado
Compra Crédito Parcelado Com Juros Magnético
Compra Crédito Parcelado Com Juros Digitado
Cancelamento Compra Crédito Magnético
Cancelamento Compra Crédito Digitado
Consulta Saldo Crédito
Consulta Parcelas
Consulta Crédito Pré-Aprovado
Pagamento de Faturas
Cancelamento Pagamento de Faturas

10. Configuração do Ponto de venda (PDV)
10.1 Interface CliSiTef

Importante: Verificar se a CliSiTef utilizada é compatível com o SiTef/SitDemo que será utilizado,
conforme descrito no item 4.Pré-Requisitos.
10.1.1 Venda Crédito (magnético e digitado)

Não há parâmetros para serem configurados.
Essa transação está disponível no menu de Pagamentos (função 0).
10.1.2 Cancelamento Venda Crédito (magnético e digitado)

Pode ser realizado através do menu Administrativo (função 110).
Selecionar a opção Cancelamento de Transação.
Ou através do menu de Cancelamento (função 200).
10.1.3 Consulta Saldo Credito (magnético e digitado)

Essa transação está disponível no menu Administrativo (função 110).
Selecionar a opção Consulta Saldo Crédito e seguir com o fluxo.

10.1.4 Consulta Parcelas Crédito (magnético e digitado)
Editar o arquivo CliSiTef.ini com os seguintes parâmetros:
[Geral]
TransacoesAdicionaisHabilitadas=3480
Essa transação está disponível no menu Administrativo (função 110).

Selecionar a opção Consulta parcelas credito e seguir com o fluxo.
10.1.5 Consulta Credito Pré-Aprovado

[Geral]
Essa transação está disponível no menu Administrativo (função 110)

Selecionar a opção Consulta Crédito Pré Aprovado e seguir com o fluxo.
10.1.6 Pagamento de Fatura

[Geral]
Essa transação está disponível no menu Pagamento de Contas (função 310).

Selecionar a opção Pagamento de Fatura e seguir com o fluxo.

10.1.7 Cancelamento de Pagamento de Fatura
[Geral]
Essa transação está disponível no menu Pagamento de Contas (função 310).

Selecionar a opção Cancelamento Pagamento de Fatura e seguir com o fluxo.
10.2 Interface Client Modular

Importante: Verificar se o Client Modular utilizado é compatível com o SiTef/SitDemo que será
utilizado, conforme descrito no item 4.Pré-Requisitos.
10.2.1 Venda Crédito (Magnética e Digitada)

Essa transação está disponível no menu de Pagamentos (função CRT).
Selecionar e seguir com o fluxo.
10.2.2 Cancelamento Venda Crédito (Magnética e Digitada)

Pode ser realizado através do menu Administrativo (função ADM), ou através do menu de
Cancelamento (função CNC).
Selecionar a opção
Em seguida, escolher e seguir com o fluxo.

10.2.3 Consulta Saldo Credito (magnético e digitado)
Essa transação está disponível no menu Administrativo (função ADM).
Em seguida, escolher
Será exibida a opção e seguir com o fluxo.
10.2.4 Consulta Parcelas Crédito (magnético e digitado)

Em seguida, escolher
Será exibida a opção e seguir com o fluxo.
10.2.5 Consulta Credito Pré Aprovado

Para realizar esta transação, o arquivo IntPos.001 deve conter o Header com o formato abaixo:
000-000 = CONSCRED
Observação: Para a transação de consulta de crédito pré-aprovado não será disponibilizado

comprovante. O campo status da transação (009-000) indica se há crédito pré-aprovado
(status = 0) ou não (status diferente de zero).
Exemplo de IntPos.001 de Solicitação da transação:
000-000 = CONSCRED Header

001-000 = 1 Identificação
003-000 = 15000 Valor da transação
007-000 = 11111111111 CPF
999-999 = 0 Trailler – Registro Final
A seguir confirmar o Valor e o número do CPF conforme tela abaixo:

10.2.6 Pagamento de Fatura (magnético e digitado)
Configurar no arquivo \Client\ClienteTrn.ini os parâmetros abaixo:
[BOTOES_HABILITADOS]
btPagtoFatura=1
10.2.7 Cancelamento de Pagamento de Fatura (magnético e digitado)

Configurar no arquivo \Client\ClienteTrn.ini os parâmetros abaixo:
[BOTOES_HABILITADOS]
btPagtoFatura=1
Pode ser realizado através do menu Administrativo (função ADM), ou através do menu de
Cancelamento (função CNC).

11. Tabela de códigos de retorno da Administradora.
CÓDIGO DESCRIÇÃO
01 Operação com sucesso OK
02 Excedeu limite
03 Cartão bloqueado
04 Cartão cancelado, retê-lo
05 Suspenso
06 Cancelamento não efetuado
07 Inconsistência
08 Número de autorização inválida
09 Não concluída a operação
10 Número de parcelas inválido
11 Número do cartão inválido
12 Código do estabelecimento inválido
13 Layout ou versão incompatível
14 Tipo da venda inválido
15 Estabelecimento suspenso ou cancelado
16 Estabelecimento não autorizado para este convênio
17 Sem comunicação
18 Erro interno
19 Valor de cancelamento inválido
20 Senha Inválida
21 Autorização ainda não confirmada
22 Operadora não habilitada para esse serviço
23 Autorização não existe
24 Cartão vencido
25 Horário Inválido (Autorização não permitida neste horário)
26 Transação não autorizada
27 Excedeu quantidade de saques diários

28 Excedeu limite de saque diário
29 Valor da transação inválido
30 Valor da parcela abaixo do mínimo
31 Transação duplicada
32 Acordo de cobrança em andamento
33 Cartão Provisório – venda somente pelo Site
34 Cartão Provisório – validade vencida
35 Valor da parcela excede comprometimento de renda máximo
99 Servidor em manutenção, tente mais tarde
12. Informações Gerais
Extensão da audit: 266

Extensão da Log: .dat
Porta Gateway (Produção): 22129
13. Histórico de Versões
Versão Alteração
5.0.0.0 Inclusão das funções para o módulo ser assinado – Módulo assinado
5.0.0.1 Correção no arquivo resources.rc, sobre a assinatura
5.0.0.2 Correção – Não verificava quando a configuração dos bins era por range.
5.0.0.3 Correção na leitura dos bins.
Inclusão do Serviço Q029 para enviar a informação do BIT 91 (Trn. Consulta de

5.0.0.4
Crédito Pré-Aprovado).
Correção na abertura de empresa quando não há bins configurados.

5.0.0.5
Primeira versão com a variante SiTef 6 Simulado
Correção na montagem do serviço ‘y’.

5.0.0.6
TRAC: #25010
O módulo não estava reservando espaço suficiente para o tratamento de

5.0.0.7
mensagens de display maiores que 50 caracteres (Trac #25451).

5.0.0.8 DMCard: Ajustando o tamanho dos bins para 19
Inserido softex-00-dmcard.h para o DMCard produção.

5.0.0.9
Alterado VERSAO_RELEASE 0,9
5.0.0.11 Inclusão da configuração de BINs por empresa
x.x.0.12 Melhorias na transação ‘Consulta Crédito Pré-Aprovado’


DmCard - Guia de Instalação

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

DmCard - Guia de Instalação

Enviado por

Direitos autorais:

Formatos disponíveis

Roteiro de Instalação e Configuração

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Versão mínima para Versão mínima para Versão mínima para

Client Modular 4.0.6.4 6.1.2.38P 6.0.0.0

CliSiTef 4.0.112.23 r1 6.1.114.14.r2 6.0.114.0S

Link para download das versões atualizadas:

Versões para serem utilizadas com o SiTef 5

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

Versões para serem utilizadas com o SiTef 6

CliSiTef – Win 32 bits https://www.softwareexpress.com.br/distri/aplicativos/vrs6/clisitefwin32.zip

CliSiTef Linux https://www.softwareexpress.com.br/distri/aplicativos/vrs6/linuxclisitef.zip

Client Modular https://www.softwareexpress.com.br/distri/aplicativos/vrs6/clientsitef.zip

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

CliSiTef – Win 32 bits https://www.softwareexpress.com.br/distri/aplicativos/simulado/clisitefwin32.zip

CliSiTef Linux https://www.softwareexpress.com.br/distri/aplicativos/simulado/linuxclisitef.zip

Client Modular https://www.softwareexpress.com.br/distri/aplicativos/simulado/clientsitef.zip

4. Instalação do Módulo DmCard

 Se a instalação estiver sendo realizada em ambiente de Produção, antes de iniciar o procedimento,

 Se a instalação estiver sendo realizada em ambiente Simulado, antes de iniciar o procedimento, é

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Componentes do módulo para instalação no SiTef 5

Nome Descrição Versão Mínima

DrvCom.exe Driver de Comunicação 5.0.1.24

Gerpdv.exe Gerenciador de PDV’s 5.0.0.30

Sitdmcard.exe Módulo DmCard 5.0.0.12

Componentes do módulo para instalação no SiTef 6

Nome Descrição Versão Mínima

DrvCom-p.exe Driver de Comunicação 6.1.1.24

Gerpdv-p.exe Gerenciador de PDV’s 6.1.0.30

Sitdmcard-p.exe Módulo DmCard 6.1.0.12

Componentes do módulo para instalação no SitDemo 6

Nome Descrição Versão Mínima

Gerpdv-s.exe Gerenciador de PDV’s 6.1.3.30

Sitdmcard-s.exe Módulo DmCard 6.1.0.12

simcomu-s.exe Simulador de Comunicação 6.1.1.103

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Acessar o menu Iniciar ► Programas ►

Em seguida selecione a guia DMCard, serão apresentadas as opções abaixo:

Na guia Estabelecimento, configurar:

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Depois de configurado, pressione o botão , em seguida .

Na guia Tabela Bins, configurar:

Depois de configurado, pressione o botão , em seguida .

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Na aba Crédito, selecionar as opções que o estabelecimento irá transacionar.

Depois de configurado, pressione o botão , em seguida .

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Endereço IP Primário: Informar o endereço IP de destino

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Endereço IP Primário: Informar um endereço IP fictício, exemplo 1.2.3.4

Depois de configurado, pressione o botão , em seguida .

Ao retornar para a tela do configurador, selecionar a opção Arquivo – Sair.

Configuração DmCard realizada com sucesso!

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Tipo de Log: log_mmdd.dat

Email: suporte@softwareexpress.com.br Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Abaixo apresentamos as versões mínimas das aplicações para usuários do SiTefWeb:

Nome Descrição Versão Mínima

SitefWeb Aplicativo SiTefWeb 9083

ExpCli Exportador Cliente 1.13.1-1

ExpServ Exportador Servidor 1.13.5-3