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:
Canais | Descrição |
Painel do Mercado Pago | Para 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 API | Para 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 componentes | Características |
Detalhes das tablas | Os detalhes das tabelas compreende as informações no mínimo de 1 dia. |
Ordem das colunas | Fixa |
Período máximo | Relatórios com dados de até 60 dias. |
Moeda | Local (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 web | Deve 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 componentes | Características |
Formato do nome do arquivo | Quando 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. |
Arquivo | Os 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.
Atributo | Descrição |
transaction_id | ID da transação |
request_date | Data da solicitação |
generation_date | Data da geração |
files | Arquivos disponíveis |
type | Formato do arquivo |
url | Link de download |
name | Nome do arquivo |
status | Status do relatório |
creation_type | Criação manual ou agendada |
report_type | Tipo de relatório |
is_test | Determina se é um teste |
signature | Assinatura 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)