Inicio
Documentación
Recursos
Certificaciones
Comunidad
Generar reporte - Liberaciones - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos

Generar reporte

Puedes generar un reporte de Liberaciones a través de tu cuenta de Mercado Pago o mediante la integración a través de la API. Consulta la tabla a continuación para obtener más información.

Importante
Los reportes que generes a partir de junio presentarán tus movimientos en orden cronológico, para que sea más fácil identificar cuándo se realizaron. Conoce cómo usar este reporte.

Canales de generación

Puedes generar un reporte de Liberaciones a través de tu cuenta de Mercado Pago:

CanalesDescripción
Panel de Mercado PagoEs posible crear el reporte manualmente a través del panel de Mercado Pago. Accede a la sección de Informes y facturación, haz clic en Ir a reportes de pagos y extractos de cuenta y selecciona el reporte. Para obtener más información, consulta la documentación Generar reporte desde el panel.
Integración vía APICrea el reporte manualmente o programa su generación según la frecuencia deseada utilizando nuestra integración a través de la API. Para obtener más información, consulta la documentación Generar reporte a través de la API.

Características técnicas del reporte

Ten en cuenta la siguiente información técnica siempre que estés creando, programando o configurando un reporte.

Estructura del reporte

Comprende las características de los elementos que componen tu reporte.

Elemento o acciónCaracterísticas
Detalles de las tablasEl detalle de las tablas comprende información generada en día 1 como mínimo.
Orden de las columnasFija
Período máximoReportes con datos de hasta 60 días.
MonedaLocal (según el país donde esté registrada la cuenta de Mercado Pago).
Zona horaria de las columnas con fechasGMT-4

Toma como referencia el lugar desde el que se descarga el reporte.
Selección de fechas vía webSegún 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 disponibles al descargar tu reporte.

Elemento o acciónCaracterísticas
Formato del nombre del archivoReporte programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2024.csv.
Formatos de descarga.csv, .xlsx

Nota: descarga el reporte en formato .csv para importar los datos y usarlos en otras aplicaciones. Descárgalo en formato .xlsx para leer la información en tablas de hojas de cálculo.
ArchivoLos reportes generados se guardan en tu cuenta de Mercado Pago.

Notificaciones

Webhook

Webhook, también conocido como "retorno de llamada web", es un método eficiente para recibir información en tiempo real cada vez que ocurre un evento en una aplicación o sistema. Este enfoque permite la transferencia pasiva de datos entre dos sistemas mediante solicitudes HTTP POST. En relación con los reportes utilizados en la conciliación, se envía una notificación al usuario que haya configurado este servicio cuando sus archivos sean generados.

AtributoDescripción
transaction_idID de la transacción
request_dateFecha de la solicitud
generation_dateFecha de creació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_testDetermina si es una prueba
signatureFirma digital de la notificación

Contraseña para cifrado

La contraseña de cifrado es esencial para asegurar el proceso de notificación al sistema. En el cuerpo del mensaje (payload), se envía un atributo llamado "signature" para validar la origen legítima de la notificación Webhook de Mercado Pago, evitando posibles imitaciones.

La creación de la signature ocurre mediante la combinación del transaction_id con la contraseña para cifrado en la sección "Notificación por Webhook", junto con la generation_date del reporte. Estos valores se cifran utilizando el 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, es necesario utilizar la función de verificación ofrecida por el algoritmo de BCrypt para el lenguaje deseado.

Ejemplo en Java:

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

Ten a mano el Glosario del Reporte de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico.