Documentação Técnica 1.41 POS-HOST

Documentação de Integração
Documentação Técnica 1.41

IMPLEMENTAÇÃO ENTRE TERMINAL E SISTEMA PAYNET
PAYNET CAPTURA DE http://www.paynet.net.br Página 1 de 55

TRANSAÇÕES DE SISTEMAS Todos os direitos reservados.
LTDA
DOCUMENTO CONFIDENCIAL
Sumário
1. IDENTIFICAÇÃO ......................................................................................................................................................... 5
2. HISTÓRICO DE REVISÃO ............................................................................................................................................. 5
3. INTRODUÇÃO ............................................................................................................................................................ 7
4. CÓDIGOS E FORMATOS UTILIZADOS NESTE DOCUMENTO ......................................................................................... 7
4.1. INDICAÇÃO VARIAÇÃO DE CAMPO ............................................................................................................................................. 7
4.2. TAMANHO .......................................................................................................................................................................... 7
4.3. TIPO .................................................................................................................................................................................. 7
4.4. CAMPOS COMPOSTOS (TLV) .................................................................................................................................................. 8
4.5. DATA E HORA....................................................................................................................................................................... 8
5. MENSAGEM ISO ........................................................................................................................................................ 8
5.1. TIPO DE MTI ....................................................................................................................................................................... 9
5.2. CLASSE DE MENSAGENS ......................................................................................................................................................... 9
5.3. FUNÇÃO DA MENSAGEM........................................................................................................................................................ 9
5.4. ORIGEM DA MENSAGEM ........................................................................................................................................................ 9
6. DEFINIÇÃO DE FLUXO DE MENSAGEM ..................................................................................................................... 10
6.1. SOLICITAÇÃO DE PRÉ AUTORIZAÇÃO ....................................................................................................................................... 10
6.2. CONFIRMAÇÃO DE PRÉ AUTORIZAÇÃO .................................................................................................................................... 10
6.3. ADIVCE ............................................................................................................................................................................. 10
6.4. FINANCEIRA ....................................................................................................................................................................... 10
6.5. CANCELAMENTO ................................................................................................................................................................ 10
6.6. REDE................................................................................................................................................................................ 10
6.7. RECARGA DE CELULAR ......................................................................................................................................................... 11
6.7.1 RECARGA APROVADA ................................................................................................................................................... 11
6.7.2 RECARGA NEGADA ...................................................................................................................................................... 11
6.7.3 TRANSAÇÃO NEGADA ................................................................................................................................................... 11
6.7.4 TRANSAÇÃO NEGADA 2ND GEN ..................................................................................................................................... 11
6.7.5 CONSULTA NEGADA ..................................................................................................................................................... 11
6.8. SUBTIPOS .......................................................................................................................................................................... 12
6.9. TRANSAÇÕES DE DESFAZIMENTO ............................................................................................................................................ 12
6.10. TRANSAÇÕES DE CONFIRMAÇÃO ........................................................................................................................................ 13
7. MENSAGENS............................................................................................................................................................ 13
7.1. ISO ................................................................................................................................................................................. 13
7.2. COMUNICATOR CM-HTTP (JSON) ....................................................................................................................................... 14
7.3. TESTE DE COMUNICAÇÃO ..................................................................................................................................................... 15
7.4. KEEP ALIVE........................................................................................................................................................................ 15
7.5. ATIVAÇÃO ......................................................................................................................................................................... 16
7.6. BAIXA TABELA DE APLICAÇÕES EMV E CHAVES PUBLICAS ........................................................................................................... 16
7.7. BAIXA TABELA DE PARÂMETROS ............................................................................................................................................. 17
7.8. BAIXA TABELA DE TAXAS E JUROS ........................................................................................................................................... 17
7.9. BAIXA TABELA DE BONUS E RECARGAS .................................................................................................................................... 18
7.10. SOLICITAÇÃO DE RECARGA ................................................................................................................................................ 18
7.11. SOLICITAÇÃO DE PRÉ-AUTORIZAÇÃO ................................................................................................................................... 19
7.12. CONFIRMAÇÃO DE PRÉ AUTORIZAÇÃO ................................................................................................................................ 20
7.13. FINANCEIRA ................................................................................................................................................................... 21
7.14. CANCELAMENTO ............................................................................................................................................................. 22
7.15. DESFAZIMENTO .............................................................................................................................................................. 23
LTDA
7.16. CONFIRMAÇÃO DE TRANSAÇÃO E ESTORNO.......................................................................................................................... 23

7.17. ADVICE ......................................................................................................................................................................... 24
8. DETALHEMANETO DOS BITS DA MENSAGEM ........................................................................................................... 25
8.1. BIT 001 – BITMAP ............................................................................................................................................................. 25
8.2. BIT 003 – CÓDIGO DE PROCESSAMENTO ................................................................................................................................ 25
8.3. BIT 004 – VALOR AUTORIZADO ............................................................................................................................................ 25
8.4. BIT 007 – DATA E HORA DA TRANSAÇÃO ............................................................................................................................... 25
8.5. BIT 011 – NUMERO SEQUENCIAL ÚNICO DA TRANSAÇÃO (NSU) ................................................................................................ 25
8.6. BIT 012 – HORA LOCAL ...................................................................................................................................................... 26
8.7. BIT 013 – HORA LOCAL ...................................................................................................................................................... 26
8.8. BIT 022 – MODO DE ENTRADA ............................................................................................................................................. 26
8.9. BIT 023 – PAN SEQUENCE NUMBER..................................................................................................................................... 26
8.10. BIT 038 – NSU DO HOST PAYNET ................................................................................................................................... 26
8.11. BIT 039 – CÓDIGO DE RESPOSTA ...................................................................................................................................... 26
8.12. BIT 041 – NUMERO DE SERIE ........................................................................................................................................... 27
8.13. BIT 042 – DOCUMENTO DO ESTABELECIMENTO COMERCIAL .................................................................................................. 27
8.14. BIT 049 – CÓDIGO DA MOEDA ......................................................................................................................................... 27
8.15. BIT 052 – PIN BLOCK ..................................................................................................................................................... 27
8.16. BIT 055 – DADOS EMV .................................................................................................................................................. 27
8.17. BIT 060 – DADOS DA TRANSAÇÃO ORIGINAL PARA CONFIRMAÇÃO (0200) ................................................................................ 27
8.18. BIT 061 – DADOS DO PONTO DE VENDA (TLV LLL...VAR) ..................................................................................................... 28
8.19. BIT 062 – COMPROVANTE LOJISTA/INDICES E TIPOS DAS TABELAS .......................................................................................... 28
8.20. BIT 063 – DADOS ADICIONAIS DA TRANSAÇÃO (TLV LLL...VAR) ............................................................................................. 29
8.21. BIT 067 – NUMERO DE PARCELAS ..................................................................................................................................... 30
8.22. BIT 070 – TIPO DA MENSAGEM ........................................................................................................................................ 30
8.23. BIT 090 – DADOS DA TRANSAÇÃO ORIGINAL ....................................................................................................................... 30
8.24. BIT 118 – FORMA DE PAGAMENTO ................................................................................................................................... 31
8.25. BIT 120 – DADOS DE VERSÕES (TLV LLL...VAR) .................................................................................................................. 31
8.26. BIT 121 – DADOS PARA ABERTURA DE CRIPTOGRAFIA (TLV LLL...VAR) .................................................................................... 32
8.27. BIT 123 – DADOS DO SIM CARD (TLV LLL...VAR) ............................................................................................................... 32
8.28. BIT 124 - DADOS DA TRANSAÇÃO ORIGINAL ....................................................................................................................... 32
8.29. BIT 125 – DADOS SENSIVEIS CRIPTOGRAFADOS (TLV LLL...VAR) ............................................................................................ 33
8.30. BIT 127 – NSU DO AUTORIZADOR .................................................................................................................................... 33
9. FORMATO DAS TABELAS.......................................................................................................................................... 34
9.1. TABELAS EMV ................................................................................................................................................................... 34
9.2. CHAVES PUBLICAS .............................................................................................................................................................. 35
9.3. TABELAS DE PARÂMETROS .................................................................................................................................................... 35
9.3.1 TABELA DE TIMESTAMP ................................................................................................................................................ 35
9.3.2 TABELA DE ADIQUIRENTES ............................................................................................................................................. 35
9.3.3 TABELA DE PARAMETROS DO ESTABELECIMENTO ............................................................................................................... 36
9.3.4 TABELA DE BINS .......................................................................................................................................................... 37
9.3.5 TABELA DE PRODUTOS.................................................................................................................................................. 37
9.3.6 TABELA DE FUNCIONALIDADES POR PRODUTO ................................................................................................................... 38
9.3.7 TABELA DE PARAMETROS DA TRANSAÇÃO ........................................................................................................................ 38
9.4. TABELA DE TAXAS ............................................................................................................................................................... 39
9.5. TABELA DE JUROS ............................................................................................................................................................... 39
9.6. TABELA DE CONTACTLESS ..................................................................................................................................................... 39
9.7. TABELA DE BONUS .............................................................................................................................................................. 40
9.8. TABELA DE RECARGAS ......................................................................................................................................................... 40
10. APPLICATION INTERCHANGE PROFILE (AIP) ............................................................................................................. 40
11. CVM LIST ................................................................................................................................................................. 41
LTDA
12. TERMINAL CAPABILITIES .......................................................................................................................................... 42

13. FALLBACK ................................................................................................................................................................ 43
14. DETALHAMENTO DE XML ........................................................................................................................................ 43
14.1. CONFIG.XML .................................................................................................................................................................. 43
14.2. ESTABLISHMENTS_SPLIT.XML ............................................................................................................................................. 43
14.3. ESTABLISHMENTS_MULTIEC.XML ........................................................................................................................................ 44
15. FLUXOGRAMAS DE CAPTURA .................................................................................................................................. 44

15.1. LEGENDA ....................................................................................................................................................................... 44
15.2. FLUXO DE PRÉ-SELEÇÃO ................................................................................................................................................... 45
15.3. FLUXO TRANSAÇÕES TARJA ............................................................................................................................................... 46
15.4. FLUXO DE TRANSAÇÕES EMV CONTACT .............................................................................................................................. 47
15.5. FLUXO DE TRANSAÇÕES EMV CONTACTLESS ........................................................................................................................ 48
16. FORMULAS DE CÁLCULO – MODALILDADES CLIENTE................................................................................................ 49
16.1. CÁLCULO POR MARKUP .................................................................................................................................................... 49
16.1.1. DÉBITO CLIENTE .......................................................................................................................................................... 49
16.1.2. CRÉDITO Á VISTA CLIENTE ............................................................................................................................................. 49
16.1.3. CRÉDITO PARCELADO CLIENTE ....................................................................................................................................... 49
16.2. CALCULO SIMPLES ........................................................................................................................................................... 49
16.2.1. DÉBITO CLIENTE .......................................................................................................................................................... 49
16.3. CALCULO POR PRAZO MÉDIO ............................................................................................................................................ 50
16.3.1. DÉBITO CLIENTE .......................................................................................................................................................... 50
17. MENSAGENS DE TERMINAL ..................................................................................................................................... 51
17.1. CONTATO (CT) ............................................................................................................................................................... 51
17.2. CONTACTLESS (CL) .......................................................................................................................................................... 51
18. CÓDIGOS DE RESPOSTA (BIT 39) .............................................................................................................................. 52
19. AID ESPECIAIS .......................................................................................................................................................... 53
19.1. CHAMADA GETCARD POR TIPO .......................................................................................................................................... 53
19.1.1. CONTACTLESS (1ª OPÇÃO) ............................................................................................................................................ 53
19.1.2. CONTATO (1ª OPÇÃO) ................................................................................................................................................. 53
19.1.3. CONTATO (2ª OPÇÃO) ................................................................................................................................................. 53
19.1.4. EXEMPLO AID NORMAIS E ESPECIAIS ............................................................................................................................... 53
20. CONFIGURAÇÃO DAS APN’S .................................................................................................................................... 54
20.1. VIRTUEYES ..................................................................................................................................................................... 54
20.2. LYRA ............................................................................................................................................................................ 54
20.3. ALLCOM ........................................................................................................................................................................ 54
20.4. LINK SOLUTIONS ............................................................................................................................................................. 54
20.5. GRUPOCARD .................................................................................................................................................................. 55
20.6. TNS ............................................................................................................................................................................. 55
20.7. AVATEK......................................................................................................................................................................... 55
21. DETALHAMENTO DE QRCODE .................................................................................................................................. 55
22. CRIPTOGRAFIA ........................................................................................................................................................ 55

