¿Cómo generar tu reporte de Todas las transacciones?
Canales de generación
Existen dos formas de generar un reporte de Todas las transacciones:
Canales | Descripció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.
Elemento | Caracterí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ó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 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ón | Caracterí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.
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)