Recetas de integración
Recetas copia-y-pega por país para aceptar todos los rails de pago que Migo expone. Cada receta es autocontenida — prerrequisitos, curl exacto, respuesta esperada, payload del webhook, datos de sandbox, errores comunes y un checklist final — para que un integrador (o un agente como Claude Code) pueda terminar la integración sin salir de la página.
Matriz país × rail
La tabla de abajo cubre los rails de pago alternativo que tienen una receta por país y que retornan un payload en el endpoint /api/v1/integrations/.../payments. No es una lista exhaustiva de procesadores — existen llaves de procesador adicionales (por ejemplo, zigiQR, bbvaQR, push-payment-gateway) para clientes específicos y se resuelven en runtime desde el clientConfig.processors de cada comercio. Haz click en un país para abrir su receta completa.
| País | Wallets / push | Transferencia bancaria | QR | Botón hosteado | Efectivo |
|---|---|---|---|---|---|
| Guatemala | zigi | — | akisiQR, bancoIndustrial, quickPayQR | bamPaymentButton | pronet |
| El Salvador | — | — | quickPayQR | — | — |
| Honduras | — | — | quickPayQR | — | — |
| Costa Rica | — | — | quickPayQR | — | — |
| Colombia | nequi | globalPay-PSE | — | — | — |
| México | — | — | — | — | — |
| República Dominicana | — | Flujo de tarjeta vía Payment Link → azul | — | — | — |
Todas las recetas usan el entorno QA / sandbox —
https://sb-mw.migopayments.compara el Middleware. Cambia ahttps://mw.migopayments.comcuando promociones a producción.
Cómo se estructura una receta
Cada página sigue el mismo esqueleto — ve la plantilla agent-friendly para el desglose completo:
- Prerrequisitos — credenciales, entorno, flags esperadas en
clientConfig. - Paso 1 — Configurar el token del comercio (
Authorization: Bearer <token>) — sin ida y vuelta de login; ve Autenticación → Token del comercio. - Paso 2 — Crear la transacción y capturar
paymentMethods. - Paso 3 — Ejecutar el flujo específico del rail (con
payment-intentsprevio si aplica). - Paso 4 — Escuchar el webhook y verificar su firma.
- Datos de sandbox para ese rail (teléfonos de prueba, cupones de prueba, QR fixture).
- Errores comunes (
MigoCodeErrors) y cómo reaccionar. - Checklist de hecho — los resultados precisos que el agente debe confirmar.
Enlaces rápidos
- Autenticación — el token de comercio de larga duración usado por las superficies de Pagos Alternativos y Payment Link.
- Métodos de pago disponibles — catálogo de rails filtrado por país.
- Catálogo de errores — referencia de
MigoCodeErrors. - Spec de API en vivo — Migo Middleware (Scalar).
Para agentes (Claude Code, Cursor, etc.)
Las recetas son deliberadamente atómicas. Para integrar QuickPay QR en El Salvador solo necesitas /recipes/el-salvador#quickpay-qr-quickpayqr. Para integrar todos los rails de Colombia solo necesitas /recipes/colombia. La matriz de arriba mapea cada par (país, rail) a su receta.
Para índices machine-readable que resumen este catálogo sin prosa, ve /llms.txt y /llms-full.txt.