Generar reporte
Puedes generar un reporte de Todas las transacciones 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
Existen dos formas de generar un reporte de Todas las transacciones:
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 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 - AutomĂĄtica |
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
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)