Gerar relatório - Liberações - Mercado Pago Developers

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

Gerencie suas vendas com código QR de um jeito fácil
Criamos novas colunas que permitem que você identifique as carteiras digitais ou os bancos que seus clientes utilizam ao pagarem com um código QR do Mercado Pago. Atualize suas preferências de configuração no painel ou via API para incluir as colunas nos seus relatórios.

Canais de geração

Você pode gerar um relatório de Liquidaçõ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 Liquidações para consultá-lo quando precisar ou queira conferir algum termo técnico.