05.03.01.2 - Especificação Técnica Do Sistema PinTEF vrs2.0.1 2020.06.10 PDF

Especificação Técnica do Sistema PinTEF
Título: Especificação Técnica do Sistema PinTEF
Referência 05 – Documento Técnico
Grupo 03 – Desenvolvimento de Sistemas
Assunto 01 – Especificação Técnica do Sistema PinTEF
Classificação: Restrito
Autor: Antonio Carlos Oliveira
Revisor (suporte e
Lincoln Pavelski
adequação):
Homologador (adequação): Anderson Cicotoste
Data de Disponibilização: 01 de Fevereiro de 2019
Histórico de Modificação:
Data Versão Autor Alterações
28/01/2019 0.1 Antonio Carlos Oliveira Criação
31/01/2019 0.2 Lincoln Pavelski Homologação
01/02/2019 1.0 Anderson Cicotoste Revisão
Inclusão de campos de retorno,

adequação de valores:
31/05/2019 1.1 Antonio Carlos Oliveira
131,100,136,156,505,105,134,1190 e
2333
Inclusão de funcionalidade de
02/09/2019 1.2 Antonio Carlos Oliveira personalizar ou remover o texto de
descanso no PinPAD (*obs.:Removendo
texto de Personalização, retornará a
Referência: 05 – Documento Técnico
Grupo: 03 – Desenvolvimento de Sistemas
Assunto: 01 – Especificação Técnica do Sistema PinTEF
Tipo: III – MPO – Manual de Política Operacional
Código: 05.03.01- III
exibir o texto Padrão) veja api-rest

MsgPinPad e ExcMsgPinPad
Documentação de
Retornos/Mensagens de
Autorizador/Switch/Gateway (Uso
internacionalização Equivalente do POS
A920)
Os Dados trocados nas funções são

