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:
| Canais | Descriçã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 API | Crie 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.
| Elemento | Caracterí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ção | Caracterí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 componentes | Caracterí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.
| 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
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)