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)