Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

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

Busca inteligente powered by OpenAI 

Gerar relatório

Você pode gerar um relatório de Liberações através da sua conta Mercado Pago ou por meio da integração via API. Veja a tabela a seguir para obter mais informações.

Canais de criação

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

CanaisDescrição
Painel do Mercado PagoÉ possível criar o relatório manualmente através do painel Mercado Pago. Acesse a seção de Relatórios e faturamento, clique em Ir para Relatórios de pagamentos e extratos de conta e selecione o relatório. Para mais informações, leia a documentação Gerar relatório pelo painel.
Integração via APICrie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte a documentação Gerar relatório via API.

Características técnicas do relatório

Considere as seguintes informações técnicas sempre que for criar, programar ou configurar um relatório.

Estrutura do relatório

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

Ações e componentesCaracterísticas
Detalhes das tabelasOs detalhes das tabelas compreendem as informações de no mínimo 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 webCom base no 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 arquivoRelatório programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2024.csv.
Formatos de download.csv, .xlsx

Nota: 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 em tabelas de planilha.
ArquivoOs relatórios gerados são salvos na sua conta do Mercado Pago.

Notificações

Webhook

Webhook, também chamado de "retorno de chamada web", é um método eficiente para receber informações em tempo real sempre que um evento ocorre em um aplicativo ou sistema. Essa abordagem permite a transferência passiva de dados entre dois sistemas por meio de solicitações HTTP POST. Em relação aos relatórios utilizados na reconciliação, uma notificação é enviada ao usuário que tiver configurado este serviço assim que os arquivos correspondentes forem gerados.

AtributoDescrição
transaction_idID da transação
request_dateData da solicitação
generation_dateData da criaçã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

A senha de criptografia é essencial para assegurar o processo de notificação ao sistema. No corpo da mensagem (payload), um atributo chamado "signature" é enviado para validar a origem legítima da notificação Webhook do Mercado Pago, evitando possíveis imitações.

A criação da signature ocorre pela combinação do transaction_id com a senha criptografada na seção "Notificação por Webhook", juntamente com o generation_date do relatório. Esses valores são então criptografados utilizando o algoritmo BCrypt da seguinte forma:

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

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

Exemplo em Java:

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

Tenha o Glossário do relatório de Liberações à mão para consulta sempre que necessário ou para conferir algum termo técnico.