Especificação ISO 8583 PagSeguro

Especificação ISO-8583
Transferência Eletrônica de Fundos (TEF)
Versão 1.2.1
ESPECIFICAÇÃO ISO-8583 - TRANSFERÊNCIA ELETRÔNICA DE FUNDOS 2
Copyright
Todos os direitos reservados. O UOL é uma marca comercial do UNIVERSO ONLINE S / A. O logotipo do UOL é uma
marca comercial do UNIVERSO ONLINE S / A. Outras marcas, nomes, logotipos e marcas são de propriedade de seus
respectivos proprietários.
As informações contidas neste documento pertencem ao UNIVERSO ONLINE S/A. Todos os direitos reservados.
UNIVERSO ONLINE S/A. - Av. Faria Lima, 1384, 6º andar, São Paulo / SP, CEP 01452-002, Brasil.
O serviço PagSeguro não é, nem pretende ser comparável a serviços financeiros oferecidos por instituições
financeiras ou administradoras de cartões de crédito, consistindo apenas de uma forma de facilitar e monitorar a
execução das transações de comércio eletrônico através da gestão de pagamentos. Qualquer transação efetuada
através do PagSeguro está sujeita e deve estar em conformidade com as leis da República Federativa do Brasil.
Aconselhamos que você leia os termos e condições cuidadosamente.
Aviso Legal
O UOL não oferece garantias de qualquer tipo (expressas, implícitas ou estatutárias) com relação às informações
nele contidas. O UOL não assume nenhuma responsabilidade por perdas e danos (diretos ou indiretos), causados
por erros ou omissões, ou resultantes da utilização deste documento ou a informação contida neste documento ou
resultantes da aplicação ou uso do produto ou serviço aqui descrito. O UOL reserva o direito de fazer qualquer tipo
de alterações a quaisquer informações aqui contidas sem aviso prévio.
VERSÃO 1.2.1
Histórico de Versões
NOME VERSÃO DESCRIÇÃO
13/10/2016 1.0.0 Criação do documento
01/03/2017 1.0.1 Inclusão de observações sobre funcionalidades não suportadas
Inclusão de voucher na Tabela de Produtos, inclusão de campos de terminais

11/04/2017 1.0.2
no bit 48 e ajustes em descrições de código do operador e data de referência
Ajustes na Tabela de Funcionalidades Habilitadas por Produto, ajuste tamanho

26/04/2017 1.0.3 bit 13 (Data Local) de Fixo 6 para Fixo 4, inclusão do Bit 45 (Trilha 1 do cartão)
no Mapa de Bits das transações e ajustes na descrição da condição C11
Inclusão da seção sobre os Comprovantes, inclusão do tipo de mensagem Echo

02/05/2017 1.0.4
(Mensagem 0800 – Código de Processamento 008001)
Inclusão do Campo Razão Social/Nome Completo e Tipo de Pessoa na TAG 09

14/08/2017 1.0.5
do bit 48
Inclusão da Condição C85 para Payments Facilitator no mapa de “Condições

26/09/2017 1.0.6 dos Campos Mapeados nas Mensagens”, alteração da condição do bit 48-09
(SoftDescriptor) nas mensagens.
04/10/2017 1.0.7 Ajustes em descrições da data de referência
18/12/2017 1.0.8 Inclusão do Campo Facilitator Merchant ID na TAG 09 do bit 48
21/12/2017 1.0.9 Ajustes para possibilitar o Estorno Parcial
08/02/2018 1.0.9 Detalhamento da solução de Estorno Parcial
Alterações no Soft Descriptor (Bit 48-009) / Alteração do Bit 48-018 Versão

26/03/2018 1.1.0 Especificação TEF / Alterações na definição do NSU (Bit 37) / Adição do Bit 70
na Resposta da Venda / Adição do Bit 48-018 na Venda e no Estorno
03/09/2018 1.2.0 Inclusão do Processo Criptográfico de Cartão
Ajustes na descrição do processo de Challenge, ajuste no mapa de Bits da carga

27/12/2018 1.2.1
de chaves e do Estorno para ajustar bits descritos incorretamente
12/02/2019 1.2.1 Inclusão da Tag 048-16 no Estorno
28/02/2019 1.21 Inclusão da tabela com os códigos de erros
VERSÃO 1.2.1
Índice
Copyright ............................................................................................................................................................. 2
Aviso Legal ........................................................................................................................................................... 2
Histórico de Versões ............................................................................................................................................ 3
Índice ................................................................................................................................................................... 4
Lista de Figuras .................................................................................................................................................... 6
Lista de Tabelas ................................................................................................................................................... 7
Introdução ........................................................................................................................................................... 8
Objetivo ......................................................................................................................................... 8
Comunicação e Fluxos de Transações ................................................................................................................. 8
Inicialização (0800) ........................................................................................................................ 9
Fluxo de Logon com Tabelas Atualizadas ........................................................................... 10
Fluxo de Logon com Timeout.............................................................................................. 10
Fluxo de Logon com Carga de Tabelas ................................................................................ 10
Fluxo de Carga de Tabelas com Timeout ............................................................................ 11
Solicitação de Compra (0200)...................................................................................................... 12
Fluxo de Solicitação de Compra com Aprovação ................................................................ 12
Fluxo de Solicitação de Compra com Aprovação com Carga de Tabelas ........................... 13
Fluxo de Solicitação de Compra com Aprovação com Carga de Chaves ............................ 13
Fluxo de Solicitação de Compra com Aprovação com Carga de Tabelas e Carga de Chaves13
Fluxos de Solicitação de Compra com Falha ....................................................................... 14
Fluxo de Solicitação de Compra Negada ............................................................................ 15
Fluxos de Confirmação de Compra com Falha ................................................................... 15
Advices Off-line (0220) ................................................................................................................ 16
Fluxo Normal de Advice Off-line ......................................................................................... 16
Estorno ou Cancelamento de Compra (0400) ............................................................................. 16
Fluxo de Solicitação de Estorno com Aprovação ................................................................ 16
Fluxos de Solicitação de Estorno com Falha ....................................................................... 17
Fluxo de Solicitação de Estorno Negada ............................................................................. 17
Fluxos de Confirmação de Estorno com Falha .................................................................... 18
Desfazimento (0420) ................................................................................................................... 19
Fluxo Normal de Desfazimento .......................................................................................... 19
Fluxo de Desfazimento com Falha na Transmissão ............................................................ 19
Detalhamento de Transações ............................................................................................................................ 20
Manutenção de Transações Pendentes ...................................................................................... 20
Transações com Chip EMV .......................................................................................................... 21
Fallback Magnético ............................................................................................................. 21
Fallback Digitado ................................................................................................................. 21
Fluxo de Generate AC e Tratamentos Correspondentes .................................................... 22
Criptografia de Senha .................................................................................................................. 24
Criptografia do Cartão e CVV....................................................................................................... 25
Requisitos............................................................................................................................ 25
Processo Criptográfico ........................................................................................................ 26
Detalhamento das Mensagens ISO-8583 .......................................................................................................... 27
Regras dos Campos...................................................................................................................... 27
Tipos de Campo .................................................................................................................. 27
Tamanhos de Campo .......................................................................................................... 27
Campos no Formato TLV..................................................................................................... 28
Tabela de Bits Utilizados.............................................................................................................. 28
Dados Adicionais (Bit 48) .................................................................................................... 32
VERSÃO 1.2.1
Dados Adicionais do Autorizador (Bits 62 e 63) ................................................................. 35

Parâmetros de Inicialização ............................................................................................................................... 37
Tabela de Parâmetros do Estabelecimento ................................................................................ 37
Tabela de BINs ............................................................................................................................. 38
Tabela de BINs Especiais.............................................................................................................. 39
Tabela de Produtos...................................................................................................................... 39
Tabela de Funcionalidades Habilitadas por Produto................................................................... 41
Tabela de Parâmetros da Transação ........................................................................................... 41
Tabela de Códigos das Funcionalidades ...................................................................................... 42
Tabela de Tags EMV - First Generate .......................................................................................... 43
Tabela de Tags EMV - Second Generate...................................................................................... 43
Tabela de Chaves de Criptografia ................................................................................................ 44
Tabela de Aplicações EMV - AID .................................................................................................. 44
Tabela de Chaves Públicas ........................................................................................................... 47
Tabela de Chaves de PinPad ........................................................................................................ 48
Mensageria ISO-8583 ........................................................................................................................................ 49
Formato ....................................................................................................................................... 49
ID da Mensagem ................................................................................................................. 49
Mapa de Bits ....................................................................................................................... 49
Dados da Transação ............................................................................................................ 49
Condições dos Campos Mapeados nas Mensagens .................................................................... 50
Mapa de Bits ISO-8583 ................................................................................................................ 52
Logon (0800) ....................................................................................................................... 52
Echo (0800) ......................................................................................................................... 53
Carga de Tabelas (0800) ..................................................................................................... 54
Carga de Chaves (0800) ...................................................................................................... 55
Compra (0200) .................................................................................................................... 56
Confirmação de Compra/Estorno (0202/0402) .................................................................. 58
Advice Off-line (0220) ......................................................................................................... 59
Estorno (0400) .................................................................................................................... 59
Desfazimento (0420)........................................................................................................... 62
Pré-autorização (0100) ....................................................................................................... 62
Captura de Pré-Autorização (0200) .................................................................................... 64
Comprovantes de Venda ............................................................................................................. 66
Códigos de Erros .......................................................................................................................... 66
Anexo A........................................................................................................................................ 67
Detalhamento do Processo Criptográfico........................................................................... 67
Exemplo do Processo Criptográfico .................................................................................... 68
VERSÃO 1.2.1
Lista de Figuras
Figura 1 – Escopo da Especificação ..................................................................................................................... 8
Figura 2 – Fluxo de Logon para tabelas já atualizadas ...................................................................................... 10
Figura 3 – Fluxo de Logon com timeout ............................................................................................................ 10
Figura 4 – Fluxo de Logon com carga de tabelas ............................................................................................... 10
Figura 5 – Fluxo de Carga de Tabelas com timeout .......................................................................................... 11
Figura 6 – Fluxo de solicitação de compra com aprovação .............................................................................. 12
Figura 7 – Fluxo de solicitação de compra com aprovação com Carga de Tabelas........................................... 13
Figura 8 – Fluxo de solicitação de compra com aprovação com Carga de Chaves ........................................... 13
Figura 9 – Fluxo de solicitação de compra com aprovação com Carga de Tabelas e Carga de Chaves ............ 13
Figura 10 – Fluxo de solicitação de compra com timeout na requisição .......................................................... 14
Figura 11 – Fluxo de solicitação de compra com timeout na resposta ............................................................. 14
Figura 12 – Fluxo de solicitação de compra com falha de processamento ....................................................... 14
Figura 13 – Fluxo de Solicitação de Compra Negada ........................................................................................ 15
Figura 14 – Fluxo de confirmação de compra com falhas por timeout............................................................. 15
Figura 15 – Fluxo normal de Advice Off-line ..................................................................................................... 16
Figura 16 – Fluxo de Estorno com Aprovação ................................................................................................... 16
Figura 17 – Fluxo de Estorno com timeout na solicitação................................................................................. 17
Figura 18 – Fluxo de Estorno com timeout na resposta.................................................................................... 17
Figura 19 – Fluxo de Estorno com falha de processamento ............................................................................. 17
Figura 20 – Fluxo de Solicitação de Estorno Negada ......................................................................................... 17
Figura 21 – Fluxo de Confirmação de Estorno com Falhas por timeout ........................................................... 18
Figura 22 – Fluxo Normal de Desfazimento ...................................................................................................... 19
Figura 23 – Fluxo de desfazimento com falhas por timeout ............................................................................. 19
Figura 24 – Fluxo de Confirmação Manual ........................................................................................................ 20
Figura 25 – Fluxo de Desfazimento Manual ...................................................................................................... 20
Figura 26 – Fluxograma EMV ............................................................................................................................. 23
Figura 27 – Fluxo EMV Unable To Go Online..................................................................................................... 24
Figura 28 – API de Criptografia Biblioteca Compartilhada ................................................................................ 25
VERSÃO 1.2.1
Lista de Tabelas
Tabela 1 – Siglas do fluxograma EMV................................................................................................................ 22
Tabela 2 – Tipos de campo na mensageria ISO-8583 ........................................................................................ 27
Tabela 3 – Tamanhos de campo na mensageria ISO-8583................................................................................ 27
Tabela 4 – Exemplo de campo TLV .................................................................................................................... 28
Tabela 5 - Detalhamento de bits ISO-8583 ....................................................................................................... 32
Tabela 6 - Detalhamento do bit 48 .................................................................................................................... 34
Tabela 7 - Detalhamento dos bits 62 e 63 ......................................................................................................... 36
Tabela 8 - Parâmetros do Estabelecimento ...................................................................................................... 38
Tabela 9 - Parâmetros de BINs .......................................................................................................................... 38
Tabela 10 - Parâmetros de BINs Especiais ......................................................................................................... 39
Tabela 11 - Parâmetros de Produtos ................................................................................................................. 41
Tabela 12 - Parâmetros de Funcionalidades Habilitadas por Produto .............................................................. 41
Tabela 13 - Parâmetros de Transações ............................................................................................................. 42
Tabela 14 - Parâmetros de Códigos das Funcionalidades ................................................................................. 43
Tabela 15 - Parâmetros de Tags EMV obrigatórias em First Generate ............................................................. 43
Tabela 16 - Parâmetros de Tags EMV obrigatórias em Second Generate ........................................................ 43
Tabela 17 - Parâmetros de chaves de criptografia ............................................................................................ 44
Tabela 18 - Parâmetros de Aplicações EMV ...................................................................................................... 47
Tabela 19 - Parâmetros de chaves públicas EMV .............................................................................................. 47
Tabela 20 – Tabela de Chaves de Trabalho ....................................................................................................... 48
Tabela 21 - Exemplo de mensagem sem segundo mapa de bits....................................................................... 49
Tabela 22 - Exemplo de mensagem com segundo mapa de bits ...................................................................... 49
Tabela 23 - Siglas referentes a campos na mensageria ISO-8583 ..................................................................... 50
Tabela 24 - Condições especiais na mensageria ISO-8583 ................................................................................ 51
Tabela 25 - Campos da transação de Logon ...................................................................................................... 52
Tabela 26 - Campos da transação de Echo ........................................................................................................ 53
Tabela 27 - Campos da transação de Carga de Tabelas .................................................................................... 54
Tabela 28 - Campos da transação de Carga de Chaves ..................................................................................... 55
Tabela 29 - Campos da transação de compra ................................................................................................... 58
Tabela 30 - Campos da transação de confirmação de compra/estorno ........................................................... 58
Tabela 31 - Campos da transação de advice off-line ......................................................................................... 59
Tabela 32 - Campos da transação de estorno ................................................................................................... 61
Tabela 33 - Campos da transação de desfazimento .......................................................................................... 62
Tabela 34 - Campos da transação de pré-autorização ...................................................................................... 63
Tabela 35 - Campos da transação de captura de Pré-autorização .................................................................... 65
VERSÃO 1.2.1
Introdução
Esta especificação define os fluxos de mensagens ISO-8583, versão de 1987, necessários para a
realização de transações financeiras em estabelecimentos comerciais (Ecs) que operam com caixas
registradoras (ECRs), considerando o mercado brasileiro e as bandeiras que operam no país.
O concentrador TEF – também denominado servidor TEF ou somente TEF – é o sistema que, dentre
outras funcionalidades, permite ao portador do cartão a realização das transações oferecidas pela rede
emissora em cada EC. Basicamente este sistema coleta a solicitação do usuário, efetuada via terminal no EC,
encaminha-a para a rede autorizadora e trata a resposta recebida do mesmo.
Os Ecs efetivam a transação financeira com o cartão, solicitado pela ECR por meio de uma solução TEF
adquirida. A figura a seguir mostra as entidades envolvidas no processo de uma transação financeira com
cartão. Cada caixa corresponde a um ponto de venda (PDV), e a parte tratada neste documento está destacada
em vermelho.
PDV 1
Concentrador Conversor Autorizador

