Casos de uso

El comando /mp-integrate es el punto de entrada principal del plugin para realizar una integración con agentes de IA. A través de una interacción conversacional, se detecta automáticamente el producto y el país mencionados en tu mensaje y se genera el código de integración necesario, sin que tengas que buscar documentación.

Es posible crear flujos de integración para los siete países en los que opera Mercado Pago (Argentina, Brasil, México, Chile, Colombia, Perú y Uruguay) y para los principales productos integrables, como Checkout API, Checkout Pro, Código QR y Mercado Pago Point.

Para comenzar, ejecuta el comando seguido de una descripción de lo que necesitas integrar. Cuanto más contexto incluyas, más específico será el código que recibas. Algunos ejemplos:

plain
/mp-integrate quiero integrar Checkout Pro en Brasil

plain
/mp-integrate necesito cobrar con QR Code en Brasil para mi app de retail

plain
/mp-integrate cómo agrego suscripciones mensuales para mis usuarios en México

Al finalizar la ejecución, el plugin entrega:

• Código de integración: implementación adaptada al lenguaje o framework que indicaste en el comando. Es posible pedir versiones en otros lenguajes en la misma sesión.
• Snippets de configuración: inicialización del SDK o estructura de llamadas a la API para el producto seleccionado.
• Ejemplos de payloads: cuerpos de solicitud con los parámetros relevantes para el producto y el país.
• Orientación sobre parámetros: indicación de qué campos son obligatorios u opcionales y ejemplos de valores.

El /mp-integrate funciona en dos modos distintos según el estado de autenticación de tu sesión:

El comando /mp-webhooks permite configurar, simular y diagnosticar las notificaciones de Webhook de Mercado Pago dentro de la sesión con el agente de IA. Para usarlo, es necesario autenticarte a través de /mp-connect.

Es posible ejecutar los siguientes subcomandos:

• /mp-webhooks configure: registra la URL HTTPS de tu endpoint y los tópicos de eventos que deseas recibir, como order, topic_claims_integration_wh o topic_chargebacks_wh.
• /mp-webhooks simulate: envía una notificación de prueba al endpoint configurado para validar que la firma HMAC-SHA256 se está procesando correctamente.
• /mp-webhooks status: verifica el estado del registro e identifica problemas de URL o tópico.
• /mp-webhooks diagnose: diagnostica fallas de firma y entrega de las notificaciones.

El plugin cubre las dos etapas para preparar tu entorno de pruebas: obtener tarjetas de prueba con /mp-test-cards y crear usuarios con saldo con /mp-test-setup.

Comienza ejecutando /mp-test-cards para obtener las tarjetas de prueba disponibles para tu país. Este comando no requiere autenticación.

plain
/mp-test-cards

En el formulario de pago de prueba, el nombre del titular determina el resultado de la simulación, por eso sigue el patrón de APRO (aprobado), FUND (saldo insuficiente), CONT (pendiente), SECU (CVV inválido) y EXPI (tarjeta vencida). En el campo de CC , usa el número de documento 12345678.

Después de configurar tus tarjetas de prueba, ejecuta el comando /mp-test-setup para crear un usuario vendedor y un comprador con credenciales de prueba y saldo disponible. Este comando solo funciona después de autenticarte vía OAuth (/mp-connect).

plain
/mp-test-setup

El resultado esperado es tener tus usuarios disponibles para iniciar las pruebas.

El comando /mp-review analiza el código de tu integración a partir de un checklist de calidad y un estándar mínimo de seguridad de 9 criterios de Mercado Pago para generar un reporte de implementación con acciones sugeridas para mejorar tu desarrollo. Este comando requiere una sesión activa, por eso ejecuta /mp-connect antes de usarlo.

El reporte de implementación se organiza en 5 secciones:

1. Verificado: ítems del checklist ya implementados correctamente.
2. Necesita atención: implementaciones parciales que necesitan ajustes.
3. Bloqueadores: fallas críticas que impiden pasar a producción.
4. Próximos pasos: mejoras opcionales para elevar la calidad de tu integración.
5. Puntuación y veredicto: resultado final si aprobado, aprobado con observaciones o bloqueado.

El /mp-review también detecta Access TokensClave privada de la aplicación, utilizada en el backend para autenticar las llamadas a la API de Mercado Pago. Puedes acceder a ella en Tus integraciones > Detalles de la aplicación > Credenciales. expuestos en el código fuente e identifica llamadas directas al endpoint /v1/payments que pueden beneficiarse de la migración a la API de Orders.

El /mp-integrate migrate escanea el proyecto, identifica patrones de la API de Intención de Pago (legacy) de Mercado Pago Point y/o Código QR y genera el archivo migration-proposal.md con el detalle completo de los cambios y las instrucciones de migración a la API de Orders.

El archivo de propuesta de migración cubre los principales puntos de adecuación a la API de Orders, como:

• Campos de state a status;
• Tópicos de notificación de merchant_order y point_integration_wh a orders;
• Campo external_reference con guiones;
• Eliminación del header X-Allow-Cancelable-Status;
• Inclusión de MP_WEBHOOK_SECRET en el .env.example.

Después de revisar y aplicar los cambios propuestos, ejecuta /mp-review para validar que la integración migrada cumple con el checklist de calidad antes de subir a producción.