Entornos y URLs base
Migo expone un entorno de Sandbox (integración/pruebas) y un entorno de Producción. Las credenciales, los endpoints de webhook y las llaves Ed25519 no se comparten entre entornos — solicita credenciales separadas para cada uno.
Matriz de entornos
| Entorno | Propósito | Datos |
|---|---|---|
| Sandbox / QA | Desarrollo y pruebas de integración | Solo datos de prueba — sin fondos reales |
| Producción | Fondos reales, titulares de tarjeta reales | Persistentes, dentro del alcance de PCI |
URLs base
Wallet Gateway (ali-api-gw-rest)
| Entorno | URL |
|---|---|
| Producción | https://api.ali.app/rest |
| QA | https://ali-qa.ali.app/rest |
| Local | http://localhost:3010 |
Middleware (migo-api)
| Entorno | URL |
|---|---|
| Producción | https://mw.migopayments.com |
| Sandbox | https://sb-mw.migopayments.com |
| Local | http://localhost:3000 |
CMS Backoffice (ali-api-cms-rest)
| Entorno | URL |
|---|---|
| Producción | https://api.ali.app/cms/rest |
| QA | https://ali-qa.ali.app/cms/rest |
| Local | http://localhost:3000 |
Headers requeridos
Cada solicitud debe incluir:
| Header | Valor | Notas |
|---|---|---|
Authorization | Bearer <jwt> | Consulta Autenticación |
applicationId | Identificador de tu aplicación | Requerido únicamente por los endpoints de configuración del Wallet Gateway (GET/PATCH /configs) — no por el login de usuario ni por las solicitudes generales |
x-user-token | Token de usuario del CMS | Solo API del CMS |
Content-Type | application/json | Para POST / PUT / PATCH |
Pasar de sandbox a producción
Antes de cambiar a las URLs de producción:
- Rota las credenciales — las llaves de producción son independientes.
- Cambia el receptor de webhooks a HTTPS con un certificado válido.
- Confirma con Migo cualquier requisito de lista de IPs permitidas.
- Recorre la Lista de verificación para salir a producción.
Límites de tasa
Confírmalo con Migo
El código de aplicación de los gateways no aplica por sí mismo límites de tasa de solicitudes. Si algún throttling aplica a tu integración, se configura por acuerdo en la capa de borde — confirma con Migo los límites que apliquen a tu caso antes de hacer pruebas de carga o enviar tráfico de alto volumen.
Si se supera un límite, podrías recibir 429 Too Many Requests. El backoff exponencial es el comportamiento recomendado del cliente.