PDV 2
TEF ISO-8583 PagSeguro
...
PDV N
Figura 1 – Escopo da Especificação
Objetivo
Este documento descreve as operações realizadas e os fluxos de mensagens trocadas entre o
concentrador TEF e o autorizador do PagSeguro. Além dos dados relativos às regras de negócio, este
documento deve conter os campos (bits) previstos no padrão ISO-8583 de 1987 utilizados nas mensagens
trocadas entre as partes supracitadas.
Comunicação e Fluxos de Transações

A comunicação entre o concentrador TEF e o autorizador normalmente é feita via X-25 ou TCP-IP,
sendo possível o uso de links dedicados ou rede privada (VPN). É importante evitar a queda de conexão entre
as partes para garantir a integridade das transações em situações de falhas temporárias na comunicação.
As mensagens devem circular de forma assíncrona, isto é, envios e recebimentos ocorrem de maneira
simultânea e desvinculada da sequência de mensagens que define as operações.
Todas as transações realizadas entre essas duas entidades são descritas a seguir, a fim de tornar
possível o atendimento aos clientes portadores de cartões.
VERSÃO 1.2.1
Inicialização (0800)
Existem três transações do tipo 0800. A primeira transação é o Logon (Abertura) e a segunda é a Carga
de Tabelas e a terceira é a Carga de Chaves.
A transação de Logon é utilizada para validar o EC perante o autorizador e deverá ser realizada sob as
condições listadas abaixo:
• Sempre que o concentrador TEF for colocado em operação, para cada EC configurado no servidor;
• Diariamente em um horário configurado no servidor TEF ou por meio do primeiro terminal que
efetuar uma solicitação no dia corrente. No segundo caso, o servidor TEF deverá processar
automaticamente esta transação de abertura antes de processar a solicitação enviada pelo PDV.
Um dos campos presentes na transação de Logon é a versão das tabelas de configuração, bit 48 – 001,
carregadas no servidor TEF. Caso o servidor esteja com configurações desatualizadas, o autorizador deverá
responder o bit 70 com valor 010/100/110. Caso contrário, o bit 70 deverá conter o valor 001 para indicar que
não há necessidade de iniciar o fluxo da Carga de Tabelas ou Carga de Chaves.
O Bit 70 pode informar que há necessidade apenas da Carga de Chaves (010), apenas a Carga de
Tabelas (100), ou ambas (110). O tratamento de cada tipo de Carga deve ser feito individualmente.
As transações de Carga de Tabelas são destinadas ao download de tabelas configurações do
autorizador para o servidor TEF. Os dados relacionados aos produtos processados pelo autorizador e os dados
do fluxo EMV, como os parâmetros Application Identifier (AID) e Certification Authority Keys (CA Keys), serão
transferidos para o concentrador TEF através de uma ou mais pernas desta transação.
As transações de Carga de Chaves são destinadas ao download da Tabela de Chaves a serem utilizadas
pelo PinPad para criptografar dados sensíveis do Cartão enviado nos bits 35 e 45.
Importante: deve ser previsto o tratamento de múltiplas pernas da Carga de Tabelas e

da Carga de Chaves, pois nesta especificação os dados são transferidos em dois campos
“LLLVAR” com limite de 999 bytes cada, e alguns parâmetros do fluxo EMV
potencialmente irão ultrapassar o total de 1998 bytes por perna.
A resposta de ambas Cargas deverá conter o bit 62 e opcionalmente o bit 63 contendo os dados de
configuração destinados ao servidor TEF. Caso uma perna da transação não seja suficiente para a transferência
de todos os dados, o autorizador deverá responder o bit 48 – 002 com um valor numérico de controle de
pernas a critério do autorizador para sinalizar sobre a necessidade de envio de uma continuação da Carga de
Tabelas/Chaves.
O concentrador TEF deverá detectar a presença do bit 48 – 002 e enviar uma nova transação de Carga
de Tabelas/Chaves, espelhando o número contido no bit 48 – 002 para dar continuidade ao processo de carga
de registros de configuração.
O autorizador deverá identificar qual é o estado da carga de registros a partir deste bit para enviar os
dados restantes ao concentrador TEF. Caso ainda exista a necessidade de envio de mais registros, o
autorizador deverá manter o mesmo procedimento descrito acima.
Após a transferência de todas as configurações, o autorizador deverá omitir o bit 48 – 002 na resposta
e enviar o bit 48 – 001 com a versão das tabelas recém-transferidas ao concentrador TEF. Note que a Carga
de Tabelas e a Carga de Chaves possuem versões diferentes. O tratamento de cada uma deve ser feito
separadamente. Em vias de regra, a Carga de Tabelas ocorre raramente, e a Carga de Chaves será requisitada
geralmente a cada 24 horas.
VERSÃO 1.2.1
Fluxo de Logon com Tabelas Atualizadas

Quando as tabelas já estão atualizadas, o concentrador TEF não irá disparar as transações de Carga de
Tabelas/Chaves. Em caso de aprovação, o EC estará apto a enviar outras transações normalmente; caso a
transação seja negada pelo autorizador, o concentrador TEF precisará repetir o envio desta transação.
Logon 0800: [Bit 48 – 001] Atualizado
Concentrador TEF Autorizador
Logon 0810: [Bit 70] 001
Figura 2 – Fluxo de Logon para tabelas já atualizadas
Fluxo de Logon com Timeout

Em caso de perda de transações, o concentrador TEF continuará inoperante enquanto a transação de
Logon não for bem-sucedida.
Logon 0800: Solicitação Padrão
Logon 0810: Resposta Perdida
Timeout
Logon 0800: Nova Tentativa
Logon 0810: Resposta OK
Figura 3 – Fluxo de Logon com timeout
Fluxo de Logon com Carga de Tabelas

No exemplo abaixo, após a detecção de tabelas não atualizadas, são necessárias vinte pernas da
transação de carga de tabelas para que todos os parâmetros de configuração do autorizador sejam
transferidos para o servidor TEF. Ao final do processo, o mesmo acatará as novas configurações ao processar
novas transações financeiras.
Logon 0800: [Bit 48 – 001] Desatualizado
Logon 0810: [Bit 70] 100
Carga 0800: [Bit 48 – 002] Ausente
Carga 0810: [Bit 48 – 002] 000001

Carga 0800: [Bit 48 – 002] 000001
Carga 0810: [Bit 48 – 002] 000002

......
Carga 0800: [Bit 48 – 002] 000020
Carga 0810: [Bit 48 – 001] Versão da Nova Tabela
Figura 4 – Fluxo de Logon com carga de tabelas
VERSÃO 1.2.1
Fluxo de Carga de Tabelas com Timeout

O número de controle deve ser utilizado para tratar situações como a apresentada abaixo. Como existe
a possibilidade de queda por timeout em qualquer etapa da carga de tabelas, tanto o servidor TEF quanto o
autorizador devem possuir um mecanismo de reenvio de transações e de detecção de duplicatas. Ao final do
processo, espera-se que as configurações transferidas estejam íntegras no servidor TEF.
Logon 0800: [Bit 48 – 001] Desatualizado
Logon 0810: [Bit 70] 100
Carga 0800: [Bit 48 – 002] Ausente
Carga 0810: [Bit 48 – 002] 000001
Carga 0800: [Bit 48 – 002] 000001
Carga 0810: [Bit 48 – 002] 000002

Timeout
Carga 0800: [Bit 48 – 002] 000001
Carga 0810: [Bit 48 – 002] 000002
......
Carga 0800: [Bit 48 – 002] 000020
Carga 0810: [Bit 48 – 001] Versão da Nova Tabela
Figura 5 – Fluxo de Carga de Tabelas com timeout
VERSÃO 1.2.1
Solicitação de Compra (0200)

Apenas as transações de Compra são do tipo 0200 nesta especificação, essa operação é utilizada
quando o cliente realiza uma compra com o cartão. São possíveis as seguintes formas de pagamento em uma
transação de compra. As entradas marcadas com (*) ainda não são suportadas pelo PagSeguro no modelo de
TEF.
NOME DESCRIÇÃO
Crédito à vista Pagamento total do valor da compra, com produto crédito.
Pagamento mensal do valor da compra, dividido pelo número de parcelas e acrescido

Crédito parcelado
ou não de juros de acordo com as tabelas de financiamento.
Pagamento da taxa de embarque para companhias aéreas, juntamente com o valor

Crédito IATA*
da compra.
Reserva de um valor por um determinado período, utilizado em hotéis, locadoras e

Pré-autorização*
e-commerce.
Captura de Pré- Pagamento de reserva para hotéis, locadoras e e-commerce, mediante Pré-
autorização* autorização realizada.
Débito à vista Pagamento total do valor da compra, com produto débito.
Transação de débito realizada com cartão voucher tipo alimentação, refeição,

Voucher
cultura, etc.
Fluxo de Solicitação de Compra com Aprovação

O fluxo abaixo representa uma compra que foi aprovada pelo autorizador. Como o sistema opera no
modelo de quatro pernas, o concentrador TEF deve aguardar a resposta da confirmação antes de finalizar.
Compra 0200: Solicitação
Compra 0210: Resposta Aprovada

Compra 0202: Confirmação
Compra 0212: Resposta da Confirmação
Figura 6 – Fluxo de solicitação de compra com aprovação
VERSÃO 1.2.1
Fluxo de Solicitação de Compra com Aprovação com Carga de Tabelas

O fluxo abaixo representa uma compra que foi aprovada pelo autorizador, onde o bit 70 indica a
necessidade de uma nova Carga de Tabelas, pois os dados do Autorizador sofreram modificações. Ao receber
este indicativo o Concentrador TEF deverá efetuar uma nova Carga de Tabelas. Como o sistema opera no
modelo de quatro pernas, o concentrador TEF deve aguardar a resposta da confirmação antes de finalizar.
Compra 0210: Resposta Aprovada [Bit 70] 100

Figura 7 – Fluxo de solicitação de compra com aprovação com Carga de Tabelas
Fluxo de Solicitação de Compra com Aprovação com Carga de Chaves

necessidade uma nova Carga de Chaves, pois os dados do Autorizador sofreram modificações. Ao receber este
indicativo o Concentrador TEF deverá efetuar a Carga de Chaves. Como o sistema opera no modelo de quatro
pernas, o concentrador TEF deve aguardar a resposta da confirmação antes de finalizar.

