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
- Descarga el archivo Markdown (botón de abajo).
- Compártelo con tu asistente de IA en la plataforma donde estés desarrollando: adjúntalo al proyecto o pégalo en el chat.
- 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
- Proveer los datos de tu cuenta (token de comercio,
clientslug,plan uid, URL y secreto del callback) y confirmar con Migo la configuración de tu callback. - 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 /transactionspara crear la transacción; en suscripciones lleva el plan encustomKeys.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.
migo-apiLa 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.