Manual de Configuración

Bot de WhatsApp con Mercado Pago QR - Integración con MikroWisp

Pasos de Configuración

Paso 1: Acceder a Mercado Pago

Panel principal de Mercado Pago
  1. Ve a https://www.mercadopago.com.ar/
  2. Inicia sesión con tu cuenta de Mercado Pago
  3. Una vez logueado, accederás al panel principal donde podrás navegar a las diferentes secciones

Paso 2: Configurar Locales y Cajas

Verificar Locales Existentes

Sección de locales y cajas en Mercado Pago

Navega a la sección Locales desde el menú lateral para verificar si ya tienes locales configurados.

IMPORTANTE: Si ya tienes locales configurados, NO hagas nada y pasa directamente al Paso 3. Solo crea un local si no tienes ninguno configurado previamente.

Crear Nuevo Local (Solo si es necesario)

Formulario para crear nuevo local en Mercado Pago

Únicamente si necesitas crear un local:

  1. Haz clic en Agregar local
  2. Completa la información requerida del negocio:
    • Nombre del local: Nombre identificatorio de tu sucursal
    • Dirección completa: Dirección física donde opera el negocio
    • Información adicional: Completa todos los campos solicitados en el formulario
  3. Confirma la ubicación en el mapa si es requerido
  4. Guarda la configuración del local

Paso 3: Crear Aplicación para Códigos QR

Acceder a Integraciones

Acceder a la sección Integraciones en Mercado Pago
  1. En el menú lateral de Mercado Pago, localiza y haz clic en Integraciones
  2. Esto te dirigirá al panel de desarrolladores donde podrás gestionar aplicaciones

Verificación de Identidad

Verificación de identidad por SMS, WhatsApp o llamada

El sistema requerirá verificar tu identidad para activar las credenciales de producción:

  1. Selecciona tu método de verificación preferido:
    • SMS al teléfono registrado
    • WhatsApp al número asociado
    • Llamada telefónica
  2. Ingresa el código de verificación que recibas
  3. Confirma la verificación para continuar

Configurar Nueva Aplicación

Crear nueva aplicación de códigos QR

Haz clic en Crear aplicación

Completar los datos de crear aplicación

Completar información empresarial y datos del negocio
  1. Configura las opciones específicas para códigos QR:
    • Tipo de solución: Pagos presenciales
    • Producto seleccionado: Código QR
    • Modelo de integración: Dinámico
  2. Completa el nombre de la aplicación con algo descriptivo
IMPORTANTE: Es crucial seleccionar exactamente Pagos presenciales y Código QR para que la integración funcione correctamente con el bot.
VERIFICACIÓN: Asegúrate de que la configuración muestre Pagos presenciales y Código QR antes de continuar.

Activación de Credenciales

Activar credenciales de producción en Mercado Pago

Proporciona la información empresarial solicitada:

  • Categoría de industria: Selecciona la categoría que mejor describa tu negocio
  • Sitio web: URL de tu sitio web corporativo (opcional)
  • Información adicional: Cualquier otro dato requerido por el formulario
  • Acepta los términos y condiciones correspondientes

Una vez completada toda la información requerida:

  1. Haz clic en Activar credenciales de producción
  2. Espera a que el sistema procese y active las credenciales
  3. Verifica que la activación sea exitosa

Obtener Access Token

Copiar Access Token de las credenciales de producción
CRÍTICO: Este es el paso más importante. Copia y guarda de forma segura el Access Token que se muestra.
Ejemplo de Access Token:
APP_USR-1234567890123456-098765-a1b2c3d4e5f6g7h8i9j0-987654321
  1. Localiza el campo Access Token en las credenciales
  2. Copia completamente el token (suele ser una cadena muy larga)
  3. Este token debe ser pegado exactamente en el campo Access Token de la configuración del bot
  4. El sistema del bot extraerá automáticamente el User ID y generará la URL de webhook

Paso 4: Configurar Bot y Obtener URL Webhook

Ir a bot, configurar mercado pago pegas acces token y copiar url webhook de boton copiar y guardar configuracion

Configuración en el Panel del Bot:

  1. Accede al panel de administración de tu bot de WhatsApp
  2. Navega a la sección Ajustes → Plataformas de Pago
  3. En el formulario de Mercado Pago:
    • Access Token: Pega el token que copiaste de Mercado Pago
    • User ID: Se completará automáticamente (no modificar)
    • URL de Webhook: Aparecerá automáticamente generada
  4. En el campo de URL de Webhook, haz clic en el botón Copiar
  5. Guarda esta URL temporalmente (la necesitarás para el paso siguiente)
  6. Haz clic en Guardar Configuración para aplicar los cambios
Ejemplo de URL generada:
https://southamerica-east1-mkw-bot.cloudfunctions.net/payment-webhook?tenantId=MI_EMPRESA_BOT

Paso 5: Configurar Webhooks en Mercado Pago

Acceder a Configuración de Webhooks

Acceder a configuración de webhooks en Integraciones
  1. Regresa al panel de Mercado Pago
  2. Ve nuevamente a Integraciones → Webhooks
  3. Haz clic en Configurar notificaciones

Configurar Modo Productivo

Configurar modo productivo y pegar URL de webhook
  1. Asegúrate de estar en la pestaña Modo productivo (no en modo de prueba)
  2. En el campo URL de producción, pega la URL que copiaste del bot en el paso anterior
  3. Configura los eventos de notificación:
    • Pagos (OBLIGATORIO - sin esto no funcionará)
    • Order (Mercado Pago) (recomendado)
    • Vinculación de aplicaciones (recomendado)
    • Otros eventos según tus necesidades
VERIFICACIÓN IMPORTANTE: Asegúrate de que la URL pegada coincida exactamente con la copiada del bot, incluyendo el parámetro tenantId correcto.

Finalizar Configuración

Guardar configuración de webhooks en Mercado Pago
  1. Revisa que toda la configuración esté correcta
  2. Haz clic en Guardar configuración
  3. Si aparece un modal de confirmación, confírmalo
  4. Verifica que aparezca un mensaje de éxito

🎉 ¡Configuración Completada Exitosamente!

Tu bot de WhatsApp ahora está completamente integrado con Mercado Pago QR y MikroWisp

Funcionalidades Activadas:

  • Generación automática de códigos QR desde la sección "Ver facturas/Pagar" del bot
  • Recepción automática de confirmaciones de pago a través de webhooks
  • Integración directa con MikroWisp para registro automático de pagos
  • Procesamiento en tiempo real de todas las transacciones

Lista de Verificación Final:

  • Cuenta de Mercado Pago verificada y activa
  • Local configurado en Mercado Pago (si era necesario)
  • Aplicación de Código QR creada y activada
  • Access Token copiado y configurado en el bot
  • User ID extraído automáticamente
  • URL de webhook generada automáticamente
  • Webhooks configurados en modo productivo
  • Evento "Pagos" activado en las notificaciones
  • Configuración guardada en ambos sistemas
Prueba de Funcionamiento:
  1. Accede a tu bot de WhatsApp
  2. Solicita un código QR para una factura pendiente
  3. Realiza un pago de prueba con un monto pequeño ($50-$100)
  4. Verifica que el pago se registre automáticamente en MikroWisp
  5. Confirma que la factura se marque como pagada
Soporte Técnico:
Si experimentas algún problema durante las pruebas, verifica que todos los pasos se hayan completado en el orden exacto especificado y que las URLs configuradas en ambos sistemas coincidan perfectamente.