Figura 8 – Fluxo de solicitação de compra com aprovação com Carga de Chaves
Fluxo de Solicitação de Compra com Aprovação com Carga de Tabelas e Carga de Chaves
necessidade uma nova Carga de Tabelas e uma nova Carga de Chaves, pois os dados do Autorizador sofreram
modificações. Ao receber este indicativo o Concentrador TEF deverá efetuar a Carga de Tabelas, assim como
a Carga de Chaves, de maneira independente. Como o sistema opera no modelo de quatro pernas, o
concentrador TEF deve aguardar a resposta da confirmação antes de finalizar.

Figura 9 – Fluxo de solicitação de compra com aprovação com Carga de Tabelas e Carga de Chaves
VERSÃO 1.2.1
Fluxos de Solicitação de Compra com Falha

Qualquer caso de timeout deve resultar em um desfazimento da solicitação original. O Timeout deve
ser de 35 segundos. A transação de Desfazimento também será enviada em caso de erro no processamento
da resposta no servidor TEF ou nos PDVs. Mais informações sobre esse tipo de transação podem ser
encontradas na respectiva seção, no decorrer desta especificação.
Importante: todas as transações de Desfazimento devem ser aprovadas pelo

autorizador por se tratarem de avisos e não solicitações.
Encontram-se a seguir alguns cenários de exemplo em que devem ser empregadas as transações de
Desfazimento.
Compra 0200: Solicitação Perdida
Timeout (35 s)
Desfazimento 0420: Aviso
Desfazimento 0430: Resposta do Aviso
Figura 10 – Fluxo de solicitação de compra com timeout na requisição
Compra 0210: Resposta Perdida
Timeout (35 s)
Figura 11 – Fluxo de solicitação de compra com timeout na resposta
Concentrador TEF Compra 0210: Resposta

Problemas no
Autorizador
processamento da Desfazimento 0420: Aviso
resposta
Figura 12 – Fluxo de solicitação de compra com falha de processamento
VERSÃO 1.2.1
Fluxo de Solicitação de Compra Negada

Em caso de negação da solicitação de compra, o fluxo deve ser encerrado na segunda perna, pois o
autorizador negou a solicitação enviada pelo concentrador.

Compra 0210: Resposta Negada
Figura 13 – Fluxo de Solicitação de Compra Negada
Fluxos de Confirmação de Compra com Falha

Após a confirmação da transação por parte do PDV, passa a ser responsabilidade do concentrador TEF
repassar a informação para o autorizador. No exemplo abaixo é apresentada uma situação de timeout em
várias tentativas de envio da confirmação para o autorizador. No caso, o concentrador TEF deve tratar o
reenvio da confirmação e o autorizador deve tratar duplicatas de confirmação da mesma transação.
Compra 0210: Resposta Aprovada
Compra 0202: Confirmação Perdida
Timeout

Compra 0212: Resposta da Confirmação Perdida
Timeout
Figura 14 – Fluxo de confirmação de compra com falhas por timeout
VERSÃO 1.2.1
Advices Off-line (0220)

O objetivo das transações de Advice Off-line é notificar o autorizador quando transações de compra
foram aprovadas ou negadas de forma off-line pelo PDV. As transações de Advice são do tipo 0220 e
normalmente são emitidas apenas durante a geração dos criptogramas EMV, quando determinadas condições
impostas ao chip do cartão são satisfeitas.
Importante: transações de Advice ainda não são suportadas pelo PagSeguro no modelo
de TEF.
Fluxo Normal de Advice Off-line

A transação de Advice já sobe para o autorizador com um código de resposta indicando se ela foi
aprovada ou negada de forma off-line.
Advice 0220: Aviso
Advice 0230: Resposta
Figura 15 – Fluxo normal de Advice Off-line
Estorno ou Cancelamento de Compra (0400)

Nesta especificação, apenas a transação de Estorno é considerada do tipo 0400. Também identificado
como cancelamento de uma compra, o estorno se dá a pedido do operador do terminal e pode ser efetuado
apenas no EC que realizou a transação original.
O período permitido, assim como as condições para a realização de um estorno dependem do
autorizador, bem como da solução TEF em uso no EC, uma vez que os dados da transação original são
resgatados de sua base de transações para compor a mensagem ISO.
Um estorno nunca deve ser enviado pelo Concentrador TEF ao Autorizador antes da confirmação da
transação original.
Para Transações de Débito e Voucher o estorno deve ocorrer somente no mesmo dia da transação
original, não permitindo o estorno da transação em dias posteriores. Também não é possível realizar o estorno
parcial da transação original, somente o estorno do valor total da transação.
Para Transações de Crédito é possível realizar o estorno parcial da transação.
Fluxo de Solicitação de Estorno com Aprovação

O fluxo a seguir representa um estorno de compra que foi aprovado pelo autorizador. Como o sistema
opera no modelo de quatro pernas, o concentrador TEF deve aguardar a resposta da confirmação para finalizar
o fluxo e considerar a compra como estornada.
Estorno 0400: Solicitação
Estorno 0410: Resposta Aprovada

Estorno 0402: Confirmação
Estorno 0412: Resposta da Confirmação
Figura 16 – Fluxo de Estorno com Aprovação
VERSÃO 1.2.1
Fluxos de Solicitação de Estorno com Falha

Qualquer caso de timeout deve resultar em um desfazimento do estorno. A transação original de
compra que seria estornada continuará aprovada no servidor TEF. Exceto para transações Estornadas em D+1.
A transação de Desfazimento também será enviada em caso de erro no processamento da resposta no
servidor TEF ou nos PDVs. Os fluxos a seguir ilustram essas situações.
Estorno 0400: Solicitação Perdida
Timeout
Figura 17 – Fluxo de Estorno com timeout na solicitação
Estorno 0410: Resposta Perdida
Timeout
Figura 18 – Fluxo de Estorno com timeout na resposta
Concentrador TEF Estorno 0410: Resposta

Problemas no
Autorizador
processamento da Desfazimento 0420: Aviso
resposta
Figura 19 – Fluxo de Estorno com falha de processamento
Fluxo de Solicitação de Estorno Negada

Neste caso o fluxo deve ser encerrado na segunda perna, pois o autorizador negou a solicitação de
estorno. A transação original de compra continuará aprovada no concentrador TEF.
Estorno 0410: Resposta Negada
Figura 20 – Fluxo de Solicitação de Estorno Negada
VERSÃO 1.2.1
Fluxos de Confirmação de Estorno com Falha

Feita a confirmação da transação por parte do PDV, passa a ser responsabilidade do concentrador TEF
repassar a informação para o autorizador.
O exemplo a seguir apresenta uma situação de timeout em várias tentativas de envio da confirmação
para o autorizador. No caso, o concentrador TEF deve tratar o reenvio da confirmação e o autorizador deve
tratar duplicatas de confirmação da mesma transação. Apenas ao receber a quarta perna, a transação de
compra original será considerada estornada no servidor TEF.
Estorno 0410: Resposta Aprovada
Estorno 0402: Confirmação Perdida
Timeout

Estorno 0412: Resposta da Confirmação Perdida
Timeout
Estorno 0412: Resposta da Confirmação
Figura 21 – Fluxo de Confirmação de Estorno com Falhas por timeout
VERSÃO 1.2.1
Desfazimento (0420)
As transações de Desfazimento são do tipo 0420. Conforme apresentado anteriormente nos fluxos de
compra e estorno, essas transações são enviadas sob as seguintes condições:
• O concentrador TEF não recebeu resposta de sua solicitação em tempo hábil e desistiu por
timeout;
• O PDV não conseguiu finalizar alguma operação por problemas na rede local, de processamento
dos dados ou por ação do operador.
Importante: a transação de Desfazimento somente pode ser enviada em fluxos das

transações de Compra ou de Estorno.
Fluxo Normal de Desfazimento

A transação não pode ser negada pelo autorizador por se tratar de um aviso, mesmo em caso de
Desfazimento para uma solicitação que não foi transmitida com sucesso.

Desfazimento 0430: Resposta
Figura 22 – Fluxo Normal de Desfazimento
Fluxo de Desfazimento com Falha na Transmissão

Analogamente às confirmações, as transações de Desfazimento também serão reenviadas ao
autorizador até que o servidor TEF receba uma resposta.
Desfazimento 0420: Aviso Perdido
Timeout
Desfazimento 0430: Resposta Perdida

Autorizador
Concentrador TEF
Timeout
Figura 23 – Fluxo de desfazimento com falhas por timeout
VERSÃO 1.2.1
Detalhamento de Transações
Manutenção de Transações Pendentes

Existem situações em que transações ficarão pendentes entre o PDV e concentrador TEF. Estas
transações poderão ser listadas via relatório de pendências e posteriormente resolvidas de forma manual pelo
operador.
Quando uma transação é confirmada manualmente, na mesma data da transação original ou em dias
subsequentes, o concentrador TEF deve enviar uma mensagem de Confirmação, mesmo que o autorizador
não mais esteja esperando pela mesma. Da mesma forma, quando a transação for cancelada manualmente,
o concentrador TEF deve enviar uma mensagem de Desfazimento ao autorizador.
Compra 0210: Resposta

Concentrador TEF
Sem Confirmação ou Desfazimento
Transação Autorizador
Pendente
Compra 0202: Confirmação Manual
Figura 24 – Fluxo de Confirmação Manual
Compra 0210: Resposta

Concentrador TEF
Sem Confirmação ou Desfazimento
Transação Autorizador
Pendente
Desfazimento 0420: Desfazimento Manual
Figura 25 – Fluxo de Desfazimento Manual
VERSÃO 1.2.1
Transações com Chip EMV

A presença do chip em um cartão é identificada quando a primeira posição do service code da trilha é
igual a 2 ou 6. Listam-se abaixo algumas particularidades no processamento de transações com chip EMV.
A aplicação no PINpad utilizada para o processamento do chip é a quarta aplicação (genérica). Quando
ocorre uma falha no processamento do chip, a aplicação deve tentar autorizar a transação por outros meios
seguros se assim estiver configurado no cartão do cliente. Neste caso, denominado fallback, as transações são
processadas normalmente de forma online, sinalizando no bit 22 a situação em que foram realizadas. O
fallback pode ser tanto magnético quanto digitado.
Fallback Magnético
Após a falha no processamento do chip, a aplicação pode tentar ler a tarja e enviar a transação com modo de
entrada sinalizando a tarja magnética com fallback.
Fallback Digitado
Se o processamento da transação falhar tanto via chip quanto tarja magnética, o fallback digitado pode ser
aplicado para o cartão em processamento. A aplicação efetua a transação de forma digitada, sinalizando o
modo de entrada de maneira apropriada.
Importante: a opção de transação digitada ainda não é suportada pelo PagSeguro no

modelo de TEF.
VERSÃO 1.2.1
Fluxo de Generate AC e Tratamentos Correspondentes

A tabela a seguir apresenta alguns conceitos utilizados no decorrer desta seção. Tratam-se de siglas
do fluxograma EMV.
SIGLA DESCRIÇÃO
TC Transaction Certificate.
ARQC Authorization Request Encryption.
AAC Application Authentication Encryption.
Fail-1 Situação de Unable to Go Online (TAC e IAC em processamento padrão).
Fail-2 Transação negada online, portanto nada é enviado ao autorizador neste caso.
Solicitação de transação online com dados da 1st Generate AC, pendente de

0200-1
confirmação.
0202-1 Confirmação com dados da 2nd Generate AC.
0220-1 Advice de transação off-line aprovada com dados da 1st Generate AC.
0220-2 Advice de transação off-line negada com dados da 1st Generate AC.
0220-3 Advice de transação off-line aprovada com dados da 2nd Generate AC.
0220-4 Advice de transação off-line negada com dados da 2nd Generate AC.
0420-1 Desfazimento. TAC e IAC com dados padrão para a 2nd Generate AC.
0420-2 Advice de transação aprovada pelo autorizador, mas negada pelo chip.
Tabela 1 – Siglas do fluxograma EMV
VERSÃO 1.2.1
A geração do criptograma ARQC resulta na solicitação online. Estão descritos a seguir alguns cenários de
desfecho de transação, bem como uma representação do fluxograma EMV.
Resultado da 1st Generate AC (Application Encryption)
TC ARQC AAC
0220-1 0200-1 Fail-1 0220-2
Sim 0210 Não

Aprovada? 0420-1
2nd AC 2nd AC Resultado da 2nd AC
TC AAC AAC TC AAC
0202-1 0420-2 Fail-2 0220-3 0220-4
Figura 26 – Fluxograma EMV
Transação aprovada pelo emissor e aprovada pelo cartão

A transação sofre um fluxo semelhante ao da tarja magnética. Em transações online com chip EMV, o
emissor pode instruir o processamento de scripts para a atualização do cartão, ao enviar as tags EMV 71 e/ou
72 na mensagem de resposta. Isso pode ocorrer tanto para transações aprovadas quanto para as negadas. O
resultado do processamento desses scripts é armazenado no chip (tag EMV 9F5B).
Os dados do 2nd Generate AC são enviados para o autorizador no fluxo da confirmação da transação,
o qual deve incluir a tag EMV 9F5B quando ela estiver presente na configuração do AID em processamento e
o emissor solicitar o processamento dos scripts na transação.
Transação negada pelo emissor

