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 |
Headers requeridos
Cada solicitud debe incluir:
| Header | Valor | Notas |
|---|---|---|
Authorization | Bearer <jwt> | Token Bearer emitido para tu integració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 |
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.
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.