Recetas de integración
Recetas por país para los rails de pagos alternativos que Migo expone. Cada una es autocontenida: prerrequisitos, el curl exacto, la respuesta esperada, los datos de sandbox y los errores comunes.
Matriz país × rail
La tabla cubre los rails de pago alternativo que tienen receta y que retornan un payload en POST /api/v1/integrations/.../payments. No es la lista exhaustiva de procesadores: existen llaves adicionales (zigiQR, bbvaQR, push-payment-gateway) para clientes específicos, que se resuelven en runtime desde el clientConfig.processors de cada comercio.
| País | Wallets / push | Transferencia bancaria | QR | Botón hosteado | Efectivo |
|---|---|---|---|---|---|
| Guatemala | zigi | — | akisiQR, bancoIndustrial, quickPayQR | bamPaymentButton | pronet |
| El Salvador, Honduras, Costa Rica | — | — | quickPayQR | — | — |
| Colombia | nequi | globalPay-PSE | — | — | — |
| República Dominicana | — | Flujo de tarjeta vía link de pago → azul | — | bancoPopular | — |
México no tiene rails de pagos alternativos cableados: los cobros con tarjeta se hacen con links de pago, que enrutan al procesador de tarjeta configurado.
Todas las recetas usan el sandbox — https://sb-mw.migopayments.com para el Middleware. Cambia a https://mw.migopayments.com al promover a producción.
Estructura de una receta
Cada página sigue el mismo esqueleto:
- Setup — las variables de entorno y la llamada que crea la transacción.
- Procesar el pago — el
curlpor rail y la forma de su respuesta. - Entrega del estado — el callback del comercio.
- Errores — los códigos de error del middleware y cómo reaccionar.
Enlaces rápidos
- Métodos de pago disponibles — catálogo de rails filtrado por país
- Catálogo de errores — referencia de códigos de error
- Referencia de API — Migo Middleware
Para un índice machine-readable de este catálogo, sin prosa, ve /llms.txt.