Tal qual ocorre no fluxo da tarja magnética, uma negação à transação de solicitação irá abortar o fluxo
de compra. Neste caso o resultado do processamento dos scripts não será enviado pelo concentrador TEF ao
autorizador.
VERSÃO 1.2.1
Transação aprovada pelo emissor e negada pelo cartão

Pode acontecer caso o emissor aprove a transação no modo online e o cartão a negue durante o
processamento do 2nd Generate AC (gera criptograma AAC). Neste caso, a aplicação deve gerar a transação
de desfazimento.
Unable to go online
O cartão gera o criptograma ARQC para realizar a transação no modo online, porém não há conexão
com o emissor. Neste caso, a aplicação processa o fluxo de desfazimento e assume os valores padrão para o
TAC e IAC para efetuar o 2nd Generate AC. Neste ponto, a transação poderá ser tanto aprovada (criptograma
TC) quanto negada (criptograma AAC) off-line. Em ambos os casos, uma transação de advice é enviada ao
autorizador, informando no bit 39 a situação atual, de acordo com os parâmetros AID em tratamento.
Compra 0200: Solicitação EMV Perdida
Unable to Go Online

Advice 0220: Aviso
Advice 0230: Resposta
Figura 27 – Fluxo EMV Unable To Go Online
A geração do criptograma TC no 1st Generate AC indica que a transação foi aprovada 24lineff-lineff-
line. Ela deve ser enviada para o autorizador com o bit 55 preenchido com os dados do 1st Generate AC. O
comprovante apropriado deve ser impresso neste caso.
Por fim, a geração do criptograma AAC no 1st Generate AC indica que a transação foi negada 24lineff-
lineff-line. A transação também é enviada ao autorizador com o bit 55 preenchido com os dados do 1st
Generate AC. Não é impresso nenhum comprovante nesta situação.
Criptografia de Senha
A senha é trafegada criptografada com a BDK do PagSeguro. O único tipo de criptografia previsto para
este processo é o 3DES DUKPT.
VERSÃO 1.2.1
Criptografia do Cartão e CVV

Serão criptografados todos os números do PAN do cartão, com exceção aos 6 primeiros dígitos e os 4
últimos dígitos (Bin e Holder), os 16 bytes pós-sentinela (=) da Trilha 2, o CVV e a Trilha 1 (se preenchidos).
Para a metodologia adotada, serão utilizadas chaves 3DES com o algoritmo 3DES/EDE em modo CBC. O
método de criptografia 3DES em modo CBC pode ser feito utilizando o comando “encryptBuffer” dos PinpPads
contendo biblioteca compartilhada ou ABECS. Obs: Este processo é válido apenas para modos de entrada de
Trilha Magnética, Fallback Magnético e Chip
Figura 28 – API de Criptografia Biblioteca Compartilhada

A Working Key a ser utilizada por um PinPad é obtida através da Mensagem de “Carga de
Chaves” (0800 com Bit 3 = 008020). Nesta mensagem, uma tabela de chaves é retornada e através de um
processo de Challenge, o PinPad utiliza uma das chaves disponíveis.
Requisitos
Como requisito do método criptográfico, os seguintes dados devem estar presentes no terminal:
• Master Key de dados do adquirente na posição determinada pelo mapa de chaves ABECS;
• Working Key Obtida da Tabela de Chaves;
• Número de série do terminal;
• Valor da Transação (Bit 4)
• Número randômico, gerado pela solução, 8 bytes (ou 16 dígitos hexa);
• Trilha 2 do Cartão;
• CVV (se preenchido, apenas para Venda);
• Trilha 1 (se foi lida);
VERSÃO 1.2.1
Processo Criptográfico
Após a obtenção da Carga de Chaves, a tabela contendo uma Lista de Chaves que deve ser iterada. A tabela
contém 3 campos: Identificador, Chave e Desafio. O terminal deve Encriptar um buffer de 8 bytes zerado em
modo 3DES/EDE/ECB, e caso o valor seja igual ao Challenge, guardar o identificador e a chave para o PinPad
utilizar, até uma nova carga ser feita.
Exemplo de Tabela de Chaves:
Identificador Chave Desafio

AABBCCDD01 29014829014829016908091234809101 1923059105914912
DDCAFADA48 804509938F5470A8604D3F401F6D1A91 86930B49EFA4BB2C
Para iniciar o processo criptográfico, o IV é formado de acordo com a tabela:
8 bytes 8 bytes IV (8 bytes)

Primeiros 8 dígitos do Bin do Cartão + Valor da XOR entre os blocos 1 e 2
Número de Série do PinPad Transação alinhado com ‘0’ a
em formato BCD esquerda
3135313132505033 6250120000000200 5365233132505233
O bloco a ser criptografado é formado de acordo com a tabela:
8 bytes 8 bytes 8 bytes N bytes (div por 8)

Bloco Randômico 16 Dígitos da Trilha CVV alinhado com Todos dígitos da Trilha1, em formato
2 coletados após a ‘F’ à esquerda (5 BCD. Adicionar Padding PKCS#5 no final
sentinela ‘=’ posições) + para o bloco ser múltiplo de 8 bytes (de
Digitos entre Bin e 1 a 8 bytes com valor igual a 8 - ||M||
Holder + padding mod 8).
‘0’
E1010920FF03AC07 2512220085130519 FF12399999900000 423632353031323939393939393532353
35E5445535420434152442049534F205E
323130333130313135302020202034353
03030303030303030303030030303
O resultado será obtido através da aplicação do Algorítmo 3DES/EDE/CBC do IV e dos 3 ou mais blocos
formados anteriormente. O bloco Encriptado deve ser enviado no Bit 48-020, e o Id da chave utilizada no Bit
48-019.
A Trilha 2 deve ser mascarada e transportada desde o PinPad desta maneira, de acordo com a tabela a seguir,
a Trilha 1 e o CVV não devem ser transportados fora do bloco Encriptado.
Bin Secreto Holder Sentinela Secreto Restante

6 digitos N dígitos – 4 últimos = 16 dígitos pós N dígitos
iniciais preencher dígitos pre- sentinela – restantes
com 0 sentinela preencher com F
411111 000000 6548 = FFFFFFFFFFFFFFFF 0102...
Obs: Este processo criptográfico é detalhado mais profundamente no Anexo A.
VERSÃO 1.2.1
Detalhamento das Mensagens ISO-8583
Regras dos Campos

Tipos de Campo
SIGLA DESCRIÇÃO
N Campo numérico (ASCII) com o tamanho representado em bytes.
A Campo alfabético (ASCII) com o tamanho representado em bytes.
AN Campo alfanumérico (ASCII) com o tamanho representado em bytes.
H Campo hexadecimal (ASCII) com o tamanho representado em bytes.
B Campo binário com o tamanho representado em bits.
Tabela 2 – Tipos de campo na mensageria ISO-8583
Tamanhos de Campo
TIPO DESCRIÇÃO
Os campos fixos não precisam explicitar o tamanho na mensagem.

Fixo
Exemplo: O bit 3 tem tamanho fixo 6.
• Um campo de valor 003000 será representado como 003000 na mensagem.
Os campos deste tipo são precedidos pelo tamanho representado por 2 bytes.
LLVar Exemplo: O bit 2 é LLVar e o tamanho pode variar de 1 até 99.

• Um campo de valor 444444 será representado como 06444444 na
mensagem.
Os campos deste tipo são precedidos pelo tamanho representado por 3 bytes.
LLLVar
Exemplo: O bit 48 é LLLVar e o tamanho pode variar de 1 até 999.
• Um campo de valor 33333 será representado como 00533333 na mensagem.
Tabela 3 – Tamanhos de campo na mensageria ISO-8583
VERSÃO 1.2.1
Campos no Formato TLV

Alguns campos da mensagem estão no formato TLV (Tag-Length-Value). Este formato dita que cada
dado tem uma identificação (Tag), seguida do respectivo tamanho (Length) e então do conteúdo propriamente
dito (Value). Portanto, como todos os dados têm identificação e tamanho, a ordem dos dados na mensagem
é flexível.
• Tag será representada por 3 bytes ASCII.

• Length será representada por 3 bytes ASCII.
• Value terá Length bytes.
DETALHAMENTO DOS BUFFERS TLV
0 0 1 0 0 5 T E S T E 0 0 2 0 0 1 X 0 0 3 0 1 6 A B C D E F 0 1 2 3 4 5 6 7 8 9
T L V T L V T L V
Tabela 4 – Exemplo de campo TLV
Tabela de Bits Utilizados

BIT IDENTIFICAÇÃO TIPO TAMANHO DESCRIÇÃO
Número do cartão digitado no terminal, quando não

LLVar
002 Número do Cartão N obtido via tarja magnética. *Não é utilizado
1-19
atualmente.
Código de identificação da transação. As entradas

marcadas abaixo com (*) ainda não são suportadas pelo
PagSeguro no modelo de TEF.
VALOR DESCRIÇÃO
008000 Logon
008001 Echo
008010 Carga de Tabelas
008020 Carga de Chaves
003000 Compra Crédito à Vista
Código de Fixo
003 N 003800 Compra Crédito Sem Juros (Loja)
Processamento 6
003810 Compra Crédito Com Juros (Emissor)*
003009 Compra Crédito IATA*
003001 Pré-autorização à Vista*
003002 Captura Pré-autorização*
003803 Captura Pré-autorização
Sem Juros (Loja) *
003804 Captura Pré-autorização
Com Juros (Emissor) *
002000 Compra Débito à Vista
VERSÃO 1.2.1
180000 Compra Débito Voucher

200030 Estorno Compra Crédito
200020 Estorno Compra Débito
203001 Cancelamento Pré-autorização*
203002 Estorno Captura Pré-autorização*
Valor total da transação em centavos. Também permite

Fixo
004 Valor Total N retornar o saldo do cliente na transação de consulta.
12
Data GMT da Fixo Data e horário GMT da transmissão no formato

007 N
Transmissão 10 MMDDHHMMSS.
Número de identificação da transação no concentrador

TEF.
Fixo
011 NSU do TEF N
6
Este campo deve permanecer o mesmo durante todo o
processamento da operação em tratamento.
Fixo
012 Hora Local N Hora local da transação no formato HHMMSS.
6
Fixo
013 Data Local N Data local da transação no formato MMDD.
4
Fixo Data de vencimento do cartão, quando não obtido via

014 Data de Validade N
4 tarja magnética. Formato AAMM.
Fixo Data de referência deve ser enviada com o mesmo valor

015 Data de Referência N
4 do bit 13
Modo de entrada do cartão. As entradas marcadas

abaixo com (*) ainda não são suportadas pelo
PagSeguro no modelo de TEF.
VALOR DESCRIÇÃO
Fixo 011 Entrada digitada*
022 Modo de Entrada N
3 021 Entrada via tarja magnética
051 Entrada chip EMV
791 Fallback digitado*
801 Fallback magnético
810 E-commerce*
Presente em transações EMV. Contém o mesmo valor

Número de Fixo
023 N da tag EMV 5F34 e está justificado para a direita com
Sequência do Cartão 3
zeros ASCII à esquerda.
VERSÃO 1.2.1
Trilha2 do cartão. Este campo está presente quando é

LLVar
035 Trilha2 do Cartão N feita a leitura da tarja magnética ou a leitura do chip
1-37
EMV.
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). O NSU possui o seguinte
formato:
Fixo
037 NSU do Autorizador AN 000
12
Dia da Semana (1 a 7)
Hora GMT do dia (00 a 23)
Contador (000001 a 999999)
Exemplo: Segunda-feira, 13 horas, contador 100001:

000213100001
Código de Fixo Código de autorização da transação atribuída pela rede

038 AN
Autorização 6 emissora do cartão.
Os códigos de resposta devem seguir o formato

indicado abaixo.
Fixo
039 Código de Resposta AN VALOR DESCRIÇÃO
2
=00 Transação aprovada.
≠00 Transação negada.
Identificação do Fixo Identificação do terminal que efetuou a solicitação ao

041 AN
Terminal 8 TEF.
Código de origem da mensagem. Este código é único e

Fixo
042 Identificação do EC AN identifica a loja que está enviando a transação ao
15
autorizador.
Trilha1 do cartão. Este campo está presente quando é

LLVar
045 Trilha1 do Cartão AN feita a leitura da tarja magnética ou a leitura do chip
1-76
EMV.
LLLVar Dados adicionais que não estão presentes em campos

048 Dados Adicionais AN
1-999 ISO-8583. Detalhamento na seção correspondente.
Fixo Código da moeda do país em que a transação foi

049 Código da Moeda N
3 efetuada.
Fixo Senha criptografada, para transações com cartões que

052 Senha do Cartão H
16 requerem PIN online.
VERSÃO 1.2.1
Tags EMV em transações feitas com processamento de

LLLVar chip. O conteúdo deste campo está de acordo com o
055 Dados EMV H
1-999 formato BER-TLV.
Detalhamento na seção correspondente.
Dados adicionais que podem ser enviados ao

