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.
Canales de generaciĂłn
Puedes generar un reporte de Liberaciones 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)