todos do tipo String, ou seja JSON em
formato String
Ex.: De:
{\"Modo\":\"Desenv\",
\"Canal\":\"47\",
\"Loja\":\"12345678\",
\"Terminal\":\"87654321\",
\"Reservado\":\"000000\",
\"DadosAdicionais\":\"\"}
Para:
\'{\"Modo\":\"Desenv\",
\"Canal\":\"47\",
\"Loja\":\"12345678\",
\"Terminal\":\"87654321\",
\"Reservado\":\"000000\",
\"DadosAdicionais\":\"\"}\'
Documentação chamada api-rest

ForcaCargaTabela()
Autor Data: Homologador Versão:

Antonio Carlos Oliveira 07/01/2020 Lincoln Pavelski 1.5
Classificação: Vigência Revisor Página: 2 de 25
Restrito 12 meses Anderson Cicotoste
Deverá ser chamada na primeira vez

após a configuração usando:
EXPORT ConfiguraTEF
Mudança ForcaCargaTabela()
Se Estado == 4, carga do pinpad esta

ok. Se estado <> 4(Negativo) Erro,
sugestão forçar nova carga de tabela.
Chamando ForcaCargaTabela,
receberá:
{"response":0,"Mensagem":"Solicitacao
de Carga de Tabela","Estado":0},
chamando novamente receberá a
mensagem anterior ou:
{"response":0,"Mensagem":"Efetuado
Solicitacao de Carga de
07/01/2020 1.5 Antonio Carlos Oliveira Tabela","Estado":1}
Chamando novamente receberá a

{"response":0,"Mensagem":"Carga de
Tabela Recebida","Estado":2}

{"response":0,"Mensagem":"Carga de
Tabela Carregada no
PinPad","Estado":3}


{"response":0,"Mensagem":"
TABELAS ATUALIZADAS
","Estado":4}
Acerto SUB-GRUPO código 100 –

Modalidade de Pago.
19/2/2020 1.6 Antonio Carlos Oliveira SubGrupo 02 – Parcelado
Estabelecimento
03 – Parcelado Administradora
27/03/2020 1.7 Antonio Carlos Oliveira Correção do Código Credito/Débito
Tef 2.0
Remoção API-REST ForcaCarga Tabela
Remoção API-REST MsgPinPad e

ExcMsgPinPad
Inclusão de TerminalPDV
Inclusão de Interfaces Legadas
Criação de Função “0” Menu de Pagto e

Função “200” Menu de Cancelamento
Executar o programa PinService.exe,

este programa executa a
funcionalidade do PinTEF.exe, será
10/06/2020 2.0.1 Antonio Carlos Oliveira modificado para serviço
• A Porta do Pinpad deverá ser

informada no arquivo
CliTef.json


SUMÁRIO
1 Visão Geral ................................................................................................... 7
2 Escopo ........................................................................................................ 7
3 Aplicações das Especificações Técnicas do Sistema PinTEF ................................................. 7
4 Conceituação ................................................................................................. 7
5 Objetivo....................................................................................................... 8
6 Documentos de Referência .................................................................................. 8

7 Disposições Gerais............................................................................................ 8
8 Disposições Finais ............................................................................................ 9

Anexo I – Interface DLL/SO e Serviços REST do Sistema PinTEF .................................................. 9

1 Visão Geral
1.1. Este documento e seus anexos definem as diretrizes a serem seguidas relativas ao processo de Integração TEF com
automação de vendas a serem utilizados pelos parceiros comerciais da PINbank.
1.2. A elaboração e a atualização deste documento e de seus anexos são de responsabilidade do Departamento de
Dessenvolvimento, Área Técnica – Autorizadores TEF.
Este documento, de estrutura modular, é composto de uma parte principal e de seus anexos. O documento
principal contém as definições e regras gerais. Os anexos são as definições e regras para temas, ou áreas
específicas, conforme estabelecido no presente instrumento para permitir melhorias, adequações e
atualizações progressivas e independentes. DLL/SO. Integração
2 Escopo
2.1. Este documento define as regras e procedimentos gerais para a integração de soluções de automação de vendas de
parceiros comerciais, com o Sistema PinTEF da PINbank.
3 Aplicações das Especificações Técnicas do Sistema PinTEF

3.1. As diretrizes aqui dispostas aplicam-se a todos os colaboradores e prestadores de serviços, parceiros comerciais e a
qualquer pessoa ou entidade responsável por efetuar a integração de automação de vendas, sejam elas PDV’s, KIOSK’s,
entre outros, com o sistema PinTEF, no âmbito da interoperabilidade entre tais automações e o sistema da PinTEF
PINbank.
4 Conceituação
4.1. A este documento aplicam-se as seguintes conceituações:
TEF – Transferência Eletrônica de Fundos

Gateway TEF – Serviço de intermediação para solicitação e registro das Transações TEF
Automação de Vendas/KIOSK – Aplicação que tem a necessidade de efetuar transações TEF para registro de
pagamento da transação de venda.
DLL/SO – Biblioteca para in.tegração junto a automação de vendas que efetua as transações TEF (Linux/
Windows).
API-REST – Acrônimo de Representational State Transfer. É um estilo de arquitetura de software que define
um conjunto de restrições a serem usadas para criar serviços da web. Os serviços da Web que estão em

conformidade com o estilo arquitetural REST, denominado serviços da Web RESTful, fornecem
interoperabilidade entre sistemas de computador na Internet. Os serviços Web RESTful permitem que os
sistemas solicitantes acessem e manipulem representações textuais de recursos da Web usando um conjunto
uniforme e predefinido de operações sem estado. Mensagem trocada entre a aplicação PinTEF e as DLL/SO
ou utilizada diretamente pela automação de vendas/kiosk.
CLITEFAPI.DLL/SO – Biblioteca que oferece aos desenvolvedores de automações comerciais um conjunto de

rotinas (API´s) para integração com o Gateway PinBank.
PINTEF.EXE -Programa que tem por missão ouvir as chamadas API-REST e repassa-las a DLL ou Gateway
5 Objetivo
4.1. Definir regras claras e objetivas para a integração de automação de vendas de parceiros comerciais com o sistema
PinTEF da PINbank.
6 Documentos de Referência
01.01.01 - Política de Elaboração de Instrumentos Normativos.
01.01.02 - Política de Segurança da Informação
01.01.10 – Política de Segurança Para a Aquisição, Desenvolvimento e Manutenção de Sistemas
7 Disposições Gerais
7.1 Esta política será atualizada sempre que necessário, de modo a refletir as necessidade da PINbank.
7.1.1 As atualizações poderão ocorrer no todo ou por partes, tendo em vista a modularidade definida pelo
documento “01.01.01 - Política de Elaboração de Instrumentos Normativos.”
7.1.2 Toda atualização ensejará a atualização do número de versão da política, que é dado na forma
“N.nn”.
7.1.3 As atualizações nos anexos (módulos) gerarão incremento na numeração da parte “nn”, e as
alterações no documento principal gerarão incremento em “N”.
7.2 As alterações nesta política poderão ser feitas por determinação do Comitê Gestor da Segurança da
Informação.

8 Disposições Finais
8.1 Este documento e seus anexos devem ser amplamente divulgados, de acordo com o termo de confidencialidade
previamente assinado, entre todas as partes interessadas, sendo elas, mas não se limitando à colaboradores,
prestadores de serviço, estagiários e parceiros comerciais que atuem na integração de automação de vendas com o
sistema PinTEF da PINbank.
8.2 Este documento e seus anexos deverão estar disponíveis, para acesso ou download, a qualquer tempo, através
dos meios adequados.
Anexo I – Interface DLL/SO e Serviços REST do Sistema PinTEF

1 Visão Geral
1.1 O presente anexo descreve os aspéctos técnicos para a integração de sistemas de automação comercial com o
sistema PinTEF da PINbank.
2 Objetivo
2.1 Fornecer diretrizes e exemplos para que desenvolvedores de automação comercial possam integrar seus sistemas
com o PinTEF da PINbank, permitindo o uso das transações de pagamento utilizando o Gateway PINbank.
3 Disposições Gerais
3.1 Interface DLL/SO e REST e Legados.
3.1.1 Configuração da biblioteca:
3.1.1.1 Esta é a primeira chamada para a biblioteca CliTefAPI. O objetivo desta chamada é configurar os
parâmetros de conexão com o Gateway de Pagamento.
function ConfiguraTEF (_sJSON: pChar; _SzJSON: integer): integer stdcall ; external 'CliTefAPI.dll';
extern "C" unsigned long __declspec(dllexport) __stdcall ConfiguraTEF (char* _sJSON, int _SzJSON);
* (PChar contém uma string JSON conforme exemplo abaixo)
3.1.1.1.1 Entrada
Campo Tipo Descrição
Modo Texto(15) Literal “Desenv” ou “Producao”, esta chave indicara ao TEF usar
o IP de Desenvolvimento ou de Produção
Canal Texto(3) identificador do Canal do Estabelecimento
Loja Texto(8) Identificador do código do estabelecimento
TerminalPDV Texto(16) Nr. do terminal conhecido pelo estabelecimento
Terminal Texto(16) Nr. do terminal do estabelecimento fornecido pelo adquirente.

Esta informação é retornada na chamada do configura e pode
ser utilizado para renomear o “TerminalPDV”
Esta identificação do Terminal é que será utilizada nas
transações financeiras.
Reservado Texto(6) *Sem uso
DadosAdicionais Variavel *Sem uso
3.1.1.1.2 Saída
Campo Descrição
Modo Campo em “echo” (rebate a mensagem)
Canal Campo em “echo” (rebate a mensagem)
Loja Campo em “echo” (rebate a mensagem)
TerminalPDV Campo em “echo” (rebate a mensagem)

Campo Descrição
Terminal Campo de identificação de Terminal adquirente,
Reservado Campo em “echo” (rebate a mensagem)
response 0 - Execução com Sucesso

-1 – Erro, Verificar objeto Error retornado para maior detalhamento
3.1.2 Início da transação de pagamento
3.1.2.1 Esta chamada para a biblioteca tem objetivo de iniciar uma transação TEF, dependendo do código de
função passado como parametro será iniciado uma funcionalidade.
3.1.2.1.1 Ex.: Pagamento com Cartão de Credito, Cancelamento de Pagamento efetuado com Conta
Digital, etc.
3.1.2.1.2 Interface REST (Método POST)
/ConfiguraTEF: curl -H "Content-Type: application/json" --data @BodyConf.json

http://localhost:1880/ConfiguraTEF
BodyConf.json
{"Modo":"Desenv",”Canal”:”47”,"Loja":"12345678","Terminal":"87654321","Reservado":"000000",
"DadosAdicionais":"\"\""}
3.1.3 Inicialização da transação
3.1.3.1 Esta chamada para a biblioteca CliTefAPI. Tem por objetivo identificar a funcionalidade de TEF, bem
como passar os valores iniciais para a sua execução.
function IniciaFuncaoTEF (_sJSON: pChar; _SzJSON: integer): integer stdcall ; external 'CliTefAPI.dll';
extern "C" unsigned long __declspec(dllexport) __stdcall IniciaFuncaoTEF (char* _sJSON, int _SzJSON);
Para maior entendimento, vide tabelas abaixo:
3.1.3.1.1 Entrada


Funcao Numerico(6) Código da Função a ser executada (Ver código de função a ser
executada 3.1.6)
Valor Variavel Valor da transação a ser solicitada
CupomFiscal Texto(20) Nr. do Cupom da automação de venda
DataHoraFiscal Texto(14) Data/Hora da execução de automação de venda no formato

AAAAMMDDHHMMSS
Operador Texto(20) Identificação do Operador que executou a transação na
automação de venda
DadosAdicionais Variavel
3.1.3.1.2 Saída. Atualmente sem uso.
Campo Descrição
Funcao Campo echoado
Valor Campo echoado
CupomFiscal Campo echoado
DataHoraFiscal Campo echoado
Operador Campo echoado
DadosAdicionais Campo echoado
response
3.1.9 Tabela Retornos/Mensagens de
de Autorizador/Switch/Gateway (Uso
internacionalização Equivalente do POS A920)
3.1.3.2 Interface REST (Método POST)
/IniciaFuncaoTEF: curl -H "Content-Type: application/json" --data @BodyInicia.json

http://localhost:1880/IniciaFuncaoTEF

BodyInicia.json
{"Funcao" : 3,"Valor" : "10000","CupomFiscal" : "87654321","DataHoraFiscal" :
"20180404153200","Operador" : "Junior","DadosAdicionais" : "\"\""}
3.1.4 Continuação do processo TEF
3.1.4.1 A chamada tem por objetivo a continuidade da coleta de informação necessária a execução do TEF, e uma vez
que possua as informações necessárias para sua execução será enviado a mensagem ao gateway de pagamento para
a sua efetivação.
function ContinuaFuncaoTEF(_sJSON: pChar; _SzJSON: integer): integer stdcall ; external 'CliTefAPI.dll';

extern "C" unsigned long __declspec(dllexport) __stdcall ContinuaFuncaoTEF (char* _sJSON, int _SzJSON);
3.1.4.1.1 Entrada

Continua Numerico(6) Código continuidade de execução
0 – Continua a Execução
1 – Qdo possível retorna a coleta anterior
-1 – Encerra a transação
Buffer Variavel Retorno de informações para DLL/SO CLITEFAPI
3.1.4.1.2 Saída

cmd Numerico(6) Código comando a ser executado na automação de venda
campo Variavel Identificação do campo
tam * depende do comando
Min - Numerico(3) Tamanho Minimo para coleta
Max - Numerico(3) Tamanho Maximo para coleta
buffer Variavel Dados a serem trocados entre automação e modulo DLL/SO

CLITEFAPI


response Numerico (6) 0 – Encerrar a coleta
10000 – Continuar com a coleta
/ContinuaFuncaoTEF: curl -H "Content-Type: application/json" --data @BodyContinua.json

http://localhost:1880/ContinuaFuncaoTEF
BodyContinua.json
{"Continua":0,"Buffer":""}
3.1.5 Confirmação ou não da transação solicitada
3.1.5.1 Última rotina a ser invocada e tem a premissa de confirmar ou não a transação solicitada, bem como
complementar informações quanto a pagamento em outras formas e valores para efeito de conciliação.
function FinalizaFuncaoTEF(_sJSON: pChar; _SzJSON: integer): integer stdcall ; external 'CliTefAPI.dll';

extern "C" unsigned long __declspec(dllexport) __stdcall FinalizaFuncaoTEF (char* _sJSON, int _SzJSON);
3.1.5.1.1 Entrada

Confirma Numerico(6) Código para confirmar ou desfazer a transação
0 – Estornar
1 – Confirmar
CupomFiscal Texto(20) Nr. do Cupom da automação de venda, para garantir estar na
mesma transação
DataHoraFiscal Texto(14) Data/Hora da execução de automação de venda no formato
AAAAMMDDHHMMSS
DadosAdic Variável *Sem uso
3.1.5.1.2 Saída


Confirma Numerico(6) Código para confirmar ou desfazer a transação
0 – Estornar
1 – Confirmar
CupomFiscal Texto(20) Campo echoado
DataHoraFiscal Texto(14) Campo echoado
DadosAdic Variável Campo echoado
response Numerico (6) 0 – Encerrar a coleta

10000 – Continuar com a coleta
/FinalizaFuncaoTEF: curl -H "Content-Type: application/json" --data @BodyFinaliza.json

http://localhost:1880/FinalizaFuncaoTEF
BodyFinaliza.json
{"Confirma" : 0, "CupomFiscal" : "87654321","DataHoraFiscal" : "20180404160400","DadosAdic" :
""}
3.2 Interface DLL/SO e Legada Soft.
3.2.1 Esta interface legada foi desenvolvida para ser utilizada em substituição, possuindo praticamente a mesma
assinatura, no entanto sugerimos validar os valores/tipos dos campos e funcionalidades utilizados na interface JSON
3.2.2 Assinaturas da biblioteca:
3.2.2.1 Legada Software Interativa
function ConfiguraTEFLeg (_sIP : pChar, _sLoja : pChar, _Terminal : pChar, _sReservado: integer,
_sDadosAdicionais : pChar) : integer stdcall ; external 'CliTefAPI.dll';

function IniciaFuncaoTEFLeg (Longint _Funcao, _Valor : pChar, _CupomFiscal : pChar, _DataFiscal : pChar,
_HoraFiscal : pChar, _Operador : pChar, _DadosAdicionais : pChar) : integer stdcall ; external 'CliTefAPI.dll';
function ContinuaFuncaoTEFLeg (_Comando: ^integer, _TipoCampo: ^Longint, _TamanhoMin : ^Smallint,

_TamanhoMax : ^Smallint, _sBuffer: pChar, _TamBuffer : integer, _Continua:integer) : integer stdcall ; external
'CliTefAPI.dll';
FinalizaFuncaoTEFLeg (integer _Confirma,_CupomFiscal:pChar,_DataFiscal: pChar, _HoraFiscal:pChar,

_DadosAdicionais:pChar) : integer stdcall ; external 'CliTefAPI.dll';
extern "C" unsigned long __declspec(dllexport) __stdcall ConfiguraTEFLeg (const char* _sIP, const char* _sLoja,
const char* _Terminal, short _sReservado, const char* _sDadosAdicionais);
extern "C" unsigned long __declspec(dllexport) __stdcall IniciaFuncaoTEFLeg (const long _Funcao, const char* _Valor,
const char* _CupomFiscal, const char* _DataFiscal, const char* _HoraFiscal, const char* _Operador, const char*
_DadosAdicionais);
extern "C" unsigned long __declspec(dllexport) __stdcall ContinuaFuncaoTEFLeg (int* _Comando, long* _TipoCampo,
short* _TamanhoMin, short* _TamanhoMax, char* _sBuffer, int _TamBuffer, int _Continua);
extern "C" unsigned long __declspec(dllexport) __stdcall FinalizaFuncaoTEFLeg (short _Confirma, const char*
_CupomFiscal, const char* _DataFiscal, const char* _HoraFiscal, const char* _DadosAdicionais);
3.2.3 Tabela de código de funções
Código Descrição
0 Menu de Pagamentos
3 Pagamento com cartão Crédito
2 Pagamento com cartão Débito
200 Menu de Cancelamentos
210 Cancelamento pagamento cartão Crédito
211 Cancelamento pagamento cartão Débito

3.2.4 Tabela de código de Comando
Código Descrição
0 Retorno a ser utilizado para automação
1 Mensagem do Cliente
2 Mensagem do Operador
3 Mensagem para Ambos
21 Menu de Seleção
23 Pinpad em Operação, se automação desejar pode ser interrompido
29 Automação deverá retornar um campo de tamanho entre mínimo e máximo e retornar ao
modulo TEF(Sem coleta ao operador)
30 Automação deverá retornar um campo de tamanho entre mínimo e máximo e retornar ao
modulo TEF(Coleta junto ao Operador)

3.2.5 Tabela de código de campo retornado
Código Descrição
100 Modalidade de pago
XX GRUPO NN SUB-GRUPO
00 Cheque 00 À Vista
01 Crt.Débito 01 Pré-Datado
02 Crt.Crédito 02 Parcelado Estabelecimento
03 Voucher 03 Parcelado Administradora
04 Fidelidade 99 Outro Tipo de Pago
98 Dinheiro
00 Outro Cartão
102 Texto Descritivo da Transação
105 Data/Hora da Transação retornada do autorizador
121 Comprovante via Cliente
122 Comprovante via Caixa
131 Índice da Instituição Autorizadora
CÓD. INSTITUIÇÃO
01 Stone
02 Adiq
134 NSU do Host
136 Bin do Cartão
505 Numero de Parcelas
1003 Nome do Portador do Cartão
1012 Data vencimento do Cartão AAMM
1190 Embosso Cartão (4 últimos dígitos)
2333 Identificação da Transação
5057 Moeda Corrente
5058 Aplicativo Chip

3.1.9 Tabela de Retornos/Mensagens de Autorizador/Switch/Gateway (Uso internacionalização Equivalente

do POS A920)
Código Mensagem
Sem Erro
0
-1 Falha de Comunicação com autorizador(Conexão/ Módulo PinTEF)
Falha de Comunicação com autorizador (Resposta/Módulo PinTEF)

-2
Erro interno no processamento da solicitação (HOST).

1
5
Tipo de captura não suportado para a transação.

7
65
Transação não autorizada.

8
42
Erro na validação do estabelecimento/terminal.

9
Estabelecimento inválido para o terminal.
10
O estabelecimento vinculado ao terminal não está ativo.
11
Terminal não encontrado. Verifique o cadastro.
13
O terminal não está ativo. Verifique o cadastro.
14
O estabelecimento não está habilitado para transacionar com a bandeira/tipo de compra
16
recebidos.
Não foram encontrados adquirentes associados ao cadastro do estabelecimento. Verifique

17
o cadastro.
Transação não localizada.

19
21

Tipo de parcelamento não permitido.

22
Valor da compra parcelada inferior ao mínimo permitido.
30
Número do telefone inválido.
31
E-mail inválido.
32
Número do telefone ou e-mail devem ser informados para a operação.
33
Dados de identificação do cliente inválidos para o tipo de transação.
34
Transação já cancelada/desfeita.
35
Tipo de transação não permite cancelamento.
36
Transação original não encontrada.
37
Funcionalidade não habilitada para o estabelecimento.
48
Bandeira ou cartão recebido não suportado.
55
Não foi possível encontrar o plano do estabelecimento para o tipo de transação enviada.
56
57
73
Bandeira não disponível para o estabelecimento.

62
Problemas na conexão com o servidor (ADQ. DOWN).
20
64
60
119
131
132
168
179
Problemas na conexão com o servidor (GTW. DOWN).

184
45
Timeout no envio da requisição.

183

Data de validade do cartão com formato inválido.

66
67
CVV2/CVC2 com formato inválido.

68
69
Dados do cartão inválidos ou com tamanho inválido.

71
72
Transação negada, cartão na lista de excessões.

74
78
Token inválido.
77
106
Valor inferior ao mínimo configurado para o estabelecimento.

87
Valor superior ao máximo configurado para o estabelecimento.
88
Cliente não encontrado.
89
97
Valor da transação excede o valor máximo de transações para o mesmo CPF.
98
Senha inválida.
102
158
Não foram encontradas informações para os parametros informados.

103
Não foi possível consultar CPF/CNPJ no SPC.
104
Tipo de consulta no SPC não suportado.
105
Cliente multicanal, não será possível continuar a transação.
107
Transação tarja não permitida para a bandeira do cartão.
108
Loja sem limite disponível para fazer a consulta.
110
Erro no processamento da solicitação (BD).
111
Senha para cancelamento inválida.
115
Saldo insuficiente.
121

Emissor fora de operação.

122
Não foram encontrados estabelecimentos configurados para o terminal.
134
Quantidade de parcelas invalida para o tipo de compra enviado.
135
Terminal sem chave criptográfica.
137
Chave criptográfica do terminal inválida para as configurações da loja.
138
Dados da conta do cliente não especificados.
142
Erro ao efetuar solicitação de saque.
143
Erro ao efetuar cancelamento de saque.
144
Operação não permitida para clientes da mesma titularidade.
145
Valor da transação excede o valor máximo de transações para o mesmo CPF.
146
Erro ao efetuar solicitação de consulta de valores.
147
Não foram encontrados valores disponíveis.
148
Não foi possível enviar o comprovante.
149
Telefone obrigatório para envio do comprovante de saque.
150
Dados da transação não encontrados para os parametros enviados.
151
Transação não permitida. Loja da transação original diferente da loja da transação.
160
Transação não permitida. Transação original não é uma pré-autorização.
161
Transação não permitida. Cartão diferente da transação original.
162
CPF/CNPJ do estabelecimento inválido.
163
Terminal (TID) não encontrado para o estabelecimento (MID).
164
Fallback digitado não permitido.
166
Fallback magnético não permitido.
167
Cartão não autorizado a realizar transações de saque.
169
Configurações do estabelecimento inválidas para o tipo de transação enviado.
178

Disposições Finais
2.1 Funcionamento básico.
2.1.1 A automação de Vendas/Kiosk deverá iniciar chamando o procedimento “ConfiguraTEF” com os parâmetros
devidos e verificar o seu retorno, se o seu retorno foi “0” a configuração foi efetuada com sucesso permitindo a
continuidade do processo, em caso de erro , valor diferente de “0.
2.1.2 No caso do retorno com sucesso “0”, será necessário agora a execução do procedimento “IniciaFuncaoTEF” com
os devidos parâmetros, e verificar o seu retorno, se o mesmo foi “10000” a iniciação da funcionalidade foi efetuada
com sucesso permitindo sua continuidade, em caso contrário a funcionalidade será encerrada.
2.1.3 Após a execução da iniciação da função, será necessário a chamada continuada do procedimento
“ContinuaFuncaoTEF” enquanto seu retorno for igual a “10000” e efetuar os tratamentos pertinentes. Se o retorno
for igual a “0” a transação TEF esta aguardando a sua confirmação ou cancelamento e para isto deve-se utilizar o
procedimento final “FinalizaFuncaoTEF”.
2.2 A figura abaixo exemplifica o funcionamento em blocos:

2.3 Conforme a figura acima que exemplifica o fluxo do processo do sistema PinTEF da PINbank, após o “Retorno = 0” da
função “ContinuaFuncaoTEF()”, que significa sucesso, a automação comercial deverá tratar a impressão do cupom
retornado pelo PinTEF.
2.3.1 No caso de sucesso, a automação deverá chamar a rotina “FinalizaFuncaoTEF()”, com o o valor “1”, que significa
a confirmação do sucesso da impressão do cupóm e consequentemente confirmação da transação TEF.
2.3.2 No caso de falha, a automação comercial deverá chamar a rotina “FinalizaFuncaoTEF()”, com o o valor “0”, que
significa a não impressão do cupom e consequentemente o cancelamento da transação TEF.
4.4 Equipamentos PinPad´s homologados x Ambiente

4.4.1 Windows –
4.4.1.1 Gertec PPC910, PPC920 e PPC930
4.4.1.2 Ingenico IPP320
4.4.1.3 PAX – S300
4.4.1.4 Verifone VX820
4.4.2 Linux
4.4.2.1 Gertec PPC910, PPC920 e PPC930
4.4.2.2 Ingenico IPP320
4.4.2.3 PAX – S300 (Parcial)
4.4.2.4 Verifone VX820 (Não Testado, provavelmente SIM)


05.03.01.2 - Especificação Técnica Do Sistema PinTEF vrs2.0.1 2020.06.10 PDF

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

05.03.01.2 - Especificação Técnica Do Sistema PinTEF vrs2.0.1 2020.06.10 PDF

Загружено:

Авторское право:

Доступные форматы

Especificação Técnica do Sistema PinTEF

Título: Especificação Técnica do Sistema PinTEF

Referência 05 – Documento Técnico

Grupo 03 – Desenvolvimento de Sistemas

Assunto 01 – Especificação Técnica do Sistema PinTEF

Autor: Antonio Carlos Oliveira

Homologador (adequação): Anderson Cicotoste

Data de Disponibilização: 01 de Fevereiro de 2019

Data Versão Autor Alterações

28/01/2019 0.1 Antonio Carlos Oliveira Criação

31/01/2019 0.2 Lincoln Pavelski Homologação

01/02/2019 1.0 Anderson Cicotoste Revisão

Inclusão de campos de retorno,

exibir o texto Padrão) veja api-rest

Os Dados trocados nas funções são

Documentação chamada api-rest

Autor Data: Homologador Versão:

Deverá ser chamada na primeira vez

Se Estado == 4, carga do pinpad esta

Chamando novamente receberá a

Chamando novamente receberá a

Chamando novamente receberá a

Autor Data: Homologador Versão:

Acerto SUB-GRUPO código 100 –

27/03/2020 1.7 Antonio Carlos Oliveira Correção do Código Credito/Débito

Remoção API-REST MsgPinPad e

Inclusão de Interfaces Legadas

Criação de Função “0” Menu de Pagto e

Executar o programa PinService.exe,

• A Porta do Pinpad deverá ser

Autor Data: Homologador Versão:

Autor Data: Homologador Versão:

3 Aplicações das Especificações Técnicas do Sistema PinTEF ................................................. 7

6 Documentos de Referência .................................................................................. 8

8 Disposições Finais ............................................................................................ 9

Autor Data: Homologador Versão:

3 Aplicações das Especificações Técnicas do Sistema PinTEF

TEF – Transferência Eletrônica de Fundos

Autor Data: Homologador Versão:

CLITEFAPI.DLL/SO – Biblioteca que oferece aos desenvolvedores de automações comerciais um conjunto de

Autor Data: Homologador Versão:

Anexo I – Interface DLL/SO e Serviços REST do Sistema PinTEF

3.1 Interface DLL/SO e REST e Legados.

3.1.1 Configuração da biblioteca:

Loja Texto(8) Identificador do código do estabelecimento

TerminalPDV Texto(16) Nr. do terminal conhecido pelo estabelecimento

Terminal Texto(16) Nr. do terminal do estabelecimento fornecido pelo adquirente.

DadosAdicionais Variavel *Sem uso

Canal Campo em “echo” (rebate a mensagem)

Loja Campo em “echo” (rebate a mensagem)

TerminalPDV Campo em “echo” (rebate a mensagem)

Autor Data: Homologador Versão:

Reservado Campo em “echo” (rebate a mensagem)

response 0 - Execução com Sucesso

3.1.2 Início da transação de pagamento

/ConfiguraTEF: curl -H "Content-Type: application/json" --data @BodyConf.json

3.1.3 Inicialização da transação

Para maior entendimento, vide tabelas abaixo:

Autor Data: Homologador Versão:

Campo Tipo Descrição

CupomFiscal Texto(20) Nr. do Cupom da automação de venda

DataHoraFiscal Texto(14) Data/Hora da execução de automação de venda no formato