Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

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

Busca inteligente powered by OpenAI 

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.