Escolar Documentos
Profissional Documentos
Cultura Documentos
Data 19/03/2024
Extrato Eletrônico EDI
O EDI da adquirente PagBank fornece todas as O cliente tem acesso a 3 tipos de extratos, que
informações necessárias para os clientes que podem ser disponibilizados via arquivo posicional ou
possuem grande volume de dados e que tem API, sendo eles:
necessidade de fazer sua conciliação de modo
automatizado.
Transacional
Para isso, em função das especificidades do Financeiro
negócio, os extratos gerados pelo PagBank tem
Antecipação
características próprias, diferentes de outros players,
que viabilizam: Estes extratos entregam toda a informação
necessária para conciliação de vendas, liquidações e
• Conciliação do movimento do Saldo do vendedor
antecipações.
PagBank;
• Transferências realizadas para a Conta Bancária;
*O extrato EDI PagBank segue um mesmo formato padronizado que atende toda a nossa
• Reconciliação financeira e contábil; base de clientes e não pode ser customizado.
CAMPO DESCRIÇÃO
O PagBank adotou um layout pré-definido (em texto Tamanho Indica a quantidade de caracteres e posições que são utilizadas
pela informação
posicional para casos de arquivo), para atender às
especificidades do modelo de negócio PagBank.
Início Identifica a posição inicial da informação no arquivo
*As informações disponibilizadas no extrato EDI são as mesmas para o formato arquivo ou API.
3
Layout
Tipo de dado:
TIPO DESCRIÇÃO
4
Layout
0 Header X X X
1 Detalhe X X X
2 Saldo X
9 Trailer X X X
*As linhas Header, Saldo e Trailer são mandatórias, logo, sempre estarão presentes nos arquivos.
*A linha de Detalhe é condicionada à existência de movimentações do dia para ser apresentada no arquivo.
5
Regime de Recebimentos
Recebimento Múltiplo
Na condição comercial de regime de recebimento múltiplo (conforme parcela), o recebimento é feito de acordo com o
número de parcelas da transação de venda, mês a mês.
No recebimento múltiplo, as parcelas serão liberadas uma a uma, mês a mês, em datas diferentes. É gerada uma
linha do tipo “Detalhe” para cada parcela a receber no arquivo com o preenchimento do campo “pagamento_prazo”
indicando o tipo de recebimento através da constante “M” e no campo “plano” a quantidade de recebíveis para
liquidar a transação.
Exemplo: No caso de uma transação de recebimento múltiplo, parcelada em 3 vezes e realizada no dia 02/12/2022,
temos a saída abaixo padrão no arquivo transacional:
PAGAMENTO_PRAZO PLANO PARCELA QUANTIDADE_PARCELAS DATA_PREVISTA_PAGAMENTO
6
Regime de Recebimentos
Recebimento Único
Na condição comercial de regime de recebimento único, o vendedor recebe a liquidação da transação em uma única
vez, em um prazo definido pela sua condição comercial (por exemplo: 0, 1, 7, 14 ou 30 dias), independentemente do
número do parcelamento realizado na transação. Essa condição é demonstrada nos campos “pagamento_prazo” e
“plano”.
Como o recebimento é único, existe apenas uma “Parcela a ser paga” e uma “Data prevista de pagamento”. É
gerada apenas uma linha do tipo “Detalhe” no arquivo com o preenchimento do campo “pagamento_prazo”,
indicando a condição de recebimento único.
Exemplo: No caso de uma transação de recebimento único, com 14 dias para receber uma venda parcelada em 3
vezes e realizada no dia 02/12/2022, temos a saída abaixo no arquivo transacional:
7
Cálculo do Valor Líquido
[Valor da Parcela] =
[Valor Líquido da Transação] / [Quantidade de parcelas
da transação]
*No caso de dízima no resultado da divisão, é somado R$ 0.01 no valor da 1ª parcela em diante até
que o valor fique balanceado.
8
0 - Header
10 2 Num ESTABELECIMENTO Estabelecimento Número do estabelecimento PagBank. Identificador único do vendedor no PagBank.
*Para os casos de estabelecimentos com matriz e filial que optem por receber a informação dos
estabelecimentos no mesmo arquivo, será preenchido apenas com o número da matriz.
9
9 - Trailer
11 2 Num QUANTIDADE_REGIS TROS Total de registros Número total de registros. Contabilizando somente registros do tipo 1.
518 13 Alfa Uso interno Esse campo será preenchido com informações utilizadas apenas pelo PagBank.
PagBank.
10
Transacional
No extrato Transacional consta toda movimentação à receber, considerando eventos como Vendas, Chargebacks,
Cancelamentos e outros Ajustes à Crédito e à Débito dentro do período especificado no Header, que afetam o Saldo
à Receber do cliente da adquirente PagBank (eventos agendados). A informação apresentada no extrato refere-se
sempre a movimentação do dia anterior (D-1).
*Não constam as informações relativas a vouchers, pois estas são reportadas diretamente pelas empresas contratadas.
*A nomenclatura do arquivo poderá sofrer alterações de acordo com a Van utilizada.
11
Transacional
1- Detalhe
10 2 Num ESTABELECIMENTO Estabelecimento Código do cliente. Identificador único do vendedor no PagBank.
8 12 Num DATA_INICIAL_TRA NSACAO Data inicial Data inicial da transação no PagBank, AAAAMMDD.
da transação
6 20 Num HORA_INICIAL_TRANSACAO Hora inicial Hora inicial da transação no PagBank, HHMMSS.
da transação
8 26 Num DATA_VENDA_AJUSTE Data do evento Data da confirmação da venda ou data do ajuste, AAAAMMDD.
6 34 Num HORA_VENDA_AJUSTE Hora do evento Hora da confirmação da venda ou do ajuste, HHMMSS.
32 46 Alfa CODIGO_TRANSACAO Código Identificação única na adquirente PagBank da transação realizada.
da transação
20 78 Alfa CODIGO_VENDA Código do pedido Código do pedido, preenchido pelo cliente para identificação. Limitado a
20 caracteres somente no EDI formato arquivo txt.
12
Transacional
1- Detalhe
2 125 Alfa PLANO Plano No caso de “Recebimento múltiplo”, será formatado com o número total de
parcelas.
No caso de “Recebimento único”, será formatado com o total de dias para liquidar.
2 127 Alfa PARCELA Parcela Número da parcela que será liberada quando “Recebimento múltiplo” ou constante
“1” quando “Recebimento único”.
2 129 Num QUANTIDADE_PARCELAS Quantidade Quantidade de parcelas da transação:
de parcelas 00 - Débito à vista
da transação 01 - Crédito à vista
02 a 18 - Parcelado.
8 131 Num DATA_PREVISTA_PAGAMENTO Data prevista Data prevista para que o valor fique “Disponível" para o cliente, AAAAMMDD.
de pagamento
13 139 Num TAXA_PARCELA_COMP RADOR Taxa Taxa de parcelamento assumida pelo comprador. (Não entra no cálculo para
de parcelamento descontos do vendedor).
comprador
13
Transacional
1- Detalhe
13 243 Num VALOR_LIQUIDO_TRA NSACAO Valor líquido Valor líquido total da transação.
da transação
2 256 Num STATUS_PAGAMENTO Status Informação para uso interno do PagBank. Não utilizar como parâmetro
do pagamento de conciliação.
*Ver tabela “Status de Pagamento”.
2 258 Alfa Filler Será preenchido com brancos.
14
Transacional
1- Detalhe
6 344 Alfa CARTAO_BIN Cartão Bin 6 primeiros dígitos do Número do Cartão utilizado na transação.
4 350 Alfa CARTAO_HOLDER Cartão Holder 4 últimos dígitos do Número do Cartão utilizado na transação.
15
Transacional
1- Detalhe
32 392 Alfa NUMERO_SERIE_LEITOR Número de série do Número de série associado ao equipamento utilizado na transação. (Preenchido
leitor apenas para meios físicos de pagamento).
35 424 Alfa TX_ID Código TX ID PIX Código único para identificação de transações PIX.
13 459 Num TAXA_EMISSOR Taxa cobrada pelo Valor da taxa de Intermediação cobrada pelo emissor.
Emissor (Apenas para clientes no modelo de precificação do Interchange Plus).
13 472 Num TAXA_ADQUIRENTE Taxa cobrada pela Valor da taxa de Intermediação cobrada pela adquirente PagBank.
Adquirente (Apenas para clientes no modelo de precificação do Interchange Plus).
16
Financeiro
No extrato Financeiro consta toda movimentação de liquidação das transações, considerando eventos como
Pagamentos, Chargebacks, Cancelamentos, Ajustes à Crédito e à Débito, Transferências entre Contas PagBank e
transferências efetuadas para contas em Domicílios Bancários, dentro do período especificado no Header, que
afetam o Saldo Disponível (transações liquidadas) do vendedor PagBank.
Também é apresentada a posição de Saldo inicial e final disponível do vendedor PagBank referente ao dia anterior à
data de processamento. A informação apresentada no extrato refere-se sempre a movimentação do dia anterior
(D-1).
*Não constam as informações relativas a vouchers, pois estas são reportadas diretamente pelas empresas contratadas.
*A nomenclatura do arquivo pode sofrer alterações de acordo com a van utilizada.
17
Financeiro
1- Detalhe
10 2 Num ESTABELECIMENTO Estabelecimento Código do cliente. Identificador único do vendedor no PagBank.
8 12 Num DATA_INICIAL_TRA NSACAO Data inicial Data inicial da transação no PagBank, AAAAMMDD.
da transação
6 20 Num HORA_INICIAL_TRANSACAO Hora inicial Hora inicial da transação no PagBank, HHMMSS.
da transação
8 26 Num DATA_VENDA_AJUSTE Data do evento Data da mudança de status, AAAAMMDD.
18
Financeiro
1- Detalhe
19
Financeiro
1- Detalhe
13 243 Num VALOR_LIQUIDO_TRA NSACAO Valor líquido Valor líquido total da transação.
da transação
20
Financeiro
1- Detalhe
2 286 Num MEIO_PAGAMENTO Meio de pagamento Identifica o meio de pagamento utilizado na transação.
*Ver tabela “Meio de Pagamento”.
30 288 Alfa INSTITUICAO_FINA NCE IRA Instituição Nome da Instituição Financeira ou bandeira relacionada à transação.
financeira/bandeira
2 318 Alfa CANAL_ENTRADA Canal de entrada Canal por onde a transação foi capturada no PagBank.
*Ver tabela “Canal de Entrada”.
2 320 Num LEITOR Leitor Leitor por onde a transação foi capturada no PagBank ou em branco quando for
web.
*Ver tabela “Leitor”.
2 322 Num MEIO_CAPTURA Meio de captura Meio por onde a transação foi capturada no PagBank.
*Ver tabela “Meio de Captura”.
21
Financeiro
1- Detalhe
9 330 Alfa BANCO_AGENCIA Código da agência Código da agência bancária com dígito verificador.
16 339 Alfa CONTA_BANCO Conta Número da conta corrente de pagamento ou número do cartão pré-pago.
de pagamento
32 355 Alfa NUM_LOGICO Número lógico Preenchido somente para meios físicos de pagamento com o número lógico
utilizado no estabelecimento (TEF).
14 387 Alfa NSU NSU Número sequencial único da transação.
6 401 Alfa CARTAO_BIN Cartão BIN 6 primeiros dígitos do Número do Cartão utilizado na transação.
4 407 Alfa CARTAO_HOLDER Cartão Holder 4 últimos dígitos do Número do Cartão utilizado na transação.
32 449 Alfa NUMERO_SERIE_LEITOR Número de série do Número de série associado ao equipamento utilizado na transação (preenchido
leitor apenas para meios físicos de pagamento).
35 481 Alfa TX_ID Código TX ID PIX Código único para identificação de transações PIX.
22
Financeiro
1- Detalhe
23
Financeiro
2- Saldo
10 2 Num ESTABELECIMENTO Estabelecimento Código do cliente. Identificador único do vendedor no PagBank.
24
Antecipação
No extrato de Antecipação consta toda movimentação relativa à liquidação das transações que foram antecipadas
via mesa (antecipação manual). São enviados todos os eventos confirmados de transações antecipadas, quebrados
por parcela antecipada, dentro do período especificado no Header, que afetam o Saldo Disponível do
vendedor PagBank.
A informação apresentada no extrato refere-se sempre a movimentação do dia anterior (D-1).
*Todo o movimento de Antecipação também é apresentado no EDI Financeiro, porém no EDI Financeiro não é detalhado por parcela e sim de forma consolidada.
Exemplo: Um evento com parcelas antecipadas da mesma transação no arquivo FIN será enviada uma linha com o montante do valor antecipado, e no arquivo ANT será enviado o detalhe
por parcela antecipada. *Ver mais em "Informações adicionais".
25
Antecipação
1- Detalhe
10 2 Num ESTABELECIMENTO Estabelecimento Código do cliente. Identificador único do vendedor no PagBank.
8 12 Num DATA_INICIAL_TRA NSACAO Data inicial Data inicial da transação no PagBank, AAAAMMDD.
da transação
6 20 Num HORA_INICIAL_TRANSACAO Hora inicial Hora inicial da transação no PagBank, HHMMSS.
da transação
8 26 Num DATA_VENDA_AJUSTE Data do evento Data da mudança de status, AAAAMMDD.
26
Antecipação
1- Detalhe
13 146 Num VALOR_LIQUIDO_TRANSACAO Valor líquido Valor líquido total da transação (sem taxa de antecipação).
da transação
13 159 Num TAXA_ANTECIPACAO Taxa Taxa cobrada pela antecipação da parcela / recebível.
de antecipação
27
Antecipação
1- Detalhe
6 233 Alfa CARTAO_BIN Cartão BIN 6 primeiros dígitos do Número do Cartão utilizado na transação.
4 239 Alfa CARTAO_HOLDER Cartão Holder 4 últimos dígitos do Número do Cartão utilizado na transação.
28
Tabelas de apoio
29
Tabelas de apoio
31
Tabelas de apoio
02
Transferência entre Contas do 12 Bônus de Campanhas
Vendedor PagBank
13 Pagamento Secundário
03 Adição de Fundos
14 Validadora
04 Transferência para outros Bancos
15 Wallet
05 Cobrança
06 Doação
07 Bônus
08 Repasse de Bônus
09 Operacional
10 Doação Política
32
Tabelas de apoio
Meio de Meio de
Descrição Descrição
Pagamento Pagamento
00
Operação Saldo Vendedor 11 Pix
PagBank
12 Carnê Crédito
01 Débito Online
13 Carnê Débito
02 Boleto
14 Cartão de Crédito Pré-Pago
03 Cartão de Crédito
15 Cartão de Débito Pré-Pago
04 Saldo
16 Carnê Crédito Pré-Pago
07 Depósito em Conta
17 Carnê Débito Pré-Pago
08 Cartão de Débito
09 Débito Automático em Conta
10 Voucher
33
Tabelas de apoio
Status de
Descrição
Pagamento
01 Agendado
02 Pago
03 Disponível
04 Disponível por Antecipação
05 Solicitado
*Informação para uso interno do PagBank. Não utilizar como parâmetro de conciliação.
34
Tabelas de apoio
00
Operação Saldo 12 Moderninha Pro 32 Moderninha Pro 2
Vendedor PagBank
14 D150 33 Moderninha X
01 Leitor de Crédito
15 Moderninha Wifi Plus 34 PagTotem
02 D200
18 TEF - PINPAD 36 Minizinha NFC
03 MINI
21 Minizinha Chip 37 PagPhone
04 Maquininha GPRS
22 Moderninha Plus 44 Moderninha Profit
05 Mobi Pin 10
29 Moderninha Smart 45 Moderninha Plus 2
09 Moderninha Wifi
Moderninha Smart 46 Minizinha Chip 3
10 BTW 30
c/ Câmera
47 Moderninha Smart 2
11 BTW E275 31 Minizinha Chip 2
35
Tabelas de apoio
Leitor Descrição
48 Moderninha Wifi Plus 2
49 Minizinha NFC 2
50 Moderninha Pro 2
51 Moderninha Pro 2
36
Tabelas de apoio
Canal de Canal de
Descrição Descrição
Entrada Entrada
Operação Saldo Vendedor QR QR Code
PagBank
LK Link
W E-Commerce
AP Aplicativo PagBank
N PagBank NFC
TP Tap On Phone
MD Venda Digitada
MT Venda Tarja
MP Venda com Leitor de Chip e Senha
ME Venda pela Moderninha
WT Aplicativo Carteira PagBank
TF TEF
37
Tabelas de apoio
Meio de
Descrição
Captura
01 Chip
02 Tarja
03 Não Presencial
04 TEF
05 QR CODE
38
Informações adicionais
QR CODE
As transações capturadas via o QR Code, podem ser identificadas mediante o Meio de captura = 05 (QR Code).
PIX
As transações de vendas do novo arranjo de pagamento PIX realizadas através das tecnologias do PagBank, podem ser identificadas pelo Meio de pagamento = 11 (Pix),
e demonstradas com o Tipo de transação = 1 (Pagamento) e Tipo evento = 1 (Venda ou pagamento). No campo "instituição_financeira" será reportada a informação
BACEN.
Essas transações terão liquidação em D0, dessa forma os movimentos relacionados ao PIX serão enviados nos arquivos Transacional e Financeiro da mesma data de
movimento.
Não é informado no EDI ou nos sistemas do PagBank: NSU, Código CV, Autorização, BIN e Holder do cartão pois esses dados são exclusivos de venda via cartão.
TRANSAÇÕES DE BOLETO
A transação de boleto somente é registrada e criada na agenda de recebíveis na data em que o boleto for pago pelo comprador e consequentemente estará no
movimento Transacional na respectiva data. A data de geração do boleto é informada no campo “data_inicial_transacao” e a data de confirmação do pagamento do boleto
(data válida usada como referência para exibir no extrato e contar o prazo para liquidação para o vendedor) é informada no campo “data_venda_ajuste”.
No movimento Financeiro irá constar quando foi feita a liquidação, conforme condição comercial.
39
Informações adicionais
Valor original da transação é o valor total sem considerar possíveis acréscimos de taxas ou tarifas que são cobradas do comprador. Em resumo, o valor original é o valor
bruto usado de referência para se descontar taxas e tarifas cobradas do vendedor e chegar ao valor líquido da transação que s erá liquidada para o mesmo.
40
Informações adicionais
A confirmação (evento 15) do pagamento em domicílio bancário ocorre somente em dias úteis.
*Transações PIX, QRCode ou da bandeira Amex não são liquidadas via CIP e o valor é liquidado no saldo disponível do vendedor PagBank.
REGISTRO DE SALDO
É demonstrado no extrato financeiro do EDI PagBank o saldo inicial e final disponível do vendedor PagBank do dia, para um determinado estabelecimento.
• Composição do saldo:
Saldo inicial + liquidações/débitos/créditos – saque de valores (eventos 04, 14 e 17) = Saldo final.
41
Informações adicionais
DISPUTA E CHARGEBACK
Disputa: Reclamação do comprador dentro do PagBank para uma transação web. O pagamento realizado no fluxo web pode ter sido feito via boleto, cartão de crédito,
saldo disponível do vendedor PagBank, débito ou transferência.
Chargeback: Reclamação do comprador no banco emissor do cartão de crédito. O pagamento realizado no fluxo web neste caso é exclusivamente feito via cartão de
crédito e todo trâmite do possível estorno fica sob responsabilidade do banco emissor.
42
Informações adicionais
Evento Valor Bruto Taxa MDR Valor Líquido Evento Valor Bruto Taxa MDR Valor Líquido
43
Informações adicionais
ANTECIPAÇÕES
As transações antecipadas via Mesa de Antecipação PagBank são demonstradas no extrato EDI de Antecipação e também no extrato EDI Financeiro. A diferença entre
as antecipações nos extratos é que no extrato de Antecipação a transação/parcela antecipada é demonstrada de forma analítica, aberta por cada parcela de transação
antecipada na data do movimento, contendo o número da parcela, a data de previsão original e o valor do desconto de taxa por antecipação cobrada para cada
parcela/transação.
Já no extrato Financeiro, a transação antecipada é demonstrada de forma sumarizada, ou seja, em um exemplo onde duas ou mais parcelas de uma mesma transação
foram antecipadas na mesma data, haverá apenas uma linha no tipo “Detalhe” do extrato Financeiro informando a antecipação de ambas as parcelas de forma
sumarizada (campos como “valor_liquido_antecipacao” e “taxa_antecipacao” vão conter a soma dos valores de ambas as parcelas e taxas antecipadas, não
demonstrando o detalhe por parcela).
• Exemplo Extrato Financeiro:
Valor líquido Taxa de
Transação Data de movimento Plano Parcela
antecipado antecipação
44
Informações adicionais
EDI ISO 8583 Comprovante TEF Relatório SITEF Comprovante POS API ORDER Observação
CODIGO_CV BIT 37 CV NSU Host Não Disponível Não Disponível Exclusivo TEF
NSU Não Disponível Não Disponível Não Disponível NSU NSU Gerado pelo PAYWare
45
Informações adicionais
DIVISÃO
DO VALOR
Marketplace Seller
R$ 30,00 R$ 70,00
46
Informações adicionais
DIVISÃO DE PAGAMENTO
A divisão de pagamento é uma configuração onde um valor é debitado (evento 19) após a liquidação de uma transação, e esse valor é creditado em outro cliente que
recebe o valor do repasse (evento 20). Esse valor debitado ocorre para cada transação liquidada, mas não necessariamente no mesmo dia da liquidação.
Processo de liberação
Divisão de pagamento
VAN API
Os arquivos EDI da adquirente PagBank podem ser Os extratos EDI da adquirente PagBank podem ser
enviados para vendedores ou conciliadores através de consultados via API do EDI, mediante um token de
VAN. acesso e é a forma de integração mais recomendada
*Exemplo: PagBank → VAN → Clientes/Conciliadores pelo PagBank.
48
https://pagseguro.uol.com.br/