Generar reporte
Puedes generar un reporte de Liquidaciones 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.
Canales de generación
Puedes generar un reporte de Liquidaciones a través de tu cuenta de Mercado Pago:
| Canales | Descripción |
| Panel de Mercado Pago | Es 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 API | Crea 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ón | Características |
| Detalles de las tablas | El detalle de las tablas comprende información generada en día 1 como mínimo. |
| Orden de las columnas | Fija |
| Período máximo | Reportes con datos de hasta 60 días. |
| Moneda | Local (según 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 | Segú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ón | Características |
| Formato del nombre del archivo | Reporte 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. |
| Archivo | Los 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.
| Atributo | Descripción |
transaction_id | ID de la transacción |
request_date | Fecha de la solicitud |
generation_date | Fecha de creació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 | Determina si es una prueba |
signature | Firma 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)