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 - Dinheiro em conta - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

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.

Atenção
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. O relatório somente irá gerar informações após a configuração do relatório ter sido feita e este seja executado a primeira vez. Desse modo, a primeira execução terá um relatório vazio. Não é possível gerar o relatório com informações retroativas à data da configuração e primeira execução.

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.