Generar reporte - Todas las transacciones - Mercado Pago Developers

¿Cómo generar tu reporte de Todas las transacciones?

Lleva con facilidad el control de tus ventas con QR
Creamos nuevas columnas que te permiten identificar las billeteras virtuales o los bancos que tus clientes usan para pagar cuando les cobras con un QR de Mercado Pago. Actualiza tus preferencias de configuración desde el panel o vía API para incluir las columnas en tus reportes.

Canales de generación

Existen dos formas de generar un reporte de Todas las transacciones:

CanalesDescripción
Panel de Mercado Pago
Reportes de tus cobros y estados de cuenta. Es muy simple y rápido. Para generarlo desde tu cuenta de Mercado Pago, ve a tus informes y elige la opción de Reportes.

Sigue el paso a paso para generar reportes desde el panel.

Integración vía API
Programa la frecuencia de tu reporte según tus necesidades. Puede ser tanto de forma manual como de forma programada.

Lee la documentación para generar reportes por API.

Características técnicas del reporte

Ten en cuenta la siguiente información técnica cuando quieras generar, programar y configurar tus reportes.

Programación del reporte

Programa cómo y con qué frecuencia quieres generar tus reportes.

ElementoCaracterísticas
Programacion
- Diaria
- Semanal
- Mensual

Generación
- Manual

Estructura del reporte

Conoce las características de los elementos que conforman tu reporte.

Elemento o acciónCaracterísticas
Detalle de tablas
El detalle de las tablas comprende información generada en día 1 como mínimo.

Orden de columnas
Fijo

Período máximo
Reportes con datos de hasta 60 días.

Moneda
Local (basada en el país donde esté registrada la cuenta de Mercado Pago)

Zona horaria de las columnas con fechas
GMT-4

Toma como referencia el lugar desde el que se descarga el reporte.

Selección de fechas vía API
Formato del timezone: UTC / GMT-0

Selección de fechas vía web
Debe basarse en el timezone de la cuenta.
Por ejemplo, a la cuenta registrada en Brasil le corresponde el timezone de São Paulo.

Exportación del reporte

Todas las opciones que tienes disponible a la hora de descargar tu reporte.

Elemento o acciónCaracterísticas
Formato del nombre del archivo
Cuando el reporte es programado o manual:
"<prefijo-configurable>-<yyyy-MM-dd-hhmmss>.<formato>"
Ejemplo: mitienda-2019-05-28-104010.csv

Formatos de descarga
.csv, .xlsx

Tip: descarga el reporte en .csv para importar los datos y usarlos en otras aplicaciones. Descárgalo en .xlsx para leer la información en las tablas de la hoja de cálculo.

Archivo
Los reportes generados quedan guardados en tu cuenta de Mercado Pago.

Configuración disponible vía API
- Columnas a generar por reporte
- Prefijo del archivo para identificarlo fácilmente
- Carga por SFTP
- Separador de columnas (punto o punto y coma)
- Notificación por e-mail

Notificaciones

Webhook

Webhook (también conocido como devolución de llamada web) es un método simple que facilita que una aplicación o sistema proporcione información en tiempo real cada vez que ocurre un evento, es decir, es una forma de recibir datos pasivamente entre dos sistemas a través de un HTTP POST. Para el caso de los reportes que se utilizan para conciliar se enviará una notificación al usuario que tenga configurado este servicio cuando sus archivos sean generados.

AtributoDescripción
transaction_idID de la transacción
request_dateFecha de la solicitud
generation_dateFecha de la generación
filesArchivos disponibles
typeFormato del archivo
urlEnlace de descarga
nameNombre del archivo
statusEstado del reporte
creation_typeCreación manual o programada
report_typeTipo de reporte
is_testDefine si es una prueba
signatureFirma de la notificación

Contraseña para cifrado

Para hacer seguro el proceso de notificación hacia el sistema se enviará en el cuerpo del mensaje (payload) un atributo llamado Signature, con el objetivo de validar que la notificación Webhook se haya originado desde Mercado Pago y no se trate de una suplantación.

El Signature se construye uniendo el transaction_id con la contraseña para cifrado configurada en la sección de Notificación por Webhook, más el generation_date del reporte. Una vez concatenados los valores se cifran haciendo uso del algoritmo BCrypt de la siguiente manera:

signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)

Para validar que sea Mercado Pago quien emitió la notificación se debe usar la función de verificación que ofrece el algoritmo de BCrypt para el lenguaje deseado.

Ejemplo Java:

BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)

Ten a mano el Glosario del reporte de Todas las transacciones para revisarlo cuando necesites o quieras consultar algún término técnico.