LTDA
1. Identificação
Título Especificação de mensageria

Objetivo Este documento visa estabelecer padrão na mensageria utilizada pelo POS
Estrutura Diretoria de Operações
2. Histórico de revisão
Ed. Data Histórico Elaborado por Verificado por

1.0 18/10/16 Emissão inicial Flavio Espuri Vanderlei Silva
Alteração Mensagem Financeira, Teste de Comunicação
1.1 14/11/16 Flavio Espuri Vanderlei Silva
Edição Mensagem Keep Alive
1.2 28/11/16 Alteração Mensagem Financeira Flavio Espuri Vanderlei Silva
Alteração em todas as mensagens (Inclusão do Bit 123 e
Padronização do Separador como # em todas as mensagens)
Alteração em todas as mensagens (bit 07, desfazimento (Bit 2, 7,
22, 35, 61, 121, 122 e 123), Ativação e KeepAlive (Bit 120)
Alteração em todas as mensagens (bit 07), Cancelamento e
1.5 26/12/16 Desfazimento (Bit 90), Inclusão de Item 4.9 e Anexo I, Ativação Flavio Espuri Vanderlei Silva
(inclusão do bit 18)
Alteração: 7.2 (Bit 01), 7.3 (Bit 01), 7.4 (Bit 01), 7.5 (Bit 01, 04),
7.6 (Bit 01, 04, 90), 7.7 (Bit 01, 90)
Alteração: 8
Inclusão: 8.1, 8.2, 8.3
Alteração 7.2 (Bit 61), 7.3 (Bit 61), 7.4 (Bit 61), 7.5 (Bit 61), 7.6
(Bit 61), 7.8 (Bit 61)
1.9 06/04/17 Alteração 6.6, 7.7 (bit 48), Inclusão 7.9 e 7.10 Flavio Espuri Vanderlei Silva
1.10 09/03/18 Inclusão 7.11, 7.12 e 7.13 Flavio Espuri Vanderlei Silva
Inclusão 6.1 , 6.2 , 6.8 , 7.5 , 7.6 , 7.11 , 7.18 e 8.
Alteração 6.4 , 6.5 , 6.8 , 7.3 , 7.4 , 7.7 , 7.8 , 7.9 e 7.10.
Inclusão 5.1
Alteração 6.5, 7.4
1.13 28/06/18 Inclusão Baixa Tabelas de Bins e EMV Flavio Espuri Vanderlei Silva
1.14 25/09/19 Inclusão do bit 63 e Pré autorização Erick Calegaro Flávio Espuri
Inclusão do Detalhamento de Bits e Confirmação/Desfazimento
1.15 16/12/19 Erick Calegaro Flávio Espuri
de cancelamento
Alteração de Baixa tabela de Bins para Baixa tabela de
1.16 27/12/19 Erick Calegaro Flavio Espuri
Parametros
1.17 10/02/20 Movidas informações sobre criptografia para outra documentação Erick Calegaro Flavio Espuri
1.18 06/05/20 Implementado dados de transação de Crédito parcelado Cliente Erick Calegaro Flavio Espuri
Adicionado versionamento de documentação na ISSO e alguns
ajustes na carga de tabelas
Adicionada tag no 120 para definir se é necessária uma
inicialização
1.21 28/05/20 Definida formatação do bit 62 e 63 tabela de taxas Erick Calegaro Flavio Espuri
Adicionadas novas informações no bit 120 e incluso
detalhamento de xml
1.23 10/07/20 Adicionado detalhamento de CVM List e AIP Erick Calegaro Flavio Espuri
1.24 08/09/20 Adicionado detalhamento de Multi-EC e QR Code Erick Calegaro Flavio Espuri
1.25 23/09/20 Adicionado detalhamento de Split de Origem Erick Calegaro Flavio Espuri
Adicionada configuração e detalhamento de calculo de
modalidades cliente

LTDA
Adequação de mensagens para contemplar ISSO 2.0.0 da

PagSeguro
Correção no detalhamento do cancelamento e especificação
sobre condicional do Data Element 55
1.29 20/01/21 Inclusão do Tipo no DE 63 Flavio Espuri Erick Calegaro
Correção em alguns campos e esclarecimento de Pré-
Autorização e remoção dos bits 02, 14, 18, 35, 43 e 48
Adição de novo XML para distinguir MultiEC de Split, e suporte de
carga para tema dark no terminal
Correção do detalhamento de bits com alteração do bit 90 para
LLL
Adição de fluxograma de processamento para transações de
cartão presente
Modificação em dados de confirmação financeira para contemplar
modelo de novo adquirente
Ajuste no envio dos bits para confirmação financeira durante
cancelamento
Inclusão do KCV da chave de dados para transações com
criptografia
1.37 31/05/21 Adição de modelo para recarga de celular Erick Calegaro Daniel Bruno
1. Inclusão da tabela de códigos de resposta.
2. Inclusão do detalhamento do Bit 60 para confirmação de
transações quando retornado o código de resposta P9
3. Inclusão do Bit 120.011 = 000007 para captura de
1.38 23/06/21 Lucas Ursolino Flávio Espuri
transações de boarding pass.
4. Ajuste do Bit 120.024 para envio da versão do split
5. Inclusão e reorganização dos Bit 120.026 à 029 para
envio da vesão do MultiEC.
1. Adição da descrição de envio do Bit 63.002;
2. Adição do Bitmap para mensagens de confirmação de
1.39 05/08/21 estorno (0402); Lucas Ursolino Flávio Espuri
3. Adição da Tag 030 no Bit 120 para atualização do
horário do terminal nas mensagens de Keep Alive.
1. Ajustado os campos presentes na tabela contactless;
2. Inclusão de uma nova carga no Bit 070 para inicialização
das tabelas de contactless separamente;
3. Detalhamento da formatação do Bit 125.
4. Detalhamento da formatação dos Bits 90 e 124;
5. Inclusão do campo 024 no Bit 63 para envio de
informações adicionais da transação quando coletado no
POS. Por exemplo coleta de CPF, CNPJ, código de
cupom, etc.
1.40 19/04/22 6. Inclusão do modo de entrada MSD Contactless no Bit 22 Lucas Ursolino Daniel Bruno
7. Inclusão do formato da mensagem do Comunicator CM-
HTTP (JSON)
8. Adicionado os tipos de aplicação nas Tabelas EMV.
9. Adicionado o Código de Processamento para Voucher.
10. Adicionado o Bit 123 Campo 003 para informar o
fornecedor do chip.
11. Adicionado as configurações das APN’s para cada
fornecedor
1. Inclusão da flag para habilitar logs da captura no campo
031 do Bit 120;
1.41 2. Definição das mensagens de erro de tela para captura. Lucas Ursolino Flávio Espuri
3. Inclusão do fornecedor de chip Avatek no campo 3 do Bit
123 e no detalhamento das APN’s

LTDA
3. Introdução
Este documento tem como objetivo descrever a interface para troca de mensagens entre uma Rede de Captura e um
Sistema de Autorização. O formato das mensagens trafegadas deve obedecer a norma ISO 8583 que determina os
padrões dos dados que compõem a transação.
4. Códigos e formatos utilizados neste documento
Para facilitar o entendimento das mensagens, alguns códigos serão utilizados neste:
4.1. Indicação variação de campo
Na coluna com o titulo do MTI contem os valores abaixo.
Atributo Descrição
M Campo de presença obrigatória (Mandatory)
ME Campo de presença obrigatória, igual ao valor recebido (Mandatory Echo)
O Campo de presença opcional
- Campo não está presente na mensagem
C0 Enviado em transações Financeiras/Cancelamento/Advice
C1 Enviado apenas no cancelamento
C2 Enviado apenas em transações das Modalidades Cliente
C3 Enviado apenas quando a captura do QRCode é feita pelo POS
C4 Enviado em transações de Split de Origem e MultEC
C5 Enviado apenas em transações de desfazimento
C6 Enviado apenas em transações enviadas a partir de POS
C7 Enviado em transações EMV e CTLS – Se ausente não enviar a tag
C8 Enviado apenas quando a razão do desfazimento for ‘03’
C9 Enviado apenas em transações EMV
C10 Enviado apenas quando necessário a identificação do tipo de serviço
4.2. Tamanho
A coluna de tamanho especifica o tamanho dos campos nas mensagens. Ela segue a especificação da tabela abaixo:
X Tamanho de constantes de X caracteres
LL..Var Tamanho do campo podendo variar de ‘00’ à ‘99’
LLL..Var Tamanho do campo podendo variar de ‘000’ a ‘999’
4.3. Tipo
A coluna tipo nas tabelas especifica o tipo de dados das mensagens. Ela segue a especificação da tabela abaixo:

LTDA
A Caracteres Alfanuméricos
B Dados Binários zonados: ‘00’ a ‘FF’
N Caracteres Numéricos
Z Trilha 2 do cartão
4.4. Campos Compostos (TLV)
São bits da mensagem ISO 8583 formados por subcampos que podem ou não estar presentes na mensagem,
dependendo da transação. Possuem tamanho variável e seguem um formato específico denominado TLV,
acrônimo de Tag Lenght Value, de maneira que:
T Tag Identificação do Conteudo

L Lenght Tamanho do Conteudo
V Value Conteudo propriamente dito
Desta forma, não importa em que sequência os dados são mapeados dentro da mensagem, pois todos têm
identificação e tamanho.
Os bits que utilizam esse formato estão assim formatados:
Primeiro Dado Segundo Dado ... Enésimo Dado

ID do Tamanho Dado ID do Tamanho Dado ... ID do Tamanho Dado
Dado do Dado Dado do Dado Dado do Dado
Máximo: 999 Bytes
Há dados de presença mandatória, bem como há os de presença opcional/condicional em cada mensagem. Cada
dado com a mesma identificação pode estar presente mais de uma vez dentro da mensagem
4.5. Data e hora
A coluna descrição apresenta o significado de cada Bit presente na mensagem obedecendo a norma ISO 8601. Abaixo
segue alguns formatos utilizados nesta coluna:
YYYY Ano de : 2000 – 3000
YY Ano de : 00 – 99
MM Mês de: 01 – 12
DD Dia de: 01 – 31
hh Hora: 00 – 23
mm Minuto: 00 – 59
ss Segundos: 00-59
5. Mensagem ISO
Tamanho Cabeçalho MTI Mapa de bit Dados

2 Bytes 7 Bytes 4 Bytes 32 Bytes De acordo com mapa de bits

LTDA
• Tamanho da mensagem: Deverá ser informado nos dois primeiros Bytes da mensagem o tamanho total da mensagem
incluindo os dois primeiros Bytes. Devem ser enviados em formato Little Endian e recebidos em formato Big Endian
• Cabeçalho: Será utilizado um cabeçalho em todas as mensagens para identificar qual o produto, isso irá determinar qual o
fluxo interno a mensagem irá seguir. Ex: #12345#
• MTI (Message Type Indicator): É um campo numérico de 4 digitos com propósito de identificar o tipo da mensagem enviada.
• Mapa de Bits: Representação em Hexadecimal referente ao mapa de bits da transação
• Dados: Representação em ASCII das informações referente a transação.
5.1. Tipo de MTI
MTI Descrição
0xxx Versão da ISO 8583
x1xx Classe da Mensagem
xx1x Função da Mensagem
xxx0 Origem da Comunicação
5.2. Classe de Mensagens
Posição Mensagem
x1xx Autorização
x2xx Financeira
x4xx Desfazimento / Cancelamento
x8xx Rede
5.3. Função da Mensagem
Posição Mensagem
xx0x Request
xx1x Request Response
xx2x Advice
xx3x Advice Response
5.4. Origem da Mensagem
Posição Mensagem
xxx0 Acquirer
xxx1 Acquirer Repeat
xxx2 Issuer
xxx3 Issuer Repeat

LTDA
o Exemplo de uma mensagem 0800

▒.#00002#08008238000000C00008040000000000002009241716080000001716080924001170328003631800
000059407450000146016001002010020020100104000102089550532180036184104002008CLARO BR
Tamanho em ASCII
Cabeçalho
MTI
Mapa de Bit
Dados
6. Definição de fluxo de mensagem
6.1. Solicitação de Pré Autorização
Terminal Paynet
Request – MTI 0100
Response – MTI 0110
6.2. Confirmação de Pré Autorização
Terminal Paynet
6.3. Adivce
Terminal Paynet
6.4. Financeira
Terminal Paynet
6.5. Cancelamento
Terminal Paynet
6.6. Rede
Terminal Paynet

LTDA
6.7. Recarga de Celular
6.7.1 Recarga Aprovada

Terminal Paynet
Consulta Numero – MTI 0800
Bonus + Recargas – MTI 0810
Transação Financeira – MTI 0200
Solicita Recarga – MTI 0800
Confirma Recarga – MTI 0810
Confirmação financeira – MTI 0202
Confirmação Financeira – MTI 0212
6.7.2 Recarga Negada

Terminal Paynet
Solicitação de Recarga – MTI 0800
Confirmação de Recarga – 0810
Desfazimento financeiro – MTI 0420
Desfazimento Financeiro– MTI 0212
6.7.3 Transação Negada

Terminal Paynet
Transação Financeira – 0210
6.7.4 Transação negada 2nd GEN

Terminal Paynet
Falha no 2nd Gen AC Transação Financeira – MTI 0210
Desfazimento financeiro – MTI 0420
Desfazimento Financeiro– MTI 0212
6.7.5 Consulta Negada

Terminal Paynet
Bonus + Recargas – 0810

LTDA
6.8. Subtipos
MTI Bit 70 Descrição

0800 001 Teste de Comunicação
0800 002 Inicialização
0800 003 Keep Alive
0800 004 Abertura
0800 005 Fechamento
0800 006 Carregar Entrega
0800 061 Carregar Tabela EMV e Chaves Publicas
0800 062 Carregar Tabela de Bins
0800 063 Carregar Tabela de Parâmetros
0800 064 Carregar Tabela de Taxas e Juros
0800 065 Consulta Numero/Bonus/Recargas
0800 066 Recarga de celular
o Teste de Comunicação: utilizado para testar a comunicação entre o terminal e a Paynet

o Ativação: utilizado para realizar a ativação do terminal para possibilitar efetuar transações financeiras.
o Keep Alive: Mensagem enviada periodicamente, determinada pelo terminal com a função de verificar
disponibilidade e versão de listas e aplicação conforme Anexo I
o Abertura: Utilizado para realizar a abertura de sessão.
o Fechamento: Utilizado para realizar o fechamento de sessão.
o Carregar Entrega: Utilizado para carregar a lista de entregas disponíveis.
o Carregar Tabela EMV e Chaves Publicas: Utilizado para baixar as aplicações EMV aceitas e as chaves para
criptografia DDOL
o Carregar Tabela de Bins: Utilizado para carregar o range de bins e enviar o código da Bandeira
o Carregar Tabela de Parâmetros: Utilizado para descer todas as validações de regras do Adiquirente
o Carregar Tabela de Taxas e Juros: Utilizado para carregar as taxas e juros possíveis nas Modalidades cliente
o Consulta Numero/Bonus/Recarga: Utilizado para validar se o numero digitado é valido e carregar as tabelas de
bônus e recargas disponíveis para ele
o Recarga de Celular: Envia a solicitação de recarga para a retaguarda paynet encaminhar ao responsavel
6.9. Transações de desfazimento
A transação de desfazimento é uma mensagem utilizada para informar que a resposta de uma solicitação não foi
recebida devidamente. Neste caso a Paynet elimina a pendência da transação e considera-a como transação não
concluída. A mensagem de desfazimento é gerada automaticamente pelo terminal. O desfazimento deve ser gerado
para transações que possuem o MTI 0200 e 0400.
Terminal Paynet
Response MTI – 0210
Terminal Paynet

LTDA
6.10. Transações de Confirmação
A transação de confirmação é uma mensagem utilizada para informar que a resposta de uma solicitação foi recebida
e autorizada devidamente. Neste caso a Paynet elimina a pendência da transação e considera-a como transação
concluída. A mensagem de confirmação é gerada automaticamente pelo terminal. A confirmação deve ser gerado para
transações que possuem o MTI 0200 e 0400. Podendo as transações 0202 serem retornadas com o código “P9”,
indicando que devem ser confirmadas durante a próxima transação financeira(0200), ou cancelamento(0400).
Terminal Paynet
Terminal Paynet
7. Mensagens
7.1. ISO
Data Element Type Size Description

1 B 32 Bitmap
3 N 6 Código de processamento
4 N 12 Valor da transação
7 N 10 Data e hora (YYMMDDhhmm)
11 N 6 NSU do terminal
12 N 6 Hora local da transação (hhmmss)
13 N 4 Data local da transação (MMDD)
19 N 3 Código de país do adiquirente
22 N 3 Modo de entrada
23 N 3 PAN Sequence Number
38 N 6 NSU do HOST
39 AN 2 Código de resposta
41 AN 16 Numero de série do terminal
42 N 20 CNPJ/CPF do estabelecimento commercial
49 N 3 Código da Moéda
52 B 16 PIN Block
55 AN LLL Tags EMV
60 ANS LLL Dados de confirmação da ultima transação
61 ANS LLL Informações do Ponto de Venda
62 ANS LLL Mensagens do HOST/Comprovante Lojista
63 ANS LLL Dados adicionais da transação
67 N 2 Numero de parcelas
70 N 3 Código de gerenciamento
90 AN LLL Dados da transação Original
118 AN LLL Forma de Pagamento
120 ANS LLL Detalhamento de Versões
121 AN LLL Dados para criptografia
123 ANS LLL Dados do SIM Card
124 ANS LLL Comprovante do Cliente
125 B LLL Dados sensiveis da transação
127 AN LLL NSU adiquirente

LTDA
7.2. Comunicator CM-HTTP (JSON)
Data Type
Element
2 overPan
3 processCode
4 Amount
7 Date
11 nsuRede
12 localHour
13 localDate
14 validDate
18 merchantType
19 countryCode
22 entryMode
23 panSeq
35 trackData
37 authorizeNsu
38 authorizeCode
39 responseCode
41 terminalId
42 establishmentId
45 trackOne
48 additionalData
49 currencyCode
52 pinBlock
55 emvData
60 lastTransactionData
61 infoPointService
62 acquirerMessage
63 additionalDataAuthorizerTwo
67 numberInstallment
70 managementCode
90 originalDataTransaction
118 paymentMethod
120 versionDetail
121 Ksns
123 simcardData
124 acquirerMessageTwo
125 encryptedData
127 acquirerNsu

LTDA
7.3. Teste de comunicação
Bit 0800 0810 Tamanho (bytes) Tipo Descrição

1 M M 32 B Mapa de bits
7 M M 10 N Data e hora GMT (MMDDhhmms)
11 M ME 6 N NSU da Rede de Captura
12 M ME 6 N Hora local (hhmmss)
13 M ME 4 N Data local (MMDD)
Código de resposta retornado pela rede
39 - M 2 A
00 = OK
41 M ME 16 A Identificação do terminal
42 M ME 20 A Código do estabelecimento
O bit 61 contém informações do ponto de venda
61 M - LLL.999 N estruturadas em formato TLV
(Ver detalhamento de bits)
Descrição da mensagem com @ para quebra de
62 - M LLL..999 A
linha
Código de gerenciamento de Rede de Captura = 001
70 M - 3 A
O bit 123 contém informações do SIM CARD
123 O - LLL…999 A estruturadas em formato TLV
(Ver detalhamento de Bits)
7.4. Keep Alive

Código de resposta retornado pela rede
39 - M 2 A
00 = OK
(Ver Detalhamento de bits)
Descrição da mensagem com @ para quebra de
62 - M LLL..999 A
linha
70 M - 3 A
O bit 120 contém informações das versões do
120 M M LLL…999 A terminal estruturadas em formato TLV
O bit 123 contém informações do SIM CARD

LTDA
7.5. Ativação

18 - M 4 N Ramo de Atividade do Estabelecimento
19 - M 3 N Código do País
Código de resposta retornado pelo emissor
39 - M 2 A
00 = OK
62 - M LLL..999 A Descrição da mensagem com # para quebra de linha
70 M - 3 A
120 M M LLL…999 A estruturadas em formato TLV
7.6. Baixa tabela de Aplicações EMV e Chaves Publicas

39 - M 2 A Código de resposta - 00 = OK
0800 = Index de tabela atual
62 M M LLL..999 A
0810 = Tabelas EMV
63 - O LLL..999 A Tabelas EMV
70 M ME 3 A
120 M - LLL…999 A estruturadas em formato TLV
O bit 123 contém informações do CHIP estruturadas
123 O - LLL…99 A em formato TLV

LTDA
7.7. Baixa tabela de parâmetros

0800 = ID da tabela e Index de tabela atual
62 M M LLL..999 A (Ver detalhamento de bits)
0810 = Tabela de parametros
63 - O LLL..999 A Tabela de parametros
70 M ME 3 A
127 - M LLL..999 N Timestamp (AAAAMMDDhhmm)
7.8. Baixa tabela de Taxas e Juros

0800 = Tipo e Index de tabela atual
000 – Juros
62 M M LLL..999 A 001 – Taxas
0810 = Tabela de Taxas/Juros
63 - O LLL..999 A Tabela de Taxas/Juros
70 M ME 3 A

LTDA
7.9. Baixa tabela de Bonus e Recargas

0800 = Tipo e Index de tabela atual
000 – Bonus
62 M M LLL..999 A 001 – Recargas
0810 = Tabela de Bonus/Recargas
63 - O LLL..999 A Tabela de Bonus/Recarga
70 M ME 3 A
7.10. Solicitação de Recarga

Comprovante de recarga com @ para quebra de
62 - M LLL..999 A linhas ou mensagem de erro
VIA LOJISTA
70 M ME 3 A
Comprovante de recarga com @ para quebra de
124 - O LLL…999 ANS linhas
VIA CLIENTE

LTDA
7.11. Solicitação de Pré-Autorização
Tamanho
Bit 0100 0110 Tipo Descrição
(bytes)
1 M M 32 B Mapa de BITS
3 M ME 6 N Código de processamento
4 M ME 12 N Valor total da Transação
11 M ME 6 N Número de Identificação da Transação na Loja
12 M M 6 N Hora local (hhmmss)
Modo de Entrada
22 M - 3 N
Número de Sequência do Cartão
23 O - 3 N
*Presente se Transação efetuada com chip
Código de Autorização da Transação
38 - O 6 A
*Presente se solicitação foi aprovada bit(39=00)
Código de Resposta da Transação
39 - M 2 A = 00 – Aprovada
≠00 – Negada
41 M ME 16 A Identificação do Terminal
42 M ME 20 A Código do Estabelecimento
49 M ME 3 N Código da Moeda
Senha (PIN)
52 O - 16 A
*Presente se solicitado o PIN online.
55 C9 C9 LLL ..999 A TAGs EMV
62 - M LLL ..999 A Descrição da mensagem com @ para quebra de linha
O bit 63 contém dados adicionais da transação
63 M M LLL..999 A estruturadas em formato TLV
67 O - 2 N Numero de Parcelas
O bit 121 contém informações para a criptografia
121 M - LLL...999 N estruturadas em formato TLV
124 - O LLL…999 A Descrição da mensagem com @ para quebra de linha
Dados sensíveis da transação criptografados
125 M - LLL…999 A
NSU do Adiquirente
127 - M LLL...999 N Codigo Adquirente
Ex XXXXXXXXXXXX

LTDA
7.12. Confirmação de Pré Autorização
Tamanho
Bit 0220 0230 Tipo Descrição
(bytes)
1 M M 32 B Mapa de BITS
4 M ME 12 N Valor total da Transação
11 M ME 6 N Número de Identificação da Transação na Loja
12 M M 6 N Hora local (hhmmss)
Modo de Entrada
22 M - 3 N
Número de Sequência do Cartão
23 O - 3 N
*Presente se Transação efetuada com chip
Código de Autorização da Transação
38 - O 6 A
*Presente se solicitação foi aprovada bit(39=00)
Código de Resposta da Transação
39 - M 2 A
= 00 – Aprovada
41 M ME 16 A Identificação do Terminal
42 M ME 20 A Código do Estabelecimento
49 M ME 3 N Código da Moeda (986 – Real)
Senha (PIN)
52 O - 16 A
*Presente se solicitado o PIN online.
55 C9 C9 LLL ..999 A TAGs EMV
67 O - 2 N Número de parcelas 01 a 99 se crédito parcelado
Código de gerenciamento de Rede de Captura, a ser
70 M ME 3 A
definido default=000
Dados da Transação Original a ser confirmada
90 M - 32 N
118 M - LLL...999 A Forma de Pagamento = 01 - Cartão
O bit 121 contém informações para criptografia
Dados sensíveis da transação
125 M - LLL…999 A
NSU do Adiquirente
Ex XXXXXXXXXXXX

LTDA
7.13. Financeira

4 M ME 12 N Valor da transação Total da Transação
Modo de entrada
22 M - 3 N
Card Sequence Number/PAN Sequence
23 O - 3 N
*Presente nas transações FULL EMV (chip)
Código de Autorização – Presente se transação
38 - O 6 A
aprovada
39 - M 2 A
00 = OK
49 M ME 3 N Código da Moeda EX 986 - Real
52 O - 16 A Senha do cartão criptografada.
55 C9 C9 LLL..999 A Dados EMV.
Dados de confirmação da transação anterior quando
60 O - LLL…999 ANS
presentes
62 - M LLL..999 A Descrição da mensagem com @ para quebra de linha
70 M - 3 A
118 M - LLL...999 A Forma de Pagamento = 01 - Cartão
120 M M LLL…999 A estruturadas em formato TLV
124 - M LLL..999 A Descrição da mensagem com @ para quebra de linha
125 M - LLL…999 A
NSU do Adiquirente
Ex XXXXXXXXXXXX

LTDA
7.14. Cancelamento

4 M ME 12 N Bit 04 da transação original
Modo de entrada
22 M - 3 N
23 O - 3 N
Presente nas transações FULL EMV (chip)
Código de Autorização – Presente se transação
38 - O 6 A
aprovada
39 - M 2 A
00 = OK
49 M ME 3 N Código da Moeda EX 986 – Real
55 C9 C9 LLL..999 A Dados EMV.
Dados de confirmação da transação anterior quando
60 O - LLL…999 ANS
presentes
62 - M LLL…999 A Descrição da mensagem com @ para quebra de linha
0400 – O bit 63 contém dados adicionais da
transação estruturadas em formato TLV
63 M O LLL…999 AN
0410 – NSU do HOST Paynet
70 M ME 3 A
Dados da Transação Original que deve ser
90 M - 32 N cancelada:
124 M O LLL…999 A Descrição da mensagem com @ para quebra de linha
125 M - LLL…999 A
Codigo Adquirente
127 - M LLL...999 N NSU do Adiquirente
Ex XXXXXXXXXXXX

LTDA
7.15. Desfazimento

3 M ME 6 N Código de processamento da transação origina
4 M ME 12 N Bit 04 da transação original
BIT 22 da transação original
22 M - 3 N
39 - M 2 A
00 = OK
49 M ME 3 N BIT 49 da transação original
70 M ME 3 A
Dados da Transação Original que deve ser cancelada
90 M - 32 N
NSU do Adiquirente
Ex XXXXXXXXXXXX
7.16. Confirmação de Transação e Estorno
0202 0212
Bit Tamanho (bytes) Tipo Descrição
0402 0412
3 M ME 6 N Código de processamento da transação original
Codigo de resposta do Autorizador
39 - M 2 N ‘P9’ em casos de confirmação na próxima transação,
ou cancelamento
42 O O 20 A Código do estabelecimento
Dados da Transação Original que deve ser confirmada
124 M - LLL..999 N

LTDA
7.17. Advice

4 M ME 12 N Valor da transação Total da Transação
Hora local (hhmmss)
12 M ME 6 N
*BIT 12 da transação negada.
13 M ME 4 N Data local (YYMMDD)
Modo de entrada
22 M - 3 N
23 O - 3 N
Código de Autorização
38 M O 6 A
*Preencher com o conteúdo do bit 11
39 M M 2 A *Preencher com o código de resposta
49 M ME 3 N Código da Moeda EX 986 – Real
Preenchido com 0’s por causa da confirmação de pre
52 M - 16 N autorização
(Remover futuramente)
CVC do cartão utilizando a mesma criptografia da
53 O - 16 B
senha
Dados Chip.
55 M M LLL…999 A
62 - - LLL..999 A Descrição da mensagem com @ para quebra de linha
70 M ME 3 A
118 M - LLL...999 A Forma de Pagamento = 01 – Cartão
O bit 121 contém informações para
121 M - LLL...999 N criptografiaestruturadas em formato TLV
Dados ensiveis da transação
125 M - LLL…999 A
NSU do Adiquirente
Ex XXXXXXXXXXXX

LTDA
8. Detalhemaneto dos bits da mensagem
8.1. BIT 001 – Bitmap
O bitmap é um campo que indica se outros elementos de dados ou subcampos de elementos de

dados estão presentes em outro lugar na mensagem.
Um campo é considerado presente apenas quando o bit correspondente no bitmap é definido. Por
exemplo, um hexadecimal com valor 82 (decimal 130) é binário 1000 0010 , o que significa que os
campos 1 e 7 estão presentes na mensagem e os campos 2, 3, 4, 5, 6 e 8 não.
8.2. BIT 003 – Código de processamento
Tag JSON: processCode

002000 – Débito a vista
002010 – Débito a vista Cliente
003000 – Crédito a vista
003010 – Crédito a vista Cliente
003100 – Crédito parcelado loja
003800 – Crédito parcelado emissor
003300 – Crédito parcelado cliente
003400 – Solicitação de Pré-Autorização
003500 – Confirmação de Pré-Autorização
003600 – Cancelamento de Pré-Autorização
002400 – Cancelamento
004000 – Voucher
8.3. BIT 004 – Valor Autorizado
Tag JSON: amount
Valor total da transação em centavos. Também permite retornar o saldo do cliente na transação de
consulta.
8.4. BIT 007 – Data e Hora da Transação
Tag JSON: date
Data e horário GMT da transmissão no formato MMDDHHMMSS.
8.5. BIT 011 – Numero Sequencial Único da Transação (NSU)
Tag JSON: nsuRede
Número de identificação da transação no equipamento com padding de 0’s a esquerda.

Este campo deve permanecer o mesmo durante todo o processamento da operação em tratamento,
e deve ser queimado a cada transação, seja ela aprovada ou não.

LTDA
8.6. BIT 012 – Hora Local
Tag JSON: localHour
Hora local da transação no formato HHMMSS.
8.7. BIT 013 – Hora Local
Tag JSON: localDate
Data local da transação no formato MMDD.
8.8. BIT 022 – Modo de entrada
Tag JSON:entryMode
011 – Cartão digitado

021 – Tarja PIN Online
028 – Tarja sem PIN
051 – EMV Contato PIN Online
059 – EMV Contato PIN Offline
071 – EMV Contactless PIN Online
078 – EMV Contactless sem PIN
801 – Fallback Magnetico
911 – MSD Contactless PIN Online
918 – MSD Contactless sem PIN
8.9. BIT 023 – PAN Sequence Number
Tag JSON: panSeq
Presente em transações Chip EMV e Contactless. Contém o mesmo valor da tag EMV 5F34 e está
justificado para a direita com zeros ASCII à esquerda.
Obs.: A tag 5F34 deve ser removida do bit 55 antes da financeira ser enviada
8.10. BIT 038 – NSU do HOST Paynet
Tag JSON: authorizeCode
NSU gerado pelo HOST Paynet para a operação em tratamento. (Pode ser consultado no Gestor)
8.11. BIT 039 – Código de Resposta
Tag JSON: responseCode
Código de resposta da transação atribuída pela rede adquirente, ou código administrativo em caso
de erro na plataforma SPR.
Verifique a tabela Códigos de resposta (Bit 39) para mais informações.

LTDA
8.12. BIT 041 – Numero de Serie
Tag JSON: terminalId
Numero de série do terminal que efetuou a solicitação ao HOST com preenchimento de 0’s a
esquerda.
8.13. BIT 042 – Documento do Estabelecimento Comercial
Tag JSON: establishmentId
Este código é único e identifica a loja que está enviando a transação ao HOST. Deve ser preenchido
com padding de 0’s a esquerda
8.14. BIT 049 – Código da Moeda
Tag JSON: currencyCode
Código da moeda do país em que a transação foi efetuada. Deve seguir o que foi recebido do ISM
na ativação/tabela de parametros.
8.15. BIT 052 – PIN Block
Tag JSON: pinBlock
Senha criptografada, para transações com cartões que requerem PIN online.
8.16. BIT 055 – Dados EMV
Tag JSON: emvData
Tags EMV em transações feitas com processamento de Contato e Contactless. O conteúdo deste
campo está de acordo com o formato BER-TLV.
8.17. BIT 060 – Dados da transação original para confirmação (0200)
Tag JSON: lastTransactionData
Dados originais da transação enviado em transações financeiras (MTI 0200) para confirmação
quando retornado o código de resposta P9 na mensagem 0212.
Posição Tipo Tamanho Descrição

00 M 04 MTI da transação original
04 M 06 Bit 11 da transação original
20 M 12 BIT 127
32 C LLL Var Tags EMV geradas do 2nd

LTDA
8.18. BIT 061 – Dados do Ponto de Venda (TLV LLL...Var)
Tag JSON: infoPointService
ID Tipo Formato Meio de Captura e Conexão

01 - POS
M 02 - TEF
001 N
03 - Mobile
04 - E-Commerce
01 – GPRS
002 M N 02 – WIFI
03 – 3G
8.19. BIT 062 – Comprovante Lojista/Indices e Tipos das Tabelas
Tag JSON: acquirerMessage
Em transações financeiras é recebido neste campo o comprovante de venda da via do Lojista.

No caso da tabela de EMV deve ser enviado XXX sendo:
XXX = Index da tabela atual
No caso das tabela de parametros, taxas ou recarga deve ser enviado no formato XXXZZZ sendo:
XXX = ID da tabela
ZZZ = Index da tabela atual
ID’s Utilizados atualmente:
Parametros:
000 – Tabela de Timestamp
001 – Tabela de dados do Adiquirente
002 – Tabela de dados do Estabelecimento
003 – Tabelas de BINS
004 – Tabelas de Produtos
005 – Tabelas de Funcionalidades
006 – Tabelas de Parâmetros
007 – Tabelas Contactless
Taxas:
000 – Tabela de Juros
001 – Tabela de Taxas
Recarga:
000 – Tabela de Recarga
001 – Tabela de Bonus
O index atual corresponde a um numero de 3 bytes entre 000 e 999

Obs.: No retorno da baixa de tabelas/parametros os tipos e versões seguem o mesmo formato.

LTDA
8.20. BIT 063 – Dados Adicionais da transação (TLV LLL...Var)
Tag JSON: additionalDataAuthorizerTwo
ID Tipo Formato Descrição

001 C0 A CardHolder
Bandeira
O valor corresponde ao primeiro campo
recebido na tabela de produtos.
Deve estar presente nas seguintes
002 C0 N mensagems:
• 0100;
• 0200;
• 0400;
• 0420;
003 C0 AN Pan Truncado
004 C1 N Cod Processamento (Cancelamento)
005 C2 N(5) Taxa de Retorno (Parcelado Cliente)
006 C2 N(12) Valor Liquido (Parcelado Cliente)
007 C2 A(5) Versão das taxas (Parcelado Cliente)
008 C3 N Código do QR (QR Code)
009 C4 N CNPJ do EC de origem
Modo de calculo Cliente
01 – Calculo por Prazo Médio
010 C2 N
02 – Calculo por Markup
03 – Calculo Simples
Razão do Desfazimento
02 - Timeout na resposta da compra
03 - Transação negada pelo cartão de
CHIP após resposta do autorizador
04 - Cartão de Chip removido durante
011 C5 N
fluxo de compra
05 - Terminal desligado durante o fluxo de
compra
06 - Falha de conexão
07 - Falha na interpretação dos dados
Tipo de dispositivo do portador
00 - Cartão
01 - Smartphone
02 - Chaveiro
012 C6 N 03 - Relógio
04 - Mobile Tag
05 - Pulseira
06 - Case/Sleeve
10 - Tablet ou e-reader
Versão da especificação do pinpad em
013 C6 ANS uso para a
transação;
014 C6 ANS Versão do kernel EMV Contato
Versão principal do Kernel EMV para
015 C7 ANS
CTLS
Versão do Kernel EMV CTLS para
016 C7 ANS
cartões MasterCard PayPass.
017 C7 ANS
cartões VISA PayWave.
018 C7 ANS
cartões American Express.
019 C7 ANS
cartões Discover.
020 C7 ANS
cartões Pure.
LTDA
Tipo de Serviço
00 – Pagamento de Boleto
021 C10 N 01 – Consulta PF/PJ
02 – Consulta Placa
03 – Recarga de Celular
Versão da aplicação básica nos pinpads
022 C0 ANS BC. Formato: VVV.VV AAMMDD” (com 3
espaços à direita).
Versão da especificação do pinpad em
023 C0 ANS
uso para a transação; Ex: 1.08; 2.03;
Dado adicional da transação coletado no
024 O AN POS.
Ex.: CPF, CNPJ, código de cupom, etc.
8.21. BIT 067 – Numero de Parcelas
Tag JSON: numberInstallment
Número de parcelas da compra
8.22. BIT 070 – Tipo da mensagem
Tag JSON: managementCode
001 – Teste de Comunicação

002 – Ativação
003 – Keep Alive
061 – Baixa tabela EMV
062 – Baixa tabela de BINs
063 - Baixa tabela de parametros
064 – Baixa tabela de Taxas e Juros
065 – Baixa tabela contactless
8.23. BIT 090 – Dados da Transação Original
Tag JSON: originalDataTransaction

00 M 04 MTI da transação original
04 M 06 NSU da transação original
• Em caso de
desfazimento
(0420) utilizar o
DE 11 da
transação original
(0200);
• Em caso de
estorno (0400)
utilizar o DE 63 da
transação original
(0210);

20 M 12 BIT 127
32 C8 LLL Tags EMV geradas do 2nd

LTDA
8.24. BIT 118 – Forma de Pagamento
Tag JSON: paymentMethod
01 – Cartão
02 – Dinheiro
8.25. BIT 120 – Dados de versões (TLV LLL...Var)
Tag JSON: versionDetail
ID Formato Descrição e Valor

BIN
001 A
9.999
LabelPOS
002 A
9999
Menus
003 A
9.999
Languages
004 A
9.999
Config_xml
005 A
9.999
Images_xml
006 A
9.999
Images_show
007 A
1;2;3;4;5;6
Images_backgroud
008 A
9.999
App
009 A
9.999
S.O
010 A
9.9.9.999
Type_products
00001 – Frota
00002 – Delivery Pay
00003 – Captura Generica
011 A
00004 – Multi-EC
00005 – QR Code
00006 – Split de Origem
00007 – Captura Boarding Pass
update_host
012 A
ftp://xxx.xxx.xxx
update_port
013 A
xxxx
update_username
014 A
xxxxx
update_directory
015 A
xxxxx
update_password*Senha criptografada
016 A retornada na 0810 enviado somente
quando determinado pelo host
017 A KSN Dados Password
018 A CNPJ do SubAdquirente
019 A Versão das tabelas EMV
020 A Versão tabelas de Taxas e Juros
021 A Versão da Documentação
022 N NeedsInicialization(Boolean)
023 A ModeloPOS
024 A Versão do Split
025 N Modo de calculo Cliente
LTDA
01 – Calculo por Prazo Médio

02 – Calculo por Markup
03 – Calculo Simples
026 A Versão Multi EC
Numero de Celular a ser enviado para a
retaguarda
027 N DDNNNNNNNNN
D - DDD da Cidade
N - Numero do celular
N ID interno da Recarga de celular com 6
028
digitos
N Valor selecionado para a recarga com 12
029
digitos
Timestamp para atualização de horário no
terminal.
030 N • Formato: YYYYMMDDHHMMSS
• Condição:Presente nas
mensagens 0810 de Keep Alive.
Habilitar logs da captura
031 N • 0 – Desabilitar;
• 1 – Habilitar;
8.26. BIT 121 – Dados para abertura de criptografia (TLV LLL...Var)
Tag JSON: ksns
ID Tipo Formato KSN

001 M AN KSN Dados
002 O AN KSN PIN
003 O H KCV MK Dados
8.27. BIT 123 – Dados do SIM Card (TLV LLL...Var)
Tag JSON: simcardData
ID Tipo Formato Chip e Operadora

001 O A Chip
002 O A Operadora
Fornecedor
001 – Virtueyes
002 – Lyra
003 – Allcom
003 O N3
004 – Link Solutions
005 – GrupoCard
006 – TNS
007 – Avatek
8.28. BIT 124 - Dados da Transação Original
Tag JSON: acquirerMessageTwo
Acrescido de 001 no inicio para transações de Tarja, ou 002 em transações EMV

Ex.: 126002120
126 – Tamanho total do bit
002 – Tipo de dados presentes no bit
120 – tamanho total dos dados
XXX... – Dados presentes
LTDA

BIT 63 da transação em tratamento
01 M 06
(0210)
07 M 10 Bit 07 da transação em tratamento
18 M 12 Bit 127 da transação original(Pad 0’s)
31 O LLL.999 TAG’s EMV 2ºG AC
8.29. BIT 125 – Dados Sensiveis Criptografados (TLV LLL...Var)
Tag JSON: encryptedData
Este bit deve ser formatado conforme apresentado na tabela abaixo e enviado de forma criptografada por completo
para o autorizador. Caso algum dos campos abaixo não seja informado na transação pelo portador ou durante a
leitura do cartão, o campo respectivo deverá ser enviado com tamanho zero.
ID Tipo Formato Dados

PAN M N Numero do PAN
TR1 M N Trilha 1 do Cartão
TR2 M AN Trilha 2 do Cartão
DTV M N Data de Validade
Codigo de validação
• Presente: Valor digitado no terminal
o Ex.: CVV003XXX
• Ilevígel: 1
CVV M N o Ex.: CVV0011
• Inexistente: 0
o Ex.: CVV0010
• Não solicitado: n/a
o Ex.: CVV000
Padding de F’s
PAD O A
O tamanho total do Bit 125 deve ser múltiplo de 8.
Ex.: PAN0165413330089020037TR1000TR20335413330089020037=2512101050930812DTV0042512CVV003123FF
• PAN 016 5413330089020037
• TR1 000
• TR2 033 5413330089020037=2512101050930812
• DTV 004 2512
• CVV 003 123
• FF
8.30. BIT 127 – NSU do Autorizador
Tag JSON: acquirerNsu
NSU gerado pelo autorizador do cartão que aprovou a operação em tratamento. O NSU é único por
Semana por cliente (um cliente com mais de um número lógico tem apenas um contador)

LTDA
9. Formato das tabelas
9.1. Tabelas EMV
Posição Tamanho Tipo Descrição Exemplo

0 3 N Tamanho da Tabela 314
3 1 N ID da tabela 1
4 2 N ID do adiquirente 04
6 2 H Indice do registro 13
8 2 N Tamanho do AID 07
10 32 H AID da aplicação A0000000043060000000000000000000
TIPO ______________DESCRIÇÃO______________
01 Crédito
42 2 N Tipo de aplicação
02 Débito
03 Voucher
44 16 AN Etiqueta da aplicação “MAESTRO “
60 2 N Padrão da aplicação 03
62 4 H Aplication Version – 1 0002
74 3 N Terminal Country Code 076
77 3 N Currency Code 986
80 1 N Currency Exponent 2
81 15 AN Merchant Identifier “ “
96 4 N Merchant Category Code 5992
100 8 A Terminal Identification 80042448
108 6 H Terminal Capabilities E0D0C8
114 10 H Adc Terminal Capabilities 6000F0A001
124 2 N Terminal Type 22
126 10 H Terminal Action Code – Default FE50BCA000
136 10 H Terminal Action Code – Denial 0000000000
146 10 H Terminal Action Code – Online FE50BCF800
156 8 H Terminal Floor Limit 00000000
164 1 AN Transaction Category Code R
165 1 AN CTLS Zero AM 0
166 1 AN CTLS MODE 4
167 8 H CTLS Transaction Limit 000F4240
175 8 H CTLS Floor Limit 00000000
183 8 H CTLS CVM Required Limit 00001387
191 4 H CTLS App version 0001
195 1 N Reservado para uso future 0
196 40 H TDOL 9F02065F2A029A039C0195059F37040000000000
236 40 H DDOL 9F37040000000000000000000000000000000000
276 2 A Resp. Code – Offline Aproved Y1
278 2 A Resp. Code – Offline Declined Z1
Resp. Code Advice – Offline
280 2 A Y3
Aproved
Resp. Code Advice – Offline
282 2 A Z3
Declined
CTLS - Terminal Action Code –
284 10 H FC501C8800
Default
294 10 H 0000800000
Denial
304 10 H FC501C8800
Online
LTDA
314 314 AN Filler // É esperado que este campo não venha
9.2. Chaves Publicas

0 3 N Tamanho total da tabela 611
3 1 N ID da tabela de chaves 2
6 2 H Indice da tabela 25
RID – Registered App Provider
8 10 H A000000537
Identifier
Certification Authority Public
18 2 H 10
Key Index
Indice da chave no SAM
20 2 H 00
Advantis
Tamanho do Certification
22 1 N 3
Authority PK Exponent
Certification Authority PK
23 6 H 010001
Exponent
Tamanho do Certification
29 3 N 176
Authority PK Modulus
D9E36579B94A5FF3150B64643D85C06E6E9F0682
BE56CDD69FCB053913495BDBC327DA3CAC0EA2A0
DA1D55DF7C66A0C6F6A9039FA72753C434F4A63B
ED54062799DF1F6D6E1F315A8F4109721126E11F
4FF562C18A4AE6A4D9F0C2A5C2A8E44D6A98628C
7E25290584F0F3D9ECE6566FDB7688596649BEC8
Certification Authority PK
32 496 H 9ª1CBC8BBED075538300D0D83FF8755E1CE73668
Modulus
908C387E14ACDF0F9F1DE436A5A07308812D6AE3
A16170EDF2522B36FBE94358F50C0B6900000000
0000000000000000000000000000000000000000
0000000000000000000000000000000000000000
0000000000000000000000000000000000000000
0000000000000000
Status do Check Sum ( Hash
528 1 N 1
SHA-1)
Certification Authority PK Check
529 48 H cab294998338e09255d25023e3dbb6e217e174a100000000
Sum
577 2 N Indice da Master Key 00
579 32 H Working Key 00000000000000000000000000000000
9.3. Tabelas de parâmetros
9.3.1 Tabela de Timestamp

Posição Tamanho Tipo Descrição Detalhamento
0 8 N Data Atual AAAAMMDD
8 6 N Hora Atual hhmmss
9.3.2 Tabela de Adiquirentes

0 3 N Código do Adiquirente Código do adiquirente conforme cadastrado no Gestor
3 20 A Nome do Adiquirente Nome do adiquirente conforme cadastrado no Gestor

LTDA
9.3.3 Tabela de Parametros do Estabelecimento

0 38 A Nome do EC Pode ser utilizado em comprovantes Offline
38 38 A Endereço do EC Linha 1 do Endereço – Pode ser utilizada em comprovantes
76 38 A Endereço do EC Linha 2 do Endereço
114 4 A Simbolo da moeda Pode ser utilizado para impressão do comprovante Offline
118 3 N Código da Moeda Tag 5F2A
121 1 N Exponencial da moeda Tag 5F36
122 3 N Código do País Tag 9F1A
125 4 N MCC Tag 9F15
BIT _______________DESCRIÇÃO_______________
8 Permite entrada manual do PAN
7 Permite CHIP
6 Permite fallback magnético
129 2 H Parametros Geráis – Byte 1 5 Permite fallback digitado
4 Transação digitada solicita CVV2/CVC2
3 Transação 36agnética solicita CVV2/CVC2
2 Permite CVV2/CVC2 inexistente ou ilegivel
1 Reservado para uso futuro
BIT _______________DESCRIÇÃO_______________
8 Criptografar numero do cartão – Uso futuro
7 Transação maagnetica solicita 4 ultimos dígitos
131 2 H Parametros Geráis – Byte 2 5 Permite offline EMV – Uso futuro
4 Permite captura por meio de SSL – Uso futuro
133 2 H Parametros Geráis – Byte 3 Reservado para uso futuro

LTDA
9.3.4 Tabela de Bins

0 10 N Bin inicial do range Corresponde ao BIN inicial do range
10 10 N Bin final do range Corresponde ao BIN final do range
20 3 N Código associado do produto Corresponde ao código da tabela de produtos
BIT _______________DESCRIÇÃO_______________
7 Permite CHIP
23 2 H Parametros Geráis – Byte 1 5 Permite fallback digitado
3 Transação Magnética solicita CVV2/CVC2
BIT _______________DESCRIÇÃO_______________
8 Indicador sobre o Cartão Exigir PIN
1 = Sempre (Independente do Service code)
0 = Depende do BIT 7
7 Indicador sobre PIN ser tratado pelo Service Code
1 = Avalia o Service Code
0 = Não Solicita PIN
Caracteristicas do cartão
25 2 H 6 Indicador sobre transação magnética requerer os
Byte 2
4 ultimos dígitos ( Comparação “AND” com a
tabela de parametros do estabelecimento)
27 2 H Caracteristicas do cartão Byte 3 Reservado para uso futuro
9.3.5 Tabela de Produtos

0 3 N Código que identifica o produto Código que identifica unicamente o produto tratado pelo EC
Nome do emissor ou produto correspondente ao range de
bins, ou seja:
3 20 A Nome do emissor ou do produto Crédito: VISA, MASTERCARD, etc...
Débito: ELECTRON, MAESTRO, etc...
Voucher: ALELO, TICKET, etc...
TIPO ______________DESCRIÇÃO______________
01 Crédito
23 2 N Tipo do produto
02 Débito
03 Voucher
BIT _______________DESCRIÇÃO_______________
7 Permite CHIP
25 2 H 5 Permite fallback digitado
Byte 1
3 Transação magnetica solicita CVV2/CVC2

LTDA
BIT _______________DESCRIÇÃO_______________
8 Indicador sobre o Cartão Exigir PIN
1 = Sempre (Independente do Service code)
0 = Depende do BIT 7
7 Indicador sobre PIN ser tratado pelo Service Code
1 = Avalia o Service Code
0 = Não Solicita PIN
27 2 H 6 Indicador sobre transação magnética requerer os
Byte 2
4 ultimos dígitos ( Comparação “AND” com a
tabela de parametros do estabelecimento)
29 2 H Caracteristicas do cartão Byte 3 Reservado para uso futuro
Quantidade de dígitos a serem exibidos abertos no PAN da
31 2 N Mascara do PAN – Inicial
esquerda para a direita
Quantidade de dígitos a serem exibidos abertos no PAN da
33 2 N Mascara do PAN – Final
direita para a esquerda
35 3 N Codigo da funcionalidade Código da tabela de funcionalidades habilitadas por produto
9.3.6 Tabela de Funcionalidades por Produto

0 3 N Código da funcionalidade Código que identifica um grupo de transações do produto
3 2 N Número de Caracteristicas Define o numero de transações oferecidas para o produto
5 3* N Códigos dos parâmetros*** Define as transações oferecidas para o produto em questão
*** O campo códigos dos parametros deverá conter a mesma quantidade de códigos apontados no Numero de Caracteristicas,
ou seja, a representação do campo Códigos dos Parametros da Transação * Numero de Caracteristicas)
Exemplos:
1. Se Numero de Caracteristicas = 01
Códigos dos Parametros da Transação = 001
2. Se Numero de Caracteristicas = 03
Códigos dos Parametros da Transação = 001002003
9.3.7 Tabela de Parametros da Transação

0 3 N Codigo do parâmetro Codigo que identifica uma transação e suas características
TIPO ______________DESCRIÇÃO______________
01 Crédito a Vista
02 Crédito Parcelado Emissor
3 2 N Código da Função 03 Crédito Parcelado Lojista
04 Pré-Autorização de Crédito
50 Débito a Vista
51 Voucher a Vista
5 20 A Nome da Transação Etiqueta de transação (utilizado em transações offline)
25 2 H Caracteristicas – Byte 1 Reservado para uso futuro
27 2 H Caracteristicas – Byte 2 Reservado para uso futuro
29 12 N Parametros de Parcelas Valor mínimo da Transação
41 12 N Parametros de Parcelas Valor máximo da Transação
53 2 N Parametros de Parcelas Número Mínimo de Parcelas
55 2 N Parametros de Parcelas Número Máximo de Parcelas
57 12 N Parametros de Parcelas Valor Mínimo por Parcela
69 12 N Parametros de Parcelas Valor Máximo por Parcela

LTDA
9.4. Tabela de Taxas

Valor de 2 a 12 referente a quantidade de parcelas
0 2 N Quantidade de parcelas
1 para Crédito Rotativo e Débito
2 5 N Valor da taxa(MDR) Valor cadastrado na plataforma
7 3 N Bandeira em tratamento Código da bandeira em tratamento
9.5. Tabela de Juros

9 – Crédito parcelado Cliente
0 2 N Modalidade de Transação 10 – Crédito Rotativo Cliente
52 – Débito Cliente
2 5 N Valor do Juros Valor cadastrado na plataforma
7 3 N Bandeira em tratamento Código da bandeira em tratamento
9.6. Tabela de Contactless

0 3 N Tamanho da Tabela 314
3 1 N ID da tabela 1
6 2 H Indice do registro 13
8 2 N Tamanho do AID 07
10 32 H AID da aplicação A0000000043060000000000000000000
42 2 N Tipo de aplicação 02
44 16 AN Etiqueta da aplicação “MAESTRO “
60 2 N Padrão da aplicação 03
74 3 N Terminal Country Code 076
77 3 N Currency Code 986
80 1 N Currency Exponent 2
81 15 AN Merchant Identifier “ “
96 4 N Merchant Category Code 5992
100 8 A Terminal Identification 80042448
108 6 H Terminal Capabilities E0D0C8
114 10 H Adc Terminal Capabilities 6000F0A001
124 2 N Terminal Type 22
126 10 H Terminal Action Code – Default FE50BCA000
136 10 H Terminal Action Code – Denial 0000000000
146 10 H Terminal Action Code – Online FE50BCF800
156 8 H Terminal Floor Limit 00000000
164 1 AN Transaction Category Code R
165 1 AN CTLS Zero AM 0
166 1 AN CTLS MODE 4
167 8 H CTLS Transaction Limit 000F4240
175 8 H CTLS Floor Limit 00000000
183 8 H CTLS CVM Required Limit 00001387
191 4 H CTLS App version 0001
195 1 N Reservado para uso future 0
196 40 H TDOL 9F02065F2A029A039C0195059F37040000000000
236 40 H DDOL 9F37040000000000000000000000000000000000
276 2 A Resp. Code – Offline Aproved Y1
278 2 A Resp. Code – Offline Declined Z1
LTDA
280 2 A Resp. Code Advice – Offline Aproved Y3

282 2 A Resp. Code Advice – Offline Declined Z3
284 10 H CTLS - Terminal Action Code – Default FC501C8800
294 10 H CTLS - Terminal Action Code – Denial 0000800000
304 10 H CTLS - Terminal Action Code – Online FC501C8800
9.7. Tabela de Bonus

0 12 N Bonus disponivel Registro de Valor disponível para Ser acrescido em bônus
9.8. Tabela de Recargas

0 12 N Recarga disponivel Registro de Valor disponível para ser acrescido em recarga
10. Application Interchange Profile (AIP)
Byte 1
Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Significado
0 - - - - - - - RFU
- 1 - - - - - - SDA suportado
- - 1 - - - - - DDA suportado
- - - 1 - - - - Verificação do portador é suportada
- - - - 1 - - - Gerenciamento de risco do terminal é
suportada
- - - - - 1 - - A autenticação do emissor é
suportada
- - - - - - 0 - RFU
- - - - - - - 1 CDA suportado
Byte 2
0 - - - - - - - Reservado para uso pelo EMV
sem contato
- 0 - - - - - - RFU
- - 0 - - - - - RFU
- - - 0 - - - - RFU
- - - - 0 - - - RFU
- - - - - 0 - - RFU
- - - - - - 0 - RFU
- - - - - - - 0 RFU
A disponibilidade de dados no ICC para suportar à autenticação de dados offline é opcional e sua presença é indicada no AIP.
Se o terminal e o ICC apóiam um método comum de autenticação de dados offline, o terminal deve executar autenticação de
dados offline.
Dependendo dos recursos do cartão e do terminal, é realizada a SDA ou DDA ou CDA.
Se os seguintes itens forem verdadeiros, o terminal executará o CDA:

• O Application Interchange Profile indica que o cartão suporta CDA.
• O terminal suporta CDA.
Se tudo o que se segue for verdadeiro, o terminal deve executar o DDA:

• O Application Interchange Profile indica que o cartão suporta DDA.
• O terminal suporta DDA.
• O cartão ou o terminal (ou ambos) não suporta CDA.

LTDA
Se tudo o que se segue for verdadeiro, o terminal deve executar o SDA:

• O Application Interchange Profile indica que o cartão suporta SDA.
• O terminal suporta SDA.
• O cartão ou o terminal (ou ambos) não suporta DDA.
• O cartão ou o terminal (ou ambos) não suporta CDA.
Se nem SDA, DDA nem CDA forem executados, o terminal definirá o “autenticação de dados Offline não foi realizada” no TVR
para 1.
11. CVM List
Byte 1 – CVM List

1 - - - - - - - RFU
Falha na verificação do titular do cartão
- 0 - - - - - -
se esta CVM não for bem-sucedida
Aplique a Regra CV seguinte se esta
- 1 - - - - - -
CVM não for bem-sucedida
- - 0 0 0 0 0 0 Falha no processamento do CVM
Verificação de PIN de texto sem
- - 0 0 0 0 0 1
formatação realizada pela ICC
- - 0 0 0 0 1 0 PIN codificado verificado online
Verificação de PIN em texto realizada
- - 0 0 0 0 1 1
pela ICC e assinatura (papel)
Verificação de PIN codificado realizada
- - 0 0 0 1 0 0
pela ICC
Verificação do PIN codificada realizada
- - 0 0 0 1 0 1
pela ICC e assinatura (papel)
- - 0 X X X X X Valores no intervalo 000110-011101 RFU
- - 0 1 1 1 1 0 Assinatura (papel)
- - 0 1 1 1 1 1 Não é necessário CVM
Valores no intervalo 100000-101111
- - 1 0 X X X X
reservados para uso por SPI
Valores no intervalo 110000-111110
- - 1 1 X X X X
reservados para uso pelo emissor
- - 1 1 1 1 1 1 Este valor não está disponível para uso
Byte 2 – Capacidade dos metodos de verificação do portador do cartão
Valor Significado
00 Sempre
01 Se dinheiro desacompanhado
02 Se não for dinheiro autônomo e não dinheiro manual e não comprar com reembolso
03 Se o terminal suportar o CVM
04 Se dinheiro manual
05 Se comprar com reembolso
06 Se a transação estiver na moeda da aplicação e estiver abaixo do valor X¹
07 Se a transação estiver na moeda da aplicação e estiver acima do valor X¹
08 Se a transação estiver na moeda da aplicação e estiver abaixo do valor Y²
09 Se a transação estiver na moeda da aplicação e estiver acima do valor Y²
0A - 7F RFU
80 - FF Reservado para uso por sistemas de pagamento individuais(SPI)
¹ - X é referido no primeiro campo de valor(Transaction Amount)

² - Y é referido no segundo campo de valor(Other Amount)
Lista de métodos de verificação de portador do cartão (CVM): 00000000000000005E031F03

5E03 - Aplique a Regra CVM seguinte se esta CVM não tiver êxito
Assinatura (papel)

LTDA
Se o terminal suportar o CVM

1F03 - Falha na verificação do titular do cartão se esta CVM não for bem-sucedida
Não é necessário CVM
Se o terminal suportar o CVM
12. Terminal Capabilities
Byte 1 – Capacidade de entrada de Dados

1 - - - - - - - Entrada Manual
- 1 - - - - - - Tarja Magnetica
- - 1 - - - - - Cartão de Contato
- - - 0 - - - - Reservado para uso futuro
- - - - 0 - - - Reservado para uso futuro
- - - - - 0 - - Reservado para uso futuro
- - - - - - 0 - Reservado para uso futuro
- - - - - - - 0 Reservado para uso futuro
Byte 2 – Capacidade dos metodos de verificação do portador do cartão
1 - - - - - - - PIN de texto plano para validação no ICC
- 1 - - - - - - PIN codificado para validação online
- - 1 - - - - - Assinatura no comprovante
- - - 1 - - - - PIN codificado para validação offline
- - - - 1 - - - Nenhuma validação requerida (NO CVM)
Byte 3 – Capacidade de segurança
1 - - - - - - - SDA¹
- 1 - - - - - - DDA²
- - 1 - - - - - Card Capture
- - - 0 - - - - Reservado para uso futuro
- - - - 1 - - - CDA³
¹SDA – Static Data Authentication - SDA é usado para autenticar o próprio cartão de pagamento e verificar se as informações
do cartão selecionadas do emissor não foram alteradas desde que foram emitidas.
²DDA – Dynamic Data Authentication – O método DDA garante proteção contra ataques de clonagem criando um "criptograma
dinâmico" exclusivo para a transação.
³CDA - Combined Dynamic Data Authentication – Utiliza dois métodos DDA para garantir que a decisão final foi tomada pelo
mesmo cartão que fez a solicitação.
O terminal Capabilities deve ser montado em Hexadeximal utilizando 6 bytes para representar o bitmap mostrado
anteriormente.
Ex.: 11100000 11010000 11001000 = 0xE0 0xD0 0xC8 = E0D0C8

LTDA
13. Fallback
Identifica-se a presença de chip no cartão por meio da análise da primeira posição do “Service Code” da trilha, que deve ser
igual a 2 ou 6.
Digito Valor - Descrição

1 (mais significativo) =2 ou 6 – Cartão possui chip
2 =2 ou 4 – Autorização precisa ser online
3 (menos significativo) =0, 5, 6 ou 7 – Capturar senha.
Quando ocorre uma falha na leitura do chip ou da tarja magnética do cartão a transação poderá ser permitida ou negada
conforme tabela de parâmetros do estabelecimento, para transações permitidas a informação do BIT 22 deverá indiciar o
fallback.
Falha na leitura Transação efetuada

do chip. via tarja magnética.
Transação efetuada
Falha na leitura da via digitação do
tarja magnética. Número do cartão.
14. Detalhamento de XML
14.1. config.xml
<?xml version="1.0" encoding="UTF-8"?>

<theme_dark>true</theme_dark>
<color_background>8E45BF</color_background>
<color_shadow>5A2272</color_shadow>
<time_keepalive>43200</time_keepalive>
<subacquirer>Paynet</subacquirer>
<phones quantity="2">
<phone>
<name>Paynet</name>
<number>(11) 4003-4020</number>
</phone>
<phone>
<name>Central</name>
<number>(11) 4003-3002</number>
</phone>
</phones>
14.2. establishments_split.xml

<establishments quantity="2">
<establishment>
<name>Gabriela Lima</name>
<document>21132375045</document>
<registry>21132</registry>
<number>(11) 91111-1111</number>
</establishment>
<establishment>
<name>José Carlos</name>
LTDA
<number>(11) 92222-2222</number>
</establishment>
</establishments>
14.3. establishments_multiec.xml

<establishments quantity="2">
<establishment>
<name>Clinica Souza Lopes</name>
<number>(11) 3333-3333</number>
</establishment>
<establishment>
<name>Auto Peças Andrade</name>
<number>(11) 4444-4444</number>
</establishment>
</establishments>
15. Fluxogramas de captura
15.1. Legenda

LTDA
15.2. Fluxo de Pré-Seleção

LTDA
15.3. Fluxo Transações Tarja

LTDA
15.4. Fluxo de Transações EMV Contact

LTDA
15.5. Fluxo de Transações EMV Contactless

LTDA
16. Formulas de Cálculo – Modalildades Cliente
16.1. Cálculo por Markup
16.1.1. Débito Cliente
Etapas do Cálculo
totalJuros = (valor / (( 100 - juros) / 100 )) - valor
totalMDR = ( ( valor + totalJuros ) / ( ( 100 - ((mdr / 30) * dias) ) / 100)) - (valor + totalJuros)
valorFinal = valor + totalJuros + totalMDR
16.1.2. Crédito Á Vista Cliente
Etapas do Cálculo
totalMDR = ( ( valor + totalJuros ) / ( ( 100 - mdr ) / 100)) - (valor + totalJuros)
16.1.3. Crédito Parcelado Cliente
Etapas do Cálculo
totalMDR = ( ( valor + totalJuros ) / ( ( 100 – (mdr * parcelas) ) / 100)) - (valor + totalJuros)
16.2. Calculo Simples
Etapas do Cálculo
totalJuros = valor * (juros / 100)
totalMDR = valor * (((mdr / 30 ) * 2) / 100)
Etapas do Cálculo
totalMDR = valor * (mdr / 100)
Etapas do Cálculo
totalMDR = valor * ((mdr * parcelas) / 100)
LTDA
16.3. Calculo por Prazo Médio
Etapas do Cálculo
totalMDR = (valor + totalJuros) * (mdr / 100)
Etapas do Cálculo
totalMDR = (valor + totalJuros) * (mdr / 100)
Etapas do Cálculo
valorParcela = valor / parcelas
totalJuros = valorParcela * ((juros / 100) * parcela_atual) ### Laço de repetição
totalMDR = (valorParcela + totalJuros) * (mdr / 100) ### Laço de repetição
totalParcela = totalMDR + totalJuros + valorParcela ### Laço de repetição
valorFinal = valorFinal + totalParcela ### Laço de repetição

LTDA
17. Mensagens de Terminal
As tabelas abaixo contém as listas das mensagens a serem apresentadas pelo terminal durante o fluxo de captura
em caso de erro na leitura do cartão e negativa específicas das transações Contato (CT) e Contactless(CL)
17.1. Contato (CT)
Código Situação Mensagem

0 Antes da inserção, aproximação ou passagem do cartão “APROXIME, INSIRA OU PASSE O CARTÃO”
1 Erro de leitura do cartão Contato/Contactless "ERRO NA LEITURA DO CARTÃO”
4 Aplicação bloqueada “CARTAO INVALIDADO”
5 Cartão bloqueado “CARTAO BLOQUEADO”
8 Fallback para tarja “ERRO NA LEITURA PASSE O CARTÃO”
9 Aplicação Não Suportada “MODO INVÁLIDO USE TARJA”
10 Transação negada offline na interface Contato “TRS. NÃO ACEITA PELO CARTÃO”
12 Transação negada “TRANSAÇÃO NÃO AUTORIZADA”
16 Transação Aprovada “TRANSAÇÃO APROVADA”
17.2. Contactless (CL)
Código Situação Mensagem

0 Antes da inserção, aproximação ou passagem do cartão “APROXIME, INSIRA OU PASSE O CARTÃO”
1 Erro de leitura do cartão Contato/Contactless "ERRO NA LEITURA DO CARTÃO”
2 Utilização de Chip “FALHA DE LEITURA USE CHIP"
3 Aplicação Não Suportada “MODO INVÁLIDO, USE CHIP”
4 Aplicação bloqueada “CARTAO INVALIDADO”
6 Mudança de interface “TRS. NÃO ACEITA, USE CHIP”
10 Transação negada offline na interface Contato “TRS. NÃO ACEITA PELO CARTÃO”
11 Uso de Contactless Excedido “TRS. NÃO ACEITA USE CHIP”
12 Transação negada - Sem DE62 presente “TRANSAÇÃO NÃO AUTORIZADA”
13 Algum tipo de cartão não suportado “CARTÃO NÃO SUPORTADO”
15 Processamento de scripts “REAPROXIME O CARTÃO”
16 Transação Aprovada “TRANSAÇÃO APROVADA”
17 Troca de interface “INSIRA, PASSE OU TENTE OUTRO CARTÃO
18 Condições do cartão não satisfeitas para uso “CARTÃO NÃO ACEITO”
19 Validação no dispositivo “SIGA INSTRUÇÕES NO TELEFONE”

LTDA
18. Códigos de resposta (Bit 39)
A tabela abaixo contém os diferentes códigos de resposta (Bit 39) retornados pelo autorizador Paynet juntamente com as
respectivas mensagens a serem apresentadas no terminal (Bit 62).
Obs.: Os códigos de resposta de “00” a “99” são retornados diretamente pelo autorizador do adquirente juntamente com as
respectivas mensagens a serem apresentadas na tela do terminal.
Código
Mensagem (Bit 62) Descrição
(Bit 39)
Enviado em todas as mensagens de resposta do
00 “TRANSACAO APROVADA”
autorizador Paynet em caso de aprovação.
Os dados da transação corrente devem ser enviados
P9 N/A
na transação seguinte no Bit 60.
E8 “TRANSACAO NEGADA” Estabelecimento inválido da transação original
E7 “PARAMETROS INVALIDOS” MCC inválido
E6 “PARAMETROS INCORRETOS” Adquirente divergente do estabelecimento original
E5 “PARAMETROS INCORRETOS” Terminal não está na whitelist desse estabelecimento
E4 “TRANSACAO NEGADA” Dados de criptografia inválidos.
E3 “PARAMETROS INCORRETOS” Sub Adquirente sem TID ou MID.
E2 “TRANSACAO NEGADA” Há uma versão nova da tabela de taxas.
E1 “PARAMETROS INCORRETOS” Chave de criptografia não vinculada ao Adquirente.
D9 “PARAMETROS INCORRETOS” Código ddministrativo não localizado.
D8 “TRANSACAO DUPLICADA” Transação duplicada.
Chave de criptografia não relacionada no modelo do
D7 “PARAMETROS INCORRETOS”
terminal.
D6 “PARAMETROS INCORRETOS” Bandeira não localizada.
D5 “PARAMETROS INCORRETOS” Produto não localizado.
D4 “TRANSACAO NEGADA” Tempo de Cancelamento excedido
D3 “TRANSACAO NEGADA” Não permitido CVV inexistente ou ilegível.
D2 “TRANSACAO NEGADA” Transação fallback não permitida.
D1 “TRANSACAO NEGADA” Transação de CHIP não permitida
C9 “TRANSACAO NEGADA” Valor máximo da transação excedido.
C8 “TRANSACAO NEGADA” Valor mínimo da transação excedido
C7 “TRANSACAO NEGADA” Valor máximo da Parcela excedido
C6 “TRANSACAO NEGADA” Valor mínimo da Parcela excedido
C5 “TRANSACAO NEGADA” Máximo de Parcelas excedido
C4 “TRANSACAO NEGADA” Mínimo de Parcelas excedido
C3 “PARAMETROS INCORRETOS” Regra da Forma de Pagamento não localizada
C2 “PARAMETROS INCORRETOS” Regra do Produto não localizada
C1 “PARAMETROS INCORRETOS” Código de Produto do Adquirente não localizado
B9 “PARAMETROS INCORRETOS” Regras do BYTE1A não localizadas
B8 “PARAMETROS INCORRETOS” Estabelecimento não inicializado
B7 “PARAMETROS INCORRETOS” Transação original não encontrada
B6 “PARAMETROS INCORRETOS” Produto não habilitado no Estabelecimento
B5 “PARAMETROS INCORRETOS” Sub Adquirente sem Adquirente
B4 “PARAMETROS INCORRETOS” Formas de Pagamentos não localizados
B3 “PARAMETROS INCORRETOS” Status de Transações não localizados
B2 “PARAMETROS INCORRETOS” Produtos não localizados
B1 “PARAMETROS INCORRETOS” Modo de Entrada não encontrado ou não relacionado
A9 “PARAMETROS INCORRETOS” Sub Adquirente não está ativo
A8 “PARAMETROS INCORRETOS” Adquirente não está ativo
A7 “PARAMETROS INCORRETOS” Adquirente não encontrado
A6 “PARAMETROS INCORRETOS” Terminal sem identificação
A5 “PARAMETROS INCORRETOS” Código de captura não encontrado
A4 “PARAMETROS INCORRETOS” Estabelecimento não está ativo
A3 “PARAMETROS INCORRETOS” Terminal não vinculado ao estabelecimento
A2 “PARAMETROS INCORRETOS” Terminal não está ativo
A1 “PARAMETROS INCORRETOS” Terminal não cadastrado
LTDA
19. AID especiais
O fluxo de captura das transações Tarja/Contato e Contactless possui um tratamento especial que visa atender os novos AID
estipulados pelas bandeiras. Esses novos AID são estendidos de AID já préexistentes o que requer um tratamento especial para
que a solução saiba classificar a transação como débito ou crédito de forma correta.
19.1. Chamada GetCard por tipo
Os AID especiais serão classificados como produtos/aplicações ‘11’ (crédito especial) e ‘12’ (débito especial) na Tabela de
Aplicações EMV - AID. A chamada do comando getCard pode ser realizada de diferentes formas para Contato e de forma
única para Contactless.:
19.1.1. Contactless (1ª Opção)
• Uma chamada única com a lista de AID normais (para o fluxo de crédito).
• Ou, uma chamada única com a lista de AID normais + especiais (para o fluxo de Débito)
19.1.2. Contato (1ª Opção)
• Primeira chamada passando apenas lista de AID especiais (estendidos);

• Segunda chamada (se necessária) passando lista de AID normais (não estendidos);
Exemplo:
• Primeira chamada:
AID especial: A0 00 00 00 04 10 10 D0 76 13 (Mastercard - Crédito);
AID especial: A0 00 00 00 02 10 10 12 34 56 (Bandeira fictícia 1 - Crédito);
• Segunda chamada (se necessária):
AID especial: A0 00 00 00 04 10 10 (Mastercard - Crédito);
AID especial: A0 00 00 00 02 10 10 (Bandeira fictícia 1 - Crédito);
19.1.3. Contato (2ª Opção)
• Primeira chamada passando lista de AID especiais (estendidos) mais os AID normais (apenas os normais que
não formem os estendidos);
• Segunda chamada (se necessária) passando lista de AID normais (aqueles que formam os estendidos e que
não foram utilizados na primeira chamada);
Exemplo:
• Primeira chamada:
AID Especial: A0 00 00 00 04 10 10 D0 76 13 (Mastercard - Crédito);
AID Especial: A0 00 00 00 02 10 10 12 34 56 (Bandeira fictícia 1 - Crédito);
AID Normal: A0 00 00 00 01 10 10 (Bandeira fictícia 2 - Crédito);
• Segunda chamada (se necessária):
AID especial: A0 00 00 00 04 10 10 (Mastercard - Crédito);
AID especial: A0 00 00 00 02 10 10 (Bandeira fictícia 1 - Crédito);
19.1.4. Exemplo AID normais e especiais
• AID normal: A0 00 00 00 04 10 10 (Mastercard Credito);

• AID especial: A0 00 00 00 04 10 10 D0 76 13 (Mastercard Crédito)
• AID especial: A0 00 00 00 04 10 10 D0 76 12 (Mastercard Débito)

LTDA
20. Configuração das APN’s
20.1. Virtueyes
Campo Valor
APN virtueyes.com.br
Usuário virtu
Senha virtu
IP homologação 52.67.199.186
Porta homologação 7071
IP produção 54.207.83.20
Porta produção 7763
20.2. Lyra
Campo Valor
APN gprsnac.com.br
Usuário lyra
Senha lyra
20.3. Allcom
Campo Valor
APN allcom.br
Usuário allcom
Senha allcom
20.4. Link Solutions
Campo Valor
APN linksolutions.br
Usuário link
Senha link

LTDA
20.5. GrupoCard
Campo Valor
APN redet.com.br
Usuário vivo
Senha vivo
IP produção
Porta produção
20.6. TNS
Campo Valor
APN tnsi.com
Usuário tns
Senha tns
IP homologação
Porta homologação
172.31.255.10
IP produção
172.31.255.11
20.7. Avatek
Campo Valor
APN avatek.br
Usuário avatek
Senha avatek
21. Detalhamento de QRCode
Este tópico foi movido para o documento – Detalhamento de QRCode Paynet.pdf
22. Criptografia
Por questão de segurança e complexidade este tópico foi movido para o documento - Soluções de Criptografia.pdf

LTDA

Documentação Técnica 1.41 POS-HOST

Enviado por

Dados do documento

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

Documentação Técnica 1.41 POS-HOST

Enviado por

Direitos autorais:

Formatos disponíveis

Documentação de Integração

Documentação Técnica 1.41

PAYNET CAPTURA DE http://www.paynet.net.br Página 1 de 55

7.16. CONFIRMAÇÃO DE TRANSAÇÃO E ESTORNO.......................................................................................................................... 23

12. TERMINAL CAPABILITIES .......................................................................................................................................... 42

15. FLUXOGRAMAS DE CAPTURA .................................................................................................................................. 44

PAYNET CAPTURA DE http://www.paynet.net.br Página 4 de 55

Título Especificação de mensageria

Ed. Data Histórico Elaborado por Verificado por

PAYNET CAPTURA DE http://www.paynet.net.br Página 5 de 55

Adequação de mensagens para contemplar ISSO 2.0.0 da

PAYNET CAPTURA DE http://www.paynet.net.br Página 6 de 55

4. Códigos e formatos utilizados neste documento

4.1. Indicação variação de campo

Na coluna com o titulo do MTI contem os valores abaixo.

PAYNET CAPTURA DE http://www.paynet.net.br Página 7 de 55

4.4. Campos Compostos (TLV)

T Tag Identificação do Conteudo

Os bits que utilizam esse formato estão assim formatados:

Primeiro Dado Segundo Dado ... Enésimo Dado

4.5. Data e hora

Tamanho Cabeçalho MTI Mapa de bit Dados

PAYNET CAPTURA DE http://www.paynet.net.br Página 8 de 55

5.1. Tipo de MTI

5.2. Classe de Mensagens

5.3. Função da Mensagem

5.4. Origem da Mensagem

PAYNET CAPTURA DE http://www.paynet.net.br Página 9 de 55

o Exemplo de uma mensagem 0800

6. Definição de fluxo de mensagem

6.1. Solicitação de Pré Autorização

6.2. Confirmação de Pré Autorização

PAYNET CAPTURA DE http://www.paynet.net.br Página 10 de 55

6.7. Recarga de Celular

6.7.1 Recarga Aprovada

6.7.2 Recarga Negada

6.7.3 Transação Negada

6.7.4 Transação negada 2nd GEN

6.7.5 Consulta Negada

PAYNET CAPTURA DE http://www.paynet.net.br Página 11 de 55

MTI Bit 70 Descrição

o Teste de Comunicação: utilizado para testar a comunicação entre o terminal e a Paynet

6.9. Transações de desfazimento

PAYNET CAPTURA DE http://www.paynet.net.br Página 12 de 55

6.10. Transações de Confirmação

Data Element Type Size Description

PAYNET CAPTURA DE http://www.paynet.net.br Página 13 de 55

7.2. Comunicator CM-HTTP (JSON)

PAYNET CAPTURA DE http://www.paynet.net.br Página 14 de 55

7.3. Teste de comunicação

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

7.4. Keep Alive

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

PAYNET CAPTURA DE http://www.paynet.net.br Página 15 de 55

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

7.6. Baixa tabela de Aplicações EMV e Chaves Publicas

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

PAYNET CAPTURA DE http://www.paynet.net.br Página 16 de 55

7.7. Baixa tabela de parâmetros

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

7.8. Baixa tabela de Taxas e Juros

Bit 0800 0810 Tamanho (bytes) Tipo Descrição

PAYNET CAPTURA DE http://www.paynet.net.br Página 17 de 55

7.9. Baixa tabela de Bonus e Recargas