Dados Adicionais do LLLVar
062 AN concentrador TEF.
Autorizador 1 1-999
Dados adicionais que podem ser enviados ao

Dados Adicionais do LLLVar
063 AN concentrador TEF.
Autorizador 2 1-999
Fixo
067 Número de Parcelas N Número de parcelas da compra.
2
Código para o controle na inicialização do servidor TEF

junto ao autorizador.
VALOR DESCRIÇÃO
Código de Fixo
070 N 001 Tabelas do TEF atualizadas.
Gerenciamento 3
100 Tabelas do TEF desatualizadas.
010 Tabela de Chaves desatualizada
110 Ambas Tabelas desatualizadas
Dados estruturados conforme orientação abaixo:
FORMATO DESCRIÇÃO
001:004 Código da transação original. Por
exemplo, 0200 ou 0400.
005:010 NSU da transação original. Bit 11.
011:020 Data e horário GMT da transmissão
original. Bit 7.
021:032 NSU da autorizador da transação
Dados da Transação Fixo original, deve ser preenchido com
090 N zeros ASCII caso não esteja disponível.
Original 42
Bit 37.
033:035 Estado da Transação de Pagamento
Original após uma Requisição de
Estorno. Retornado apenas na
mensagem 0410.
Valores Possíveis:
000: n/a
002: estornado parcialmente
003: estornado totalmente
VERSÃO 1.2.1
Será enviado sempre 000 nas outras

mensagens.
036:042 Não utilizado. Preenchido com zeros
ASCII.
Tabela 5 - Detalhamento de bits ISO-8583
Importante: apesar de o padrão ISO-8583 prever dados alfanuméricos para o bit 37 (NSU
do Autorizador), alguns equipamentos legados de automação comercial podem conter
apenas teclado numérico. Caso essa situação seja identificada pelo integrador, a
orientação é entrar em contato com a equipe PagSeguro.
Dados Adicionais (Bit 48)

Este campo está no formato TLV e pode carregar diversas tags, conforme apresentado na tabela a
seguir.
TAG IDENTIFICAÇÃO TIPO TAMANHO DESCRIÇÃO
Versão das Tabelas

001 AN 10 Versão de tabelas do servidor TEF.
de TEF
Número de controle das pernas para a carga de tabelas a

Número de Controle
002 N 6 partir do autorizador. Este número é espelhado pelo
de Carga
servidor TEF durante o download das configurações.
Código de identificação do operador do caixa, se aplicável

003 Código do Operador AN 1-19
para o EC.
Código de segurança presente no verso dos cartões

magnéticos, conforme formato a seguir.
FORMATO DESCRIÇÃO
001:002 Indicador de presença do CVV2 ou CVC2.
Assume os valores:
004
Código de
AN 6 • 00 quando o código for
Segurança do Cartão desconsiderado ou não for
fornecido pelo EC;
• 01 quando o código estiver
presente;
• 02 quando o código estiver presente
no cartão, mas ilegível;
VERSÃO 1.2.1
• 09 quando o operador informa que

não há código impresso no cartão.
003:006 Visa CVV2 (Card Verification Value) ou
Mastercard CVC2 (Card Validation
Code).
Utilizado para auxiliar na detecção de

fraudes em transações sem entrada do
PIN. Este valor deve estar justificado à
direita com espaços em branco à
esquerda. O campo deve ser preenchido
com brancos se o código de segurança
não for coletado.
005 Cupom Fiscal N 1-12 Número do cupom fiscal.
Valor Taxa
006 N 12 Valor da taxa de embarque para transações IATA.
Embarque
007 Saldo Voucher N 9 Saldo do cliente para transações com voucher.
Key Serial Number, usado para criptografia da senha em

008 KSN H 20
DUKPT.
Dados da loja. Campo formado pela estrutura a seguir.

DESCRIÇÃO FORMATO TAMANHO
Nome fantasia Alfanumérico 22
Endereço Alfanumérico 48
Cidade Alfanumérico 13
UF Alfanumérico 2
País Alfanumérico 3
CEP Alfanumérico 10
MCC Numérico 4
009 SoftDescriptor AN 203 CNPJ/CPF Numérico* 14
Telefone Numérico* 11
Razão Social/Nome Alfanumérico 60
Completo
Tipo de Pessoa Alfanumérico 1
(F ou J)
Facilitator Merchant Alfanumérico 15
ID
* estes campos devem ser alinhados com espaços (brancos) à

esquerda.
VERSÃO 1.2.1
Dados de autenticação, para e-commerce. Campo

formado pela seguinte estrutura:
010 MPI (3-D Secure) AN 82 DESCRIÇÃO FORMATO TAMANHO

Autenticação XID Alfanumérico 40
Autenticação UCAF Alfanumérico 40
Autenticação ECI Alfanumérico 2
Nome Fabricante Auxiliar no “trace” da transação de equipes de suporte

011 AN 1-20
Software TEF envolvidas. Ex: SoftwareExpress, NTK, etc.
012 Versão Software TEF ANS 1-16 Versão da aplicação do software TEF.
Versão da biblioteca
013 AN 1-16
do PINpad
Versão da aplicação
014 AN 1-16
do PinPad
Número de série do
015 ANS 1-40
PinPad
Fabricante do
016 AN 1-20
PinPad
017 Modelo do PinPad AN 1-20
Versão especificação Versão da especificação TEF utilizada.

018 ANS 1-16 Enviar: ISOPag-1.2.1
TEF
Identificador da Identificador da Chave utilizada pelo PinPad para

019 ANS 10 Criptografar os dados sensíveis da Transação
Working Key
Bloco criptográfico contendo os dígitos criptografados

020 Dados Criptográficos H 48-999 do Cartão
Versão da Tabela de
021 ANS 16 Versão da Tabela de Chaves
Chaves
Tabela 6 - Detalhamento do bit 48
VERSÃO 1.2.1
Dados Adicionais do Autorizador (Bits 62 e 63)

Os dados adicionais do autorizador podem se enquadrar em duas situações distintas. Uma é o uso
para transações de carga de tabelas, outra é o uso para qualquer outra transação diferente da carga de tabelas,
denominadas neste documento como transações financeiras.
Transações Financeiras
Os campos podem ser enviados ao PDV com uma mensagem para ser exibida no display ou com o
cupom formatado para impressão.
Em transações aprovadas, contém o cupom a ser impresso no formato descrito a seguir. Caso apenas
o bit 62 esteja presente, o mesmo cupom será impresso como via do EC e via do cliente; caso os dois bits
estejam presentes, o bit 62 representará a via do EC e o bit 63 a via do cliente.
Para transações aprovadas com débito voucher, é obrigatório o envio da via do cliente (bit 62) e do EC
(bit 63), pois o saldo do cliente deve estar presente apenas em sua via. Quando a transação é negada, pode
ser utilizado o bit 48 para retorno do saldo do cliente para compor uma mensagem de retorno ao operador.
• F – Seguido do texto a imprimir. O texto é formatado pelo autorizador para impressora de 38 colunas,
com linhas delimitadas pelo caráter arroba (@).
Já para transações negadas, mensagens de erro devem ser exibidas no formato abaixo, unicamente
para o bit 62:
• D – Seguido por até duas mensagens de falha de tamanho variável, separadas pelo caractere #. Elas
devem ser apresentadas distintamente, a primeira para exibição no visor do cliente e a segunda no
visor do operador.
Transações de Carga de Tabelas

Neste caso, os dois bits assumem o formato TLV e podem carregar tags conforme descrito a seguir.
Todos os campos presentes nessa tabela têm seus dados detalhados no capítulo sobre Parâmetros de
Inicialização.
Tabela de Há uma ocorrência desta tabela por EC, ou seja, a carga

001 AN 1-999
Parâmetros do EC deve retornar apenas uma tabela de EC.
Há uma ocorrência desta tabela para cada BIN

002 Tabela de Bins AN 1-999
habilitado no EC.
Tabela de Bins Há uma ocorrência desta tabela para cada BIN Especial
003 AN 1-999
Especiais habilitado no EC.
Há uma ocorrência desta tabela para cada produto

004 Tabela de Produtos AN 1-999
habilitado no EC.
Tabela de
Há uma ocorrência desta tabela para cada transação
005 Parâmetros das AN 1-999
habilitada no EC.
Transações
Tabela de Há uma ocorrência desta tabela para cada produto

006 AN 1-999
Funcionalidades habilitado no EC.
VERSÃO 1.2.1
Habilitadas por
Produto
Tabela de Códigos Há uma ocorrência desta tabela para cada

007 AN 1-999
das Funcionalidades funcionalidade (transação) habilitada no EC.
Há uma ocorrência desta tabela para cada AID da tabela

008 Tabela de TAGS EMV AN 1-999
de aplicações EMV.
Tabela de TAGS EMV Há uma ocorrência desta tabela para cada AID da tabela
009 AN 1-999
Second Generate de aplicações EMV.
Tabela de Chaves de
010 AN 1-999 Há uma ocorrência desta tabela somente.
Criptografia
Tabela de Aplicações Há uma ocorrência desta tabela para cada AID

011 AN 1-999
EMV habilitado no EC.
Tabela de Chaves Há uma ocorrência desta tabela para cada chave

012 AN 1-999
Públicas EMV pública habilitada no EC.
Tabela de Chaves de Retornada apenas na Mensagem de Carga de Chaves

013 ANS 1-999
PinPad (bit 3 = "008020").
Tabela 7 - Detalhamento dos bits 62 e 63
VERSÃO 1.2.1
Parâmetros de Inicialização
Tabela de Parâmetros do Estabelecimento

Esta tabela contém os parâmetros associados ao EC em tratamento. Todos os parâmetros e
respectivas informações são apresentados na tabela a seguir.
IDENTIFICAÇÃO TIPO TAMANHO DESCRIÇÃO
Pode ser utilizado na impressão de comprovante de

Nome do EC AN 38
transações aprovadas off-line.
Linha 1 do endereço, pode ser utilizado na impressão de

Endereço do EC AN 38
comprovante de transações aprovadas off-line.
Endereço do EC AN 38 Linha 2 do endereço
Pode ser utilizado na impressão de comprovante de

Símbolo da Moeda AN 4
transações aprovadas off-line.
Terminal Currency
N 3 Tag EMV 5F2A
Code
Transaction Currency
N 1 Tag EMV 5F36
Exponent
Terminal Country
N 3 Tag EMV 9F1A
Code
Merchant Category
N 4 Tag EMV 9F15
Code (MCC)
Se o bit estiver ativo, a configuração correspondente estará

habilitada. IMPORTANTE: uma característica habilitada
nesta tabela será considerada habilitada pela aplicação se
a mesma também estiver habilitada na tabela do produto
em tratamento.
BIT DESCRIÇÃO
Parâmetros Gerais - 8 Entrada Manual do PAN.
B 8
Byte 1 7 Permite Chip.
6 Permite Fallback Magnético.
5 Permite Fallback Digitado.
4 Transação digitada solicita CVV2/CVC2.
3 Transação magnética solicita CVV2/CVC2.
2 Permite CVV2/CVC2 inexistente ou ilegível.
1 Uso futuro.
VERSÃO 1.2.1
Conforme a seguir:
BIT DESCRIÇÃO
8 Criptografar número do cartão - Uso futuro.
7 Transação magnética solicita 4 últimos dígitos
(mesmo da Tabela de Produtos).
6 Permite Off-line EMV - Uso futuro.
Parâmetros Gerais - 5 Permite captura de dados e-commerce por
B 8
Byte 2
meio de um canal seguro (ex.: SSL) - Uso
futuro.
4 Permite captura de taxa de embarque
(aplicado para fluxo específico).
3 Uso futuro.
2 Uso futuro.
1 Uso futuro.
Parâmetros Gerais -
B 8 Uso futuro.
Byte 3
Tabela 8 - Parâmetros do Estabelecimento
Tabela de BINs
Um mesmo range de BINs deve ser baixado tantas vezes quantas forem os diferentes produtos aos
quais esteja associado. Vale observar que a ordem de formatação dos BINs nesta tabela deve ser a ordem
pesquisada pela aplicação. Assim, durante o processamento de uma transação, o primeiro range encontrado
na tabela e que contenha o BIN em tratamento, conforme produto selecionado, será o considerado.
Se existir um range de BINs igual para o mesmo produto, o primeiro BIN encontrado deve ser considerado.
BIN Inicial N 10 Corresponde ao BIN inicial do range.
BIN Final N 10 Corresponde ao BIN final do range.
Código do Produto Corresponde ao código da tabela de produtos (vide seção

N 3
Associado (FK) correspondente), para o range de BINs configurado.
Tabela 9 - Parâmetros de BINs
VERSÃO 1.2.1
Tabela de BINs Especiais

Esta tabela contém os ranges de BINs que têm características específicas no EC em tratamento,
distintas do padrão. Pode haver, por exemplo, um cartão que é tratado como crédito na maioria dos ECs,
porém é tratado como Private Label no EC em questão. Assim, a aplicação deve procurar primeiramente o BIN
em tratamento na tabela de BINs Especiais.
BIN Inicial N 10 Corresponde ao BIN inicial do range.
BIN Final N 10 Corresponde ao BIN final do range.
Código do Produto Corresponde ao código da tabela de produtos (vide seção

N 3
Associado (FK) correspondente), para o range de BINs configurado.
Tabela 10 - Parâmetros de BINs Especiais
Tabela de Produtos
Código do Produto Código que identifica unicamente um produto tratado pelo

N 3
(PK) EC.
Nome do emissor ou do produto correspondente ao range

de BINs associados, isto é:
Nome do Produto AN 20
• Crédito: VISA, MASTERCARD, etc.;
• Débito: ELECTRON, MAESTRO, etc..
TIPO DESCRIÇÃO
01 Crédito
Tipo do Produto N 2
02 Débito
03 Voucher
A posição 8 corresponde ao bit mais significativo: se o bit

estiver ativo, a configuração correspondente estará
habilitada. IMPORTANTE: uma característica habilitada
nesta tabela será considerada habilitada pela aplicação se
a mesma também estiver habilitada na tabela de
Características do parâmetros do EC. Seguem as possíveis configurações:
B 8
Cartão - Byte 1
BIT DESCRIÇÃO
8 Permite entrada manual do PAN.
7 Permite chip.
6 Permite fallback magnético.
VERSÃO 1.2.1
5 Permite fallback digitado.

4 Transação digitada solicita CVV2/CVC2.
3 Transação magnética solicita CVV2/CVC2.
2 Permite CVV2/CVC2 inexistente ou ilegível.
1 Uso futuro.
Continuação do campo anterior:
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 o PIN ser tratado de acordo com a
posição 3 do Service Code:
Características do • 1 = avalia o Service Code;
B 8 • 0 = não solicita PIN.
Cartão - Byte 2
6 Indicador sobre a transação magnética requerer os
4 últimos dígitos (“E” lógico com a Tabela de
Parâmetros do Estabelecimento).
5 Uso futuro.
4 Uso futuro.
3 Uso futuro.
2 Uso futuro.
1 Uso futuro.
Características do
B 8 Uso futuro.
Cartão - Byte 3
Quantidade de dígitos do número do cartão, da esquerda

Máscara do PAN -
N 2 para a direita, que devem ser apresentados abertos nos
Início
comprovantes e relatórios.
Quantidade de dígitos do número do cartão, da direita para

a esquerda, que devem ser apresentados abertos nos
comprovantes e relatórios.
Máscara do PAN -
N 2
Final
Por exemplo, assumindo que o parâmetro anterior seja “6”
e esse parâmetro seja “2”, o PAN 9876543210123456 será
apresentado da seguinte forma: 987654********56.
Código da Tabela de Código da Tabela de Funcionalidades Habilitadas por

Funcionalidades N 3 Produto. Esta conexão mostra as transações habilitadas
Habilitadas (FK) para o produto em questão.
VERSÃO 1.2.1
Código AID N 2 Índice da Tabela de Aplicações EMV.
Tabela 11 - Parâmetros de Produtos
Tabela de Funcionalidades Habilitadas por Produto

Esta tabela tem como objetivo configurar as funcionalidades habilitadas para cada produto operado
no EC.
Código da Funcionalidade Código que identifica um grupo de transações que

N 3
(PK) estão habilitadas para cada produto.
Define o número de transações oferecidas para o

Número de Características N 2
produto em questão.
Código do Parâmetro De acordo com a Tabela de Parâmetros da Transação,

N 3
da Transação (FK)*** vide seção correspondente.
Tabela 12 - Parâmetros de Funcionalidades Habilitadas por Produto

*** O campo Código do Parâmetro da Transação (FK) deverá conter a mesma quantidade de códigos
apontados no Números de Características, ou seja, a representação do campo Código do Parâmetro da
Transação (FK) será = (Código do Parâmetro da Transação (FK) * Números de Características).
Exemplos:
1. Se Números de Características = 01
Código do Parâmetro da Transação (FK) = 001
2. Se Números de Características = 03
Código do Parâmetro da Transação (FK) = 001003005
Tabela de Parâmetros da Transação

Define as características de cada transação habilitada no EC. Devem ser configurados apenas os
parâmetros relevantes para a funcionalidade em tratamento, os quais serão devidamente tratados pela
aplicação. Parâmetros irrelevantes devem ser formatados com zeros.
A funcionalidade que não necessitar de quaisquer parâmetros configurados não deve formatar esta
tabela durante a baixa de parâmetros no EC.
Código do Código que identifica especificamente uma transação e as

Parâmetro da N 3 características determinadas.
Transação (PK)
Código da Função Código de acordo com a Tabela de Códigos das Funcionalidades,

N 2
(FK) vide seção correspondente.
VERSÃO 1.2.1
Nome da Etiqueta da transação (utilizado em transações off-line).

AN 20
Transação
Características da Uso futuro.

B 8
Transação - Byte 1
Características da Uso futuro.

B 8
Transação - Byte 2
Os campos de valor devem incluir duas casas decimais em sua

formatação; quando não utilizados, preencher com zeros.
Seguem os possíveis parâmetros que podem ser configurados
para as transações habilitadas no EC:
TIPO TAM. DESCRIÇÃO

Parâmetros Gerais N 18 N 2 Número máximo de parcelas.
N 12 Valor mínimo por parcela.
Porcentagem máxima do valor habilitado
N 2
para a captura de pré-autorização.
Porcentagem mínima do valor habilitado
N 2
para a captura de pré-autorização.
Tabela 13 - Parâmetros de Transações
Tabela de Códigos das Funcionalidades

Contém as transações especificadas neste documento e seus respectivos códigos,
independentemente do tipo de processamento, online ou off-line. As entradas marcadas abaixo com (*)
ainda não são suportadas pelo PagSeguro no modelo de TEF.
CÓDIGO IDENTIFICAÇÃO
01 Compra com crédito (à vista).
02 Compra com crédito parcelado com juros (emissor).*
03 Compra com crédito parcelado sem juros (loja).
04 Pré-autorização de crédito à vista.*
05 Captura de pré-autorização.*
06 Compra com crédito IATA.*
09 até 49 Reservado para funcionalidades de crédito.
VERSÃO 1.2.1
CÓDIGO IDENTIFICAÇÃO
50 Compra com débito.
51 Compra com débito voucher.
51 até 60 Reservado para funcionalidades de débito.
Tabela 14 - Parâmetros de Códigos das Funcionalidades
Tabela de Tags EMV - First Generate

Configuração das tags EMV obrigatórias, as quais devem ser formatadas nas mensagens originadas no
EC, sempre que retornadas no processamento do chip, tanto para transações online quanto off-line. Uma
ocorrência desta estrutura deve ser baixada para cada AID aceito pelo EC. Todo o conjunto de tags, por sua
vez, deve ser capturado na First Generate (mais detalhes no fluxograma de Generate AC apresentado
previamente).
Código AID N 2 Código AID que configura as tags em questão.
Lista de tags EMV a serem enviadas no bit 55 das

Conjunto Completo mensagens de solicitação ou advice de transações do fluxo
B Variável
de Tags EMV EMV Completo, tanto online quanto off-line, após o First
Generate AC. Exemplo: 9F269F27959F10.
Tabela 15 - Parâmetros de Tags EMV obrigatórias em First Generate
Tabela de Tags EMV - Second Generate

Configuração das tags EMV obrigatórias, as quais devem ser formatadas nas estruturas de
Confirmação de Transações aprovadas em modo online. Uma ocorrência desta estrutura deve ser baixada
para cada AID aceito pelo EC. Todo o conjunto de tags, por sua vez, deve ser capturado na Second Generate
(mais detalhes no fluxograma de Generate AC apresentado previamente).
Código AID N 2 Código AID que configura as tags em questão.
Lista de tags EMV a serem enviadas no bit 55 das

Conjunto Completo mensagens de solicitação ou advice de transações do fluxo
B Variável
de Tags EMV EMV Completo, tanto online quanto off-line, após o Second
Generate AC. Exemplo: 9F269F27959F10.
Tabela 16 - Parâmetros de Tags EMV obrigatórias em Second Generate
VERSÃO 1.2.1
Tabela de Chaves de Criptografia

Parâmetros que definem a chave de criptografia primária.
Código identificador da criptografia. Valor fixo e único

Código de ID N 2
formato previsto: 01 (3DES DUKPT).
Índice da Master Key N 2 Índice da Master Key utilizada no PINpad ou POS.
Tabela 17 - Parâmetros de chaves de criptografia
Tabela de Aplicações EMV - AID

Índice Código AID N 2 Índice AID na tabela.
- Tamanho do AID N 2 Tamanho do AID variando de 05 a 16.
Identificador da aplicação. Justificado à esquerda com

9F06 AID H 32
zeros ASCII à direita.
Assume dois valores:
VALOR DESCRIÇÃO
- Tipo da Aplicação N 2
01 Aplicação de crédito
02 Aplicação de débito
- Label Padrão AN 16 Nome padrão da aplicação.
9F09 AID Version 1 H 4 Versão suportada AIDs, opção número 1.
Terminal Country Código do país.

9F1A N 3
Code
Transaction Código da moeda.

5F2A N 3
Currency Code
Indicador do separador decimal do valor do código da

5F36 TCC Exponent N 1
moeda.
Merchant Category Código da categoria do EC.

9F15 N 4
Code
VERSÃO 1.2.1
Mapa de bits convertido para ASCII, indicando as

capacidades do terminal. Obedece ao formato
ABC00000DEFG0000HIJ00000, cujos valores são
descritos a seguir:
VALOR DESCRIÇÃO
A Digitação do número do cartão.
B Cartão magnético.
C Cartão do chip de contatos.
D Verificação em cartão com chip de PIN
Terminal em aberto.
9F33 H 6
Capabilities E Verificação online de PIN com
criptografia.
F Assinatura em papel.
G Verificação em cartão com chip de PIN
com criptografia.
H Autenticação estática de dados (SDA) do
cartão com chip.
I Autenticação dinâmica de dados (DDA)
do cartão com chip.
J Captura de cartão.
Mapa de bits convertido para ASCII, indicando as

capacidades adicionais do terminal. Formato
ABCDEFGHI0000000JKLM0000NOPQ00RRRRRRRRRR,
cujos valores são descritos a seguir:
VALOR DESCRIÇÃO
A Dinheiro.
B Bens.
C Serviços.
D Cashback.
Additional Terminal E Consulta.
9F40 H 10
Capabilities F Transferência.
G Pagamento.
H Administrativo.
I Depósito em dinheiro.
J Teclas numéricas.
K Teclas alfabéticas e caracteres especiais.
L Teclas de comando.
M Teclas de função.
N Imprimir, atendente.
O Imprimir, portador do cartão.
VERSÃO 1.2.1
P Display, atendente.
Q Display, portador do cartão.
R Código da tabela #10 a #1.
Assume os valores a seguir:
VALOR DESCRIÇÃO
21 Online.
22 Off-line com capacidade online.
9F35 Terminal Type N 2 23 Somente off-line.
24 Online, não atendido.
25 Off-line com capacidade online, não
atendido.
26 Somente off-line não atendido.
- TAC Default H 10 Terminal Action Code - Default.
- TAC Denial H 10 Terminal Action Code - Denial.
- TAC Online H 10 Terminal Action Code - Online.
Terminal Floor Limit, em centavos. Usado no

tratamento de risco, vale notar que o campo não é
numérico, portanto é necessário converter o valor em
centavos para binário e enfim formatar em caracteres
9F1B Floor Limit H 8 ASCII hexadecimais.
Visto que transações off-line ainda não são

suportadas pelo PagSeguro no modelo de TEF, este
campo deve ser preenchido com zeros.
Código da Atualmente assume somente o valor R.

9F53 Categoria da AN 1
Transação
Default Transaction Certificate Data Object List

- TDOL H 40
completado com zeros ASCII à direita.
Default Dynamic Data Authentication Data Object List

- DDOL H 40
completado com zeros ASCII à direita.
Porcentagem alvo a ser utilizada na seleção Biased

- Porcentagem Alvo N 2
Random para tratamento de risco.
Valor limite para a seleção Biased Random para

- Valor Limite N 4
tratamento de risco.
VERSÃO 1.2.1
Máxima Máxima porcentagem alvo a ser utilizada na seleção

- N 2
Porcentagem Alvo Biased Random para tratamento de risco.
Tabela 18 - Parâmetros de Aplicações EMV
Tabela de Chaves Públicas

- RID N 10 Registered Application Provider Identifier.
9F22 CA Public Key Index H 2 Certification Authority Public Key Index.
- CA Public Key N 1 Tamanho em bytes do Certification Authority Public

Exponent Length Key Exponent (próximo campo).
- CA Public Key H 6 Certification Authority Public Key Exponent, justificado

Exponent à esquerda com zeros ASCII à direita.
- CA Public Key N 3 Tamanho em bytes da CA Public Key.

Length
- CA Public Key H 496 Certification Authority Public Key Value, justificado à

esquerda com zeros ASCII à direita.
- Checksum Status N 1 Assume os valores abaixo:
VALOR DESCRIÇÃO
0 Não fornecido.
1 Presente.
2 Presente e com criptografia DES.
3 Presente e com criptografia Triple DES.
- Checksum H 40 Certification Authority Public Key Check Sum (Hash

SHA-1). Preenchido com zeros ASCII, se não for
calculado.
- Índice da Master N 2 Caso o estado do checksum seja 2 ou 3, deve conter o

Key índice da master key.
- Working Key H 32 Working key caso o estado do checksum seja 2 ou 3.

Caso o estado do checksum seja 2, somente os
primeiros 8 bytes são utilizados.
Tabela 19 - Parâmetros de chaves públicas EMV
VERSÃO 1.2.1
Tabela de Chaves de PinPad

Tabela que define as Chaves de Trabalho para Encriptação das Trilhas 1 e 2 e CVV. Esta tabela pode
conter um ou mais registros por Fabricante / Modelo / Número de Série. A solução deve encontrar nesta
tabela qual chave deve utilizar para cada PinPad que possuir através da resolução do Challenge, conforme
proposto na seção “Criptografia do Cartão”.

Identificador da
AN 10 Identificador da Chave (preencher no Bit 48-019)
Chave
Chave de Chave de Trabalho encriptada Sobre a MasterKey do
AN 32
Trabalho PinPad
Desafio encriptado com a Chave de Trabalho
Desafio AN 16
Valor aberto em hexa: 0000000000000000
Tabela 20 – Tabela de Chaves de Trabalho
VERSÃO 1.2.1
Mensageria ISO-8583
A especificação da mensageria utilizada pelo PagSeguro é baseada no padrão ISO-8583, edição de
1987, amplamente adotado pelo mercado.
Formato
O formato das mensagens ISO-8583 de 1987 contém três partes, descritas nesta seção: o ID da
mensagem, o mapa de bits e os dados da transação.
ID da Mensagem
Campo ASCII de 4 posições que identifica o tipo de mensagem como, por exemplo, 0800 para Logon
e 0200 para Compras.
Mapa de Bits
O primeiro mapa de bits corresponde aos campos 1 a 64 e o segundo aos campos 65 a 128. Cada bit,
dentro desses dois mapas, codifica a presença ou a ausência do dado a que se refere dentro do campo de
dados, representado nos exemplos a seguir.
Quando um bit está ativo, significa que seu respectivo dado está presente na mensagem. O bit 1 é um
caso especial que, quando ativo, indica que o segundo mapa de bits está presente na mensagem.
O mapa de bits deve ser convertido para ASCII hexadecimal, portanto pode ocupar 16 ou 32 bytes,
dependendo da presença do segundo mapa de bits.
Dados da Transação
Consistem em uma sequência de campos, sem delimitadores entre seus elementos, que definem os
dados necessários em mensagens de solicitação ou de resposta. Esses campos são listados de 1 a 128, cada
um devidamente especificado no padrão ISO-8583, também chamados de bits. Por exemplo, o bit 3 representa
o código de processamento da mensagem e o bit 7, a data GMT da transmissão.
MENSAGEM ISO-8583
0 2 0 0 3 2 3 8 0 4 0 1 A 0 C 1 8 0 0 8 0 0 3 0 1 0 0 0 0 0 0 0 0 0 1 5 0 0 06
ID Mapa de Bits Bit 3 Bit 4
2 6 1 1 5 7 1 9 2 6 0 0 6 0 1 1 5 7 1 9 0 6 2 6 0 2 1 0 6 3 3 3 3 3 3 3 7 3 33
Bit 7 Bit 11 Bit 12 Bit 13 Bit 22 Bit 32 Bit 35
Tabela 21 - Exemplo de mensagem sem segundo mapa de bits
MENSAGEM ISO-8583
0 2 0 0 B 2 3 8 0 4 0 1 A 0 C 1 8 0 0 8 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 30
ID Mapa de Bits + Segundo Mapa de Bits Bit 3
1 0 0 0 0 0 0 0 0 0 1 5 0 0 0 6 2 6 1 1 5 7 1 9 2 6 0 0 6 0 1 1 5 7 1 9 0 6 26
Bit 4 Bit 7 Bit 11 Bit 12 Bit 13
Tabela 22 - Exemplo de mensagem com segundo mapa de bits
VERSÃO 1.2.1
Condições dos Campos Mapeados nas Mensagens

A condição de cada um dos bits (campos) dentro de cada uma das mensagens obedece aos critérios
abaixo.
SIGLA DESCRIÇÃO
M Campo é obrigatório (mandatório).
O Campo é opcional.
Campo obrigatório, com eco. Devolve o mesmo conteúdo do bit da mensagem anterior, ou seja,
ME se for uma resposta, ele repete o conteúdo do bit na solicitação e, se for uma confirmação, repete
o conteúdo do bit na resposta.
OE Campo opcional, com eco. Idem observação anterior.
- Campo ausente.
CNN Campo condicional sujeito a regras especiais.
Tabela 23 - Siglas referentes a campos na mensageria ISO-8583
Há uma série de condições especiais relacionadas à última sigla apresentada na tabela com os campos
da mensageria. A próxima tabela contém essas condições.
CÓDIGO DESCRIÇÃO
C00 Obrigatório se a solicitação foi aprovada (bit 39 é igual a 00).
C01 Opcional se a solicitação foi aprovada (bit 39 é igual a 00).
C02 Obrigatório se a solicitação foi negada (bit 39 é diferente de 00), opcional caso contrário.
C05 Presente se PIN online é solicitado para validar o cartão.
C10 Enviado apenas em transações com entrada digitada.
Enviado apenas em transações com entrada magnética. Leitura de tarja ou chip EMV.
• Se ocorreu a leitura da trilha 1 e 2, encriptar os dados sensíveis e enviar o BIT 35
mascarado;
C11
• Se ocorreu a leituta somente da trilha 2, encriptar e enviar somente o BIT 35
mascarado;
• Se transação com Chip EMV, encriptar e enviar o BIT 35 mascarado.
C12 Enviado apenas em transações EMV.
C13 Obrigatório para transações não EMV.
VERSÃO 1.2.1
CÓDIGO DESCRIÇÃO
C15 Enviado apenas em transações financeiras parceladas.
C18 Presente se a transação foi realizada com chip EMV e o emissor envia o dado (full grade).
C24 Preencher com o mesmo conteúdo do bit 11.
C25 Preencher de acordo com a configuração da tabela de AIDs para o caso em tratamento.
Obrigatório, deve ter o mesmo valor do bit da transação original. Exceto para a solicitação de
C28
Estorno Parcial, onde o valor pode ser menor que o da transação original.
C29 Obrigatório vir como 00 (aprovada), uma vez que é um aviso e não uma solicitação.
C34 Presente se houver dados EMV para envio na confirmação.
C80 Enviado apenas na última perna da transação.
C81 Enviado apenas quando existirem mais pernas da transação.
C82 Espelhado da perna anterior, ausente caso seja a primeira perna.
C83 Obrigatório apenas em transações financeiras IATA.
C84 Obrigatório apenas em transações de débito com voucher.
C85 Obrigatório para transações de Payments Facilitator.
C86 Alterado com o status final da transação de venda na posição 033:035
Tabela 24 - Condições especiais na mensageria ISO-8583
VERSÃO 1.2.1
Mapa de Bits ISO-8583

Segue a configuração dos bits presentes em cada uma das operações detalhadas no capítulo de
comunicação e fluxo de transações. As colunas identificam essas operações e as correspondentes mensagens
ISO-8583. As linhas apresentam cada um dos bits ISO-8583 utilizados.
Logon (0800)
BIT IDENTIFICAÇÃO 0800 0810 COMENTÁRIOS
003 Código de Processamento M ME Valor em 008000.
007 Data GMT da Transmissão M M Deve ser atualizado pelo autorizador.
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
037 NSU do Autorizador - M
039 Código de Resposta - M
041 Identificação do Terminal M ME
042 Identificação do Estabelecimento M ME
Enviar última versão baixada pelo

048-001 Versão de Tabelas do Servidor TEF M - Servidor, ou vazio se não houver
nenhuma
Nome do Fabricante do Software

048-011 M -
TEF
048-012 Versão do Software de TEF M -
048-018 Versão da Especificação de TEF M -
Enviar última versão baixada pelo

Versão da Tabela de Chaves do
048-021 M - Servidor, ou vazio se não houver
servidor TEF
nenhuma
070 Código de Gerenciamento - C00
Tabela 25 - Campos da transação de Logon
VERSÃO 1.2.1
Echo (0800)
007 Data GMT da Transmissão M ME Deve ser atualizado pelo autorizador.
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
037 NSU do Autorizador - ME
039 Código de Resposta - ME
Tabela 26 - Campos da transação de Echo
VERSÃO 1.2.1
Carga de Tabelas (0800)

011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
048-001 Versão de Tabelas do Servidor TEF - C80 Na última perna, traz o valor atualizado.
Servidor TEF espelha o que recebe na

048-002 Número de Controle de Carga C82 C81
perna anterior.
062 Dados Adicionais do Autorizador 1 - C00 Tabelas no formato TLV concatenadas.
063 Dados Adicionais do Autorizador 2 - C01 Tabelas no formato TLV concatenadas.
Tabela 27 - Campos da transação de Carga de Tabelas
VERSÃO 1.2.1
Carga de Chaves (0800)

011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
Versão da Tabela de Chaves do

048-021 - C80 Na última perna, traz o valor atualizado.
Servidor TEF
Servidor TEF espelha o que recebe na

048-002 Número de Controle de Carga C82 C81
perna anterior.
062 Dados Adicionais do Autorizador 1 - C00 Tabela no formato TLV concatenadas.
063 Dados Adicionais do Autorizador 2 - C01 Tabela no formato TLV concatenadas.
Tabela 28 - Campos da transação de Carga de Chaves
VERSÃO 1.2.1
Compra (0200)
Dado sensível que nunca deve ser

002 Número do Cartão C10 -
espelhado. * Não utilizado atualmente
003 Código de Processamento M ME Valor depende da transação.
004 Valor Total M ME
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
014 Data de Validade C10 -
Data de referência deve ser enviada com

015 Data de Referência M ME
o mesmo valor do bit 13
022 Modo de Entrada M -
023 Número de Sequência do Cartão C12 - Equivalente à tag EMV 5F34.
Dado sensível mascarado que nunca

035 Trilha2 do Cartão C11 -
deve ser espelhado.
038 Código de Autorização - C00

espelhado.

espelhado. Apenas os 2 primeiros bytes
048-004 Código de Segurança do Cartão C13 -
que indicam a presença de CVV conforme
detalhado na página 32.
048-005 Cupom Fiscal O -
VERSÃO 1.2.1
048-006 Taxa Embarque C83 - Valor dependente da transação.
048-007 Saldo Voucher - C84 Saldo dependente da transação.
048-008 KSN C05 -
048-009 Soft Descriptor C85 -
048-010 MPI O - Apenas para transações de e-commerce.
048-011 Nome Fabricante Software TEF M - Fabricante da Solução de TEF
048-013 Versão da biblioteca do PINpad M -
048-014 Versão da aplicação do PINpad M -
Utilizado no processo criptográfico da

048-015 Número de série do PINpad M -
mensagem

048-016 Fabricante do PINpad M -
mensagem

048-017 Modelo do PINpad M -
mensagem
Identificador obtido na Carga de Chaves

048-019 Identificador da Working Key M - e escolhido de acordo com o PinPad em
uso
Bloco criptografado de acordo com a

048-020 Dados Criptográficos M -
seção Criptografia do Cartão
049 Código da Moeda M -

052 Senha do Cartão C05 -
espelhado.
055 Dados EMV C12 C18
062 Via Cupom do Lojista - M
Caso esteja ausente, a via será igual à do

063 Via Cupom do Cliente - O
lojista.
067 Número de Parcelas C15 -
VERSÃO 1.2.1
Caso esteja com o valor 100/110/010,

indica que há uma nova carga de tabelas
ou de chaves (ou ambas) para serem
realizadas. Utilizado para manutenções
pontuais da carga de tabelas. Não
substitui o uso da mensagem de Logon,
que deve continuar sendo enviada
diariamente para verificação de carga.
Tabela 29 - Campos da transação de compra
Confirmação de Compra/Estorno (0202/0402)

BIT IDENTIFICAÇÃO 0X02 0X12 COMENTÁRIOS
003 Código de Processamento C28 ME Valor dependente da transação original.
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
039 Código de Resposta - C29
055 Dados EMV C34 - Dados da 2nd Generate AC.
090 Dados da Transação Original M ME
Tabela 30 - Campos da transação de confirmação de compra/estorno
VERSÃO 1.2.1
Advice Off-line (0220)


002 Número do Cartão M -
espelhado.
003 Código de Processamento M ME Valor dependente da transação.
004 Valor Total M ME
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
038 Código de Autorização C24 -
039 Código de Resposta C25 C29
Código de identificação do operador do

048-003 Código do Operador O -
caixa, se aplicável para o EC.
048-009 SoftDescriptor C85 -
Tabela 31 - Campos da transação de advice off-line
Estorno (0400)

espelhado. * Não utilizado atualmente
VERSÃO 1.2.1
004 Valor Total C28 ME
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
Dado mascarado sensível que nunca

deve ser espelhado.

espelhado.

espelhado.
048-009 Soft Descriptor C85 -

048-015 Número de série do PINpad M -
mensagem

048-016 Fabricante do PINpad M -
mensagem

048-017 Modelo do PINpad M -
mensagem
VERSÃO 1.2.1
Identificador obtido na Carga de Chaves

048-019 Identificador da Working Key M - e escolhido de acordo com o PinPad em
uso
Bloco criptografado de acordo com a

048-020 Dados Criptográficos M -
seção Criptografia do Cartão

lojista.
090 Dados da Transação Original M C86
Tabela 32 - Campos da transação de estorno
VERSÃO 1.2.1
Desfazimento (0420)
Valor dependente da transação a ser

003 Código de Processamento C28 ME
desfeita.
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
039 Código de Resposta - C29
090 Dados da Transação Original M ME
Tabela 33 - Campos da transação de desfazimento
Pré-autorização (0100)
Importante: a transação de pré-autorização ainda não é suportada pelo PagSeguro no
modelo de TEF.

espelhado.
004 Valor Total M C00
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME
VERSÃO 1.2.1

espelhado.

espelhado.


espelhado.
048-008 KSN C05 -
048-010 MPI O - Apenas para transações de e-commerce.

espelhado.

lojista.
Tabela 34 - Campos da transação de pré-autorização
VERSÃO 1.2.1
Captura de Pré-Autorização (0200)
Importante: a transação de pré-autorização ainda não é suportada pelo PagSeguro no

modelo de TEF. Os campos listados nesta seção poderão ser revistos quando o PagSeguro
passar a suportar pré-autorizações.

espelhado.
004 Valor Total M C00
011 NSU do TEF M ME
012 Hora Local M ME
013 Data Local M ME

espelhado.

espelhado.


espelhado.
VERSÃO 1.2.1
048-008 KSN C05 -

espelhado.

lojista.
Tabela 35 - Campos da transação de captura de Pré-autorização
VERSÃO 1.2.1
Comprovantes de Venda
Todo comprovante de venda deve ser formatado pelo Concentrador, inclusive os comprovantes
reduzidos. A automação deverá saber quando imprimir o reduzido ou não, pois existem produtos que não
dispõe de comprovante reduzido.
Para mais detalhes vide documento “Book de Comprovantes PagSeguro”. Este documento será
distribuído apenas para as partes envolvidas no processo.
Códigos de Erros
A tabela abaixo contém a lista com alguns dos possíveis erros no processo de comunicação com o
Autorizador. A mesma deve ser utilizada apenas como referência, pois pode sofrer alterações a qualquer
momento sem necessidade de aviso prévio e/ou liberação de release da Especificação. Para todos os códigos
de erro é necessário o acionamento das áreas solucionadoras, sejam Integradores, Suporte Técnico e/ou
PagSeguro.
CÓDIGO DE ERRO POSSÍVEL CAUSA
M0 Número lógico inválido.
MA Problema de comunicação com o PagSeguro.
M2 Problema com a conta do usuário.
M3 Problema no Estorno da transação.
M4 Problema no Estorno da transação.
M7 Problema com a conta do usuário.
M9 Erro imprevisto.
VERSÃO 1.2.1
Anexo A
Detalhamento do Processo Criptográfico
Passo a Passo do Algorítmo:
1. Para cada Linha da Tabela de Chaves:

1. Abrir a WK com a MK do PinPad
2. Encriptar o valor [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00] no modo 3DES/EDE/ECB
3. Caso o valor seja igual ao Challenge, selecionar a chave para uso
4. Descartar as chaves não utilizadas
Com a Chave identificada, deve-se iniciar o processo criptográfico conforme o passo a passo a seguir:
1. Para formar o IV:

a. Coletar os 8 dígitos mais à esquerda do Número de Série do Terminal e Converter para
formato BCD de modo a obter 16 dígitos.
b. Formar um bloco composto do BIN do cartão (6 dígitos) + Valor da transação alinhado com
0 a esquerda (10 dígitos) de modo a obter 16 dígitos;
c. Realizar XOR entre os blocos a. e b. (IV deve ter 8 bytes no final).
2. O primeiro bloco a ser encriptado será formado por 3 blocos de 8 bytes, formados da seguinte
forma:
a. Gerar um bloco de aleatório de 8 bytes;
b. Coletar 16 dígitos após a sentinela (‘=’) da trilha 2 (alinhar com ‘0’ a direta até completar
16 posições). Converter a String Hexadecimal para um bloco de 8 bytes;
c. Coletar o CVV se preenchido, alinhando com ‘F’ a esquerda até completar 5 posições.
Coletar do cartão os dígitos entre o Bin e o Holder, ou seja: após os primeiros 6 dígitos e
antes dos 4 últimos dígitos antes da sentinela ‘=’;
i. Concatenar o CVV e os dígitos coletados do cartão, completar com ‘0’ a direita até
completar 16 dígitos. Converter a String Hexadecimal para um bloco de 8 bytes;
3. Caso a Trilha 1 tenha sido lida, formar um segundo bloco para ser criptografado, da seguinte
maneira:
a. Converter a Trilha1 para representação BCD;
b. Completar, em bytes, a Trilha1 para que o tamanho seja múltiplo de 8 bytes utilizando
Padding PKCS#5
i. Adicionar 8 - (||M|| mod 8) bytes, todos com valor 8 - (||M|| mod 8).
4. Encriptar os blocos formados no passo 2 e 3 utilizando o IV do passo 1, com algoritmo 3DES/CBC
5. Formar a Trilha 2 Mascarada da seguinte maneira:
a. Substituir os dígitos coletados no passo 2.b por ‘F’;
b. Substituir os dígitos coletados no passo 2.c por ‘0’;
c. Resultado deverá ficar no formato: 4111110000001111=FFFFFFFFFFFFFFFF.
6. Enviar o bloco encriptado no Bit 48-020, e o id da chave utilizada no Bit 48-019. A Trilha 2 deve ser
mascarada (5) e transportada desde o PinPad desta maneira, a Trilha 1 e o CVV não devem ser
transportados fora do bloco encriptado.
VERSÃO 1.2.1
Exemplo do Processo Criptográfico

1. Formar IV com Serial XOR Bin+Holder
a. Serial 15112PP30504686A, 8 primeiros digitos em BCD: 3135313132505033
b. Bin=625012, Valor=R$2,00. Bin+Valor=6250120000000200
c. IV = a XOR b = [0x53, 0x65, 0x23, 0x31, 0x32, 0x50, 0x52, 0x33]
2. Coletar Dados Trilha 2, Cartão e CVV

Trilha 2: 6250129999995253=2512220085130519 e CVV: 123
a. Bloco Randômico: [0x80, 0x77, 0x39, 0x87, 0x48, 0x46, 0x24, 0x36]
b. 16 digitos da Trilha 2, pós sentinela ‘=’: 2512220085130519=
[0x25, 0x12, 0x22, 0x00, 0x85, 0x13, 0x05, 0x19]
c. CVV alinhado com F: FF123, Digitos do cartão: 6250129999995253=…
i. Bloco = FF123999999 =
[0xFF, 0x12, 0x39, 0x99, 0x99, 0x90, 0x00, 0x00]
Bloco criptográfico formado pelos 3 blocos a+b+c:

[0x80, 0x77, 0x39, 0x87, 0x48, 0x46, 0x24, 0x36,
0x25, 0x12, 0x22, 0x00, 0x85, 0x13, 0x05, 0x19,
0xF1, 0x23, 0x99, 0x99, 0x99, 0x00, 0x00, 0x00]
3. Converter e Adicionar Padding a Trilha 1

Trilha 1: B6250129999995253^TEST CARD ISO ^2103101150 45000000000000
a. Trilha 1 em String BCD:
42363235303132393939393939353235335E5445535420434152442049534F205E323130333130313135302
02020203435303030303030303030303030
b. Complementando com PKCS#5 (adicionar N bytes com valor N até o tamanho em bytes ser múltiplo de 8),
neste caso faltam 3 bytes, então adicionar [0x03, 0x03, 0x03]:
42363235303132393939393939353235335E5445535420434152442049534F205E323130333130313135302
02020203435303030303030303030303030030303
4.Encriptar os Blocos (2+3) usando o IV (1)

Dado:
- Master Key: A220A8F794D55EEA8604FE1051B0434F e
- Working Key (encriptada sob a MK):DF8AB98C162AC4EBAA4F383B69B2D537
- Working Key Aberta: 987CC8BF8049E3B3C7EC830483C4239E
Bloco 1: 80773987484624362512220085130519FF12399999900000
Bloco 2:
42363235303132393939393939353235335E5445535420434152442049534F205E323130333130313135302
02020203435303030303030303030303030030303
Resultado do Encrypt 3DES/EDE/CBC do bloco 1+2:
8684FA886D44B0A7557F36251EAC83F997A5D2E5C79A7FEC72F20F8B3747171B3A53655E476DF0145F2D85
B0BF1DDD123A937753100E6851B4A659FCD49A62CE12163795A89FD6BBBBF3D873D811AEDDCFEB892E83
18E076
5. Trilha 2 Mascarada:
6250120000005253=FFFFFFFFFFFFFFFF
VERSÃO 1.2.1

Especificação ISO 8583 PagSeguro

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Especificação ISO 8583 PagSeguro

Caricato da

Copyright:

Formati disponibili

Especificação ISO-8583

Transferência Eletrônica de Fundos (TEF)

13/10/2016 1.0.0 Criação do documento

01/03/2017 1.0.1 Inclusão de observações sobre funcionalidades não suportadas

Inclusão de voucher na Tabela de Produtos, inclusão de campos de terminais

Ajustes na Tabela de Funcionalidades Habilitadas por Produto, ajuste tamanho

Inclusão da seção sobre os Comprovantes, inclusão do tipo de mensagem Echo

Inclusão do Campo Razão Social/Nome Completo e Tipo de Pessoa na TAG 09

Inclusão da Condição C85 para Payments Facilitator no mapa de “Condições

04/10/2017 1.0.7 Ajustes em descrições da data de referência

18/12/2017 1.0.8 Inclusão do Campo Facilitator Merchant ID na TAG 09 do bit 48

21/12/2017 1.0.9 Ajustes para possibilitar o Estorno Parcial

08/02/2018 1.0.9 Detalhamento da solução de Estorno Parcial

Alterações no Soft Descriptor (Bit 48-009) / Alteração do Bit 48-018 Versão

03/09/2018 1.2.0 Inclusão do Processo Criptográfico de Cartão

Ajustes na descrição do processo de Challenge, ajuste no mapa de Bits da carga

12/02/2019 1.2.1 Inclusão da Tag 048-16 no Estorno

28/02/2019 1.21 Inclusão da tabela com os códigos de erros

Dados Adicionais do Autorizador (Bits 62 e 63) ................................................................. 35

Concentrador Conversor Autorizador

Figura 1 – Escopo da Especificação

Comunicação e Fluxos de Transações

Importante: deve ser previsto o tratamento de múltiplas pernas da Carga de Tabelas e

Fluxo de Logon com Tabelas Atualizadas

Figura 2 – Fluxo de Logon para tabelas já atualizadas

Fluxo de Logon com Timeout

Logon 0810: Resposta Perdida

Logon 0810: Resposta OK

Figura 3 – Fluxo de Logon com timeout

Fluxo de Logon com Carga de Tabelas

Logon 0810: [Bit 70] 100

Carga 0800: [Bit 48 – 002] Ausente

Carga 0810: [Bit 48 – 002] 000001

Carga 0810: [Bit 48 – 002] 000002

Carga 0810: [Bit 48 – 001] Versão da Nova Tabela

Figura 4 – Fluxo de Logon com carga de tabelas

Fluxo de Carga de Tabelas com Timeout

Logon 0800: [Bit 48 – 001] Desatualizado

Logon 0810: [Bit 70] 100

Carga 0800: [Bit 48 – 002] Ausente

Carga 0810: [Bit 48 – 002] 000001

Carga 0800: [Bit 48 – 002] 000001

Carga 0810: [Bit 48 – 002] 000002

Carga 0800: [Bit 48 – 002] 000001

Carga 0810: [Bit 48 – 002] 000002

Carga 0800: [Bit 48 – 002] 000020

Carga 0810: [Bit 48 – 001] Versão da Nova Tabela

Figura 5 – Fluxo de Carga de Tabelas com timeout

Solicitação de Compra (0200)

Crédito à vista Pagamento total do valor da compra, com produto crédito.

Pagamento mensal do valor da compra, dividido pelo número de parcelas e acrescido

Pagamento da taxa de embarque para companhias aéreas, juntamente com o valor

Reserva de um valor por um determinado período, utilizado em hotéis, locadoras e

Débito à vista Pagamento total do valor da compra, com produto débito.

Transação de débito realizada com cartão voucher tipo alimentação, refeição,

Fluxo de Solicitação de Compra com Aprovação

Compra 0200: Solicitação

Compra 0210: Resposta Aprovada

Compra 0212: Resposta da Confirmação

Figura 6 – Fluxo de solicitação de compra com aprovação

Fluxo de Solicitação de Compra com Aprovação com Carga de Tabelas

Compra 0210: Resposta Aprovada [Bit 70] 100

Compra 0212: Resposta da Confirmação

Figura 7 – Fluxo de solicitação de compra com aprovação com Carga de Tabelas