Gerar relatório - Liberações - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Como gerar o seu relatório de Liberações?

Canais de geração

Você pode gerar um relatório de Liberações pela sua conta Mercado Pago:

CanaisDescrição
Painel do Mercado PagoPara gerar um relatório manualmente pelo Mercado Pago, vá até a seção Relatórios e faturamento clique em "Ir para Relatórios de pagamentos e extratos de conta" e escolha o relatório que desejar.

Siga o passo a passo para gerar seus relatórios a partir do painel.
Integração via APIPara gerar manualmente o report ou agendar um de acordo com a frequência desejada, use a nossa integração via API.

Leia a documentação para gerar relatórios por API.

Características técnicas do relatório

Considere as seguintes informações técnicas sempre que for gerar, programar e configurar seus relatórios.

Estrutura do relatório

Saiba as características dos elementos que compõem seu relatório.

Ações e componentesCaracterísticas
Detalhes das tablasOs detalhes das tabelas compreende as informações no mínimo de 1 dia.
Ordem das colunasFixa
Período máximoRelatórios com dados de até 60 dias.
MoedaLocal (com base no país onde está cadastrada a conta do Mercado Pago)
Fuso horário das colunas:GMT-4

Tome como referência o lugar de onde o relatório é baixado.
Seleção de datas via webDeve ter como base o fuso horário da conta do usuário.
Por exemplo, a conta do usuário cadastrada no Brasil corresponde ao fuso horário de São Paulo.

Exportação do relatório

Todas as opções disponíveis na hora de baixar seu relatório.

Ações e componentesCaracterísticas
Formato do nome do arquivoQuando o relatório é programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2019.csv
Formatos de download.csv, .xlsx

Dica: baixe o relatório em .csv para importar os dados e usá-los em outros aplicativos. Baixe-o em .xlsx para ler as informações nas tabelas da planilha.
ArquivoOs relatórios gerados ficam salvos na sua conta do Mercado Pago.

Notificações

Webhook

Webhook (também conhecido como "retorno de chamada web"), é um método simples que permite que um aplicativo ou sistema forneça informações em tempo real toda vez que um evento acontece, ou seja, é uma maneira de receber dados entre dois sistemas de forma passiva, por meio de um HTTP POST. No caso dos relatórios usados na reconciliação, uma notificação é enviada ao usuário que tiver configurado este serviço quando seus arquivos forem gerados.

AtributoDescrição
transaction_idID da transação
request_dateData da solicitação
generation_dateData da geração
filesArquivos disponíveis
typeFormato do arquivo
urlLink de download
nameNome do arquivo
statusStatus do relatório
creation_typeCriação manual ou agendada
report_typeTipo de relatório
is_testDetermina se é um teste
signatureAssinatura digital da notificação

Senha para criptografia

Para garantir o processo de notificação ao sistema, será enviado no corpo da mensagem (payload) um atributo chamado "signature" para validar que a notificação Webhook teve origem no Mercado Pago e que não se trata de uma imitação.

A signature é criada ao unir o transaction_id com a senha criptografada na seção "Notificação por Webhook" e o generation_date do relatório. Assim que os valores forem vinculados, eles são criptografados usando o algoritmo BCrypt da seguinte maneira:

signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)

Para validar que foi o Mercado Pago quem emitiu a notificação, é necessário usar a função de verificação oferecida pelo algoritmo do BCrypt para a linguagem desejada.

Exemplo Java:

BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)

Tenha em mãos o Glossário do relatório de Liberações para consultá-lo quando precisar ou queira conferir algum termo técnico.