Gerar relatório - Dinheiro em conta - Mercado Pago Developers

Gerar relatório

Você pode gerar um relatório de Dinheiro em conta 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

Há duas formas de gerar um relatório de Dinheiro em conta:

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 gerar, programar e configurar seus relatórios.

Programação do relatório

Programe como e com que frequência você quer gerar seus relatórios.

ElementoCaracterísticas
Programação
- Diária
- Semanal
- Mensal

Criação
- Manual
- Automática

Estrutura do relatório

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

Elemento ou açãoCaracterísticas
Detalhes das tabelas
Os detalhes das tabelas compreendem as informações de, no mínimo, 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-3 (Horário de Brasília)

Tome como referência o lugar de onde o relatório é baixado.

Seleção de datas via API
Formato do fuso horário: UTC / GMT-0

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 componentesCaracterísticas
Formato do nome do arquivo
Quando o relatório é programado ou manual:
"<prefixo-configurável>-<yyyy-MM-dd-hhmmss>.<formato>"
Exemplo: minhaloja-2019-05-28-104010.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.

Configuração disponível via API
- Colunas a gerar por relatório
- Prefixo do arquivo para identificá-lo facilmente
- Envio por SFTP
- Separador de colunas (ponto ou ponto e vírgula)
- Notificação por e-mail

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 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

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)

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