Escolar Documentos
Profissional Documentos
Cultura Documentos
Módulo Tricard
PagSeguro_Suporte_USO_INTERNO
CONTEÚDO
1. INTRODUÇÃO...................................................................................................................................................... 3
2. DESCRIÇÃO DO NEGÓCIO .................................................................................................................................... 3
3. PRÉ-REQUISITOS ................................................................................................................................................. 3
4. INSTALAÇÃO DO MÓDULO TRICARD.................................................................................................................... 4
5. COMPONENTES DO MÓDULO ............................................................................................................................. 5
6. CONFIGURAÇÃO DO MÓDULO TRICARD NO SITEF/SITDEMO ............................................................................... 6
7. CONFIGURAÇÃO MULTIBANDEIRA ...................................................................................................................... 8
8. CARGA DE TABELAS........................................................................................................................................... 16
9. VISUALIZADOR DE TABELAS TRICARD ................................................................................................................ 17
10. RELATÓRIOS...................................................................................................................................................... 18
11. SITEFWEB ......................................................................................................................................................... 19
12. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA TRICARD ...................................................................... 20
13. CONFIGURAÇÃO DO PONTO DE VENDA (PDV) ................................................................................................... 22
13.1 INTERFACE CLISITEF ........................................................................................................................................... 22
13.1.1 Compra Débito e Crédito (Magnético ou Digitado) ................................................................................. 22
13.1.2 Cancelamento Compra Débito e Crédito (Magnético ou Digitado) .......................................................... 22
13.1.3 Pagamento de Fatura (Magnético ou Digitado) ...................................................................................... 23
13.1.4 Estorno Pagamento de Fatura (Magnético ou Digitado) ......................................................................... 23
13.1.5 Saque Crédito ........................................................................................................................................ 24
13.1.6 Cancelamento de Saque Crédito ............................................................................................................ 24
13.1.7 Desbloqueio Cartão Crédito ................................................................................................................... 25
13.1.8 Consulta Saldo Tricard ........................................................................................................................... 25
13.1.9 Adesão de Seguro .................................................................................................................................. 26
13.1.1 Pré-autorização ..................................................................................................................................... 26
13.1.2 Captura Pré-autorização ........................................................................................................................ 27
13.1.3 Cancelamento da Captura Pré-autorização ............................................................................................ 27
13.1.4 Carga de Pré Pago.................................................................................................................................. 27
13.1.5 Cancelamento de Pré Pago .................................................................................................................... 27
13.2 INTERFACE CLIENT MODULAR ............................................................................................................................... 28
13.2.1 Compra Débito e Crédito (Magnético ou Digitado) ................................................................................. 28
13.2.2 Cancelamento Venda Débito e Crédito (Magnético ou Digitado) ............................................................ 28
13.2.3 Pagamento de Fatura ............................................................................................................................ 29
13.2.4 Estorno pagamento de Fatura................................................................................................................ 29
13.2.5 Saque Crédito ........................................................................................................................................ 29
13.2.6 Cancelamento de Saque Crédito ............................................................................................................ 29
13.2.7 Desbloqueio Cartão Crédito ................................................................................................................... 29
13.2.8 Consulta Saldo Tricard ........................................................................................................................... 30
13.2.9 Adesão de Seguro .................................................................................................................................. 30
13.2.1 Pré-autorização ..................................................................................................................................... 30
13.2.2 Captura pré-autorização ........................................................................................................................ 31
13.2.3 Cancelamento da Pré-Autorização ......................................................................................................... 31
13.2.4 Carga de Pré Pago.................................................................................................................................. 31
13.2.5 Cancelamento de Pré Pago. ................................................................................................................... 31
14. TABELA DE CÓDIGOS DE RETORNO DA ADMINISTRADORA. ............................................................................... 32
15. INFORMAÇÕES GERAIS...................................................................................................................................... 34
16. HISTÓRICO DE VERSÕES .................................................................................................................................... 35
Tricard_Guia de Instalação 2 de 36
1. INTRODUÇÃO
Este documento destina-se ao usuário que pretende instalar e configurar o módulo Tricard no SiTef ou no SitDemo.
2. DESCRIÇÃO DO NEGÓCIO
O módulo está preparado para trabalhar com transações de Compra Crédito com processamento EMV dos cartões
Tricard emitidos pelo Tribanco, transações com cartões Multi-Bandeira acordados com o autorizador, e transações
contactless.
3. PRÉ-REQUISITOS
Abaixo apresentamos as versões mínimas das interfaces, conforme a versão do SiTef ou SitDemo utilizada:
As interfaces dos PDV’s somente são compatíveis com a versões específicas do SiTef/SitDemo informadas acima.
Tricard_Guia de Instalação 3 de 36
4. INSTALAÇÃO DO MÓDULO TRICARD
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 SiTef_Tricard.msi e seguir os
passos Avançar ► Instalar ► Concluir.
c) Efetuar a configuração conforme item “Configuração do Módulo” abaixo.
Observações:
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_Tricard
b) Renomear a pasta \SiTef\Aplic.win para \Aplic.win_Tricard
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\
Tricard_Guia de Instalação 4 de 36
5. COMPONENTES DO MÓDULO
Tricard_Guia de Instalação 5 de 36
6. CONFIGURAÇÃO DO MÓDULO TRICARD NO SITEF/SITDEMO
ATENÇÃO: Essa versão contempla as novas características de configuração do SiTef descritas no
documento “Características de Segurança.pdf”.
SiTef Produção: ►
SiTef Simulado: ►
Em seguida selecione a guia Tricard, serão apresentadas as opções abaixo:
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 Tricard.
SiTef Simulado: Informar um código de estabelecimento fictício. Por Exemplo: 11111111111111.
Tricard_Guia de Instalação 6 de 36
Na guia Comunicação, configurar a interface utilizada para comunicação com o autorizador.
SiTef Produção:
Interface TCPIP/Direto, realizar a configuração conforme informado abaixo:
Formato do Tamanho:
Se a comunicação for TCP/IP direto com a autorizadora Tricard, verificar com a administradora.
Se a comunicação for com o Gateway, configurar Binário (Low High).
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:
Tricard_Guia de Instalação 7 de 36
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.
7. CONFIGURAÇÃO MULTIBANDEIRA
Atualmente é possível realizar a configuração utilizando dois configuradores, sendo eles Conf. Multi Bandeira e conf.
(padrão) e Multi bandeira 2 – Colorido (neste é possível realizar a configuração em grupo). Abaixo apresentamos as
configurações de cada.
► .
Selecione a empresa a ser configurada, ou opte por uma configuração padrão para todas as empresas/lojas do
servidor selecionando a opção TODAS, segue:
Tricard_Guia de Instalação 8 de 36
Conforme abaixo:
ATENÇÃO!: Certifique com o autorizador Tricard quais são as bandeiras de cartões que são autorizadas para
roteamento multibandeira. A informação acima serve apenas de EXEMPLO.
Acesse o menu: Iniciar Programas SiTef - Menu Principal Conf. Multi Bandeiras2
Funcionalidades
Grid de Edição
Barra de loading
Grid Principal
Tricard_Guia de Instalação 9 de 36
Botões
Linha
Linha selecionada (para selecionar, clique na primeira coluna da Grid Principal. Clique
novamente para não selecionar)
Linha não selecionada e modificada, isto é, a alteração dessa linha ainda não foi gravada
em arquivo.
Tricard_Guia de Instalação 10 de 36
Coluna
botão é pressionado).
Menu
Outros
As empresas estão listadas na coluna à esquerda e a primeira linha lista os produtos. Nesse caso, não existe
nenhuma configuração. O primeiro passo é criar uma linha com a configuração desejada, isso é feito na Grid de
Edição, localizada na parte superior do configurador.
Tricard_Guia de Instalação 11 de 36
Clique nas células da Grid de Edição para listar os módulos existentes
Monte a linha da Grid de Edição da forma que achar necessário. Selecione, clicando na primeira coluna onde
está localizado o código da empresa, as empresas onde é desejável copiar a configuração montada na Grid de
Edição.
Nesse exemplo, as empresas 00000005 e 00000009 estão selecionadas. Para aplicar a configuração da Grid de
Edição na Grid Principal (tabela grande no centro), clique em .
Tricard_Guia de Instalação 12 de 36
Repita o processo até que a Grid Principal fique do jeito que achar necessário.
Tricard_Guia de Instalação 13 de 36
Para consolidar as alterações feitas na Grid Principal, tecle Ctrl+S ou vá em [Arquivo] ► [Salvar Configuração].
Quando a barra de loading chegar ao fim a configuração estará gravada.
Observação: Quando a configuração é gravada, ela não será ativada no SiTef imediatamente, a não ser que o
configurador esteja configurado para fazer isso* ou que o serviço do SiTef seja reiniciado manualmente. Se não
é esse o caso, a configuração é ativada no SiTef em até, no máximo, um dia após a gravação.
* Ativar a configuração sempre que salvar: Se esta opção está ativa, sempre que a configuração feita na Grid
Principal é salva, o configurador irá imediatamente tentar ativar as mudanças feitas.
Tricard_Guia de Instalação 14 de 36
A opção de “Não abrir o log em caso de sucesso” pode ser habilitada ou não. Se habilitada, quando a ativação
foi completada com sucesso, o log não é aberto. Se houver uma falha em alguma mensagem, a log será sempre
aberta automaticamente.
Tricard_Guia de Instalação 15 de 36
8. CARGA DE TABELAS
SiTef Produção: ►
SiTef Simulado: ►
Este aplicativo realiza uma baixa das configurações habilitadas para o estabelecimento. Em ambiente de produção,
é realizada uma conexão com a Tricard, a qual envia essas configurações ao SiTef.
Selecionar a opção Tricard ► Carga, clicar na empresa SiTef que deseja efetuar a carga de tabelas e clicar no Botão
‘Enviar’.
Tricard_Guia de Instalação 16 de 36
9. VISUALIZADOR DE TABELAS TRICARD
SiTef Produção: ►
SiTef Simulado: ►
Este aplicativo permite apenas visualizar os dados que desceram na tabela da Tricard. Qualquer alteração em ambiente
de produção, deve ser solicitada para a Tricard, e após, realizar uma nova carga de tabelas.
Tricard_Guia de Instalação 17 de 36
10. RELATÓRIOS
Para listar as transações utilizar o Relatório do SiTef, através do menu Iniciar ► Programas ►
SiTef Produção: ►
SiTef Simulado: ►
Tricard_Guia de Instalação 18 de 36
11. SITEFWEB
Tricard_Guia de Instalação 19 de 36
12. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA TRICARD
Descrição
SAQUE CRÉDITO
Tricard_Guia de Instalação 20 de 36
PRÉ AUTORIZAÇÃO DIGITADA COM JUROS (adm)
(*) As transações marcadas não são financeiras, portanto também não precisam ser apresentadas em relatórios. Futuramente
solicitaremos um relatório específico para a listagem deste tipo de transação.
Tricard_Guia de Instalação 21 de 36
13. CONFIGURAÇÃO DO PONTO DE VENDA (PDV)
Tricard_Guia de Instalação 22 de 36
13.1.3 Pagamento de Fatura (Magnético ou Digitado)
Para habilitar a transação de pagamento de fatura para a rede Tricard, editar o arquivo Clisitef.ini e incluir
os parâmetros abaixo e reiniciar a aplicação do PDV:
[Redes]
HabilitaRedeTricard=1
Tricard_Guia de Instalação 23 de 36
13.1.5 Saque Crédito
Para habilitar a transação de saque crédito para a rede Tricard, editar o arquivo Clisitef.ini e incluir os
parâmetros abaixo e reiniciar a aplicação do PDV:
[Geral]
TransacoesAdicionaisHabilitadas=3047
Após, selecionar a opção Cancelamento Saque Crédito, e seguir com o fluxo da transação.
Tricard_Guia de Instalação 24 de 36
13.1.7 Desbloqueio Cartão Crédito
Para habilitar a transação de desbloqueio de cartão de crédito para a rede Tricard, editar o arquivo
Clisitef.ini e incluir os parâmetros abaixo e reiniciar a aplicação do PDV:
[Geral]
TransacoesAdicionaisHabilitadas=3055
Tricard_Guia de Instalação 25 de 36
13.1.9 Adesão de Seguro
Para habilitar a transação de adesão seguro para a rede Tricard, editar o arquivo Clisitef.ini e incluir os
parâmetros abaixo e reiniciar a aplicação do PDV:
[Redes]
HabilitaRedeTricard=1
13.1.1 Pré-autorização
Não há configurações adicionais.
Essa transação está disponível no menu administrativo (função 110).
Tricard_Guia de Instalação 26 de 36
13.1.2 Captura Pré-autorização
Não há configurações adicionais.
Essa transação está disponível no menu de confirmação de pré autorização (função 116).
Tricard_Guia de Instalação 27 de 36
13.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.
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
Tricard_Guia de Instalação 28 de 36
13.2.3 Pagamento de Fatura
Configurar no arquivo \Client\ClienteTrn.ini os parâmetros abaixo:
[BOTOES_HABILITADOS]
btPagtoFatura=1
Selecionar a opção
Selecionar a opção
Selecionar a opção
Selecionar
Selecionar a opção
Selecionar
Tricard_Guia de Instalação 29 de 36
Não há parâmetros para serem configurados.
Essa transação está disponível no menu Administrativo (função ADM).
Selecionar a opção
Em seguida, escolher
Selecionar a opção
Em seguida, escolher
Selecionar a opção
Em seguida, escolher
13.2.1 Pré-autorização
Não há parâmetros adicionais para serem configurados.
Essa transação está disponível no menu de funções Pré-Autorização (função PRE).
Tricard_Guia de Instalação 30 de 36
Selecionar a opção e seguir com o fluxo da transação.
Selecionar a opção
[ConsultaPrePago]
PermiteCartaoDigitado=1
PermiteCartaoMagnetico=1
000-000 = CRTPRE
001-000 = 1
003-000 = 3,00
204-001 = 1
204-002 = 18052020
530-000 = 123
701-000 = 1 -> Carga de Pré-Pago
999-999 = 0
A seguir um exemplo do arquivo de requisição que deve ser enviado para esta transação:
Tricard_Guia de Instalação 31 de 36
000-000 = CRTPRE
001-000 = 1
003-000 = 3,00
204-001 = 1
204-002 = 18052020
530-000 = 123
701-000 = 11 -> Cancelamento Carga Pré-Pago
999-999 = 0
04 Cartão já desbloqueado -
07 Arquivo indisponível -
08 Solicite identificação -
17 Data invalida -
19 Refazer transação -
20 Resposta inválida -
Tricard_Guia de Instalação 32 de 36
31 Instituição não pertence à rede Estabelecimento não pertence à rede
34 Cartão LN fraude -
36 Já possui seguro -
54 Cartão vencido. -
59 Conta irregular -
62 Conta/Cartão bloqueado -
76 Cartão bloqueado -
81 Trans.estornada -
Tricard_Guia de Instalação 33 de 36
83 Time-out -
Tricard_Guia de Instalação 34 de 36
16. HISTÓRICO DE VERSÕES
VERSÃO ALTERAÇÃO
Tricard_Guia de Instalação 35 de 36
x.x.4.2a Ajustes no módulo.
Ajuste na troca de mensagens com o autorizador Tricard, para melhor desempenho nas transações
x.x.6.1
de carga pre pago e cancelamento carga pre pago.
Tricard_Guia de Instalação 36 de 36