¿Cómo generar tu reporte de Liberaciones?
Canales de generación
Puedes generar un reporte de Liberaciones desde tu cuenta de Mercado Pago:
| Canales | Descripción |
| Panel de Mercado Pago | Para generar manualmente un reporte desde tu panel de Mercado Pago, ve a Reportes y elige la opción de Ver reportes creados. Sigue el paso a paso para generar reportes desde el panel. |
| Integración vía API | Para generar manualmente un reporte o programar la frecuencia de uno según tus necesidades, utiliza nuestra integración vía API. 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 tus reportes.
Estructura del reporte
Conoce las características de los elementos que conforman tu reporte.
| Elemento o acción | Caracterí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 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
Considera estas opciones a la hora de descargar tu reporte:
| Elemento o acción | Características |
| Formato del nombre del archivo | Cuando el reporte es programado o manual: "prefijo-configurable-fecha-de-creación.csv" Ejemplo: mitienda-28-05-2019.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. |
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.
| Atributo | Descripción |
| transaction_id | ID de la transacción |
| request_date | Fecha de la solicitud |
| generation_date | Fecha de la generación |
| files | Archivos disponibles |
| type | Formato del archivo |
| url | Enlace de descarga |
| name | Nombre del archivo |
| status | Estado del reporte |
| creation_type | Creación manual o programada |
| report_type | Tipo de reporte |
| is_test | Define si es una prueba |
| signature | Firma 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)