Saltar al contenido principal
Migo Docs

Guía para agentes de IA

Una guía autocontenida que le entregas al asistente de IA de tu equipo para que integre los pagos de Migo —pago único y suscripciones— vía el webview hospedado. Está escrita en inglés y en un formato determinista pensado para que un modelo la ejecute paso a paso sin ambigüedad.

Cómo usarla​

  1. Descarga el archivo Markdown (botón de abajo).
  2. Compártelo con tu asistente de IA en la plataforma donde estés desarrollando: adjúntalo al proyecto o pégalo en el chat.
  3. Inicia la conversación con este prompt:
Integra los pagos de Migo en este proyecto siguiendo el archivo migo-subscriptions-agent-guide.md
(tu única fuente de verdad). Trabaja en sandbox, paso a paso, y detente a pedirme los datos que la
guía marque como inputs. Empieza estableciendo el contexto: entorno, si es desde cero o app existente,
y si integramos pago único, suscripciones o ambos.

Para quién es​

Para el agente de IA que construye la integración, no para una persona. Tú le entregas la guía y los datos de tu cuenta; la guía le indica al agente qué verificar antes de avanzar de paso.

Intervención humana requerida​

  1. Proveer los datos de tu cuenta (token de comercio, client slug, plan uid, URL y secreto del callback) y confirmar con Migo la configuración de tu callback.
  2. Completar un pago de prueba en el checkout de sandbox una vez, para la validación end-to-end.

El resto de los pasos los ejecuta el agente.

Qué incluye​

  • Instrucciones de operación para el agente (trabajar por pasos, verificar antes de avanzar).
  • POST /transactions para crear la transacción; en suscripciones lleva el plan en customKeys.plan.uid (el pago único lo omite).
  • Handler del callback (subsCallback) idempotente, con payloads de replay para autoprueba sin esperar webhooks reales.
  • Compuertas de verificación por paso, mapa de errores y checklist de aceptación.
  • Datos de sandbox y sección de go-live a producción.
El contrato de suscripción está verificado contra migo-api

La creación por customKeys.plan.uid, el monto del primer cobro y el mecanismo de callback fueron confirmados en el código. El payload exacto y el header de autenticación del callback son configuración por comercio que acuerdas con Migo — la guía lo explica en detalle.

Relacionado​