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)