Flujo de emisión de tarjetas
La vertical de tarjetas de Migo es un programa white-label: una empresa puede emitir sus propias tarjetas físicas prepago de marca para sus usuarios (por ejemplo, tarjetas corporativas para empleados). El programa se configura por tenant/empresa, de modo que las tarjetas, la marca y los límites pertenecen a la empresa emisora.
Esta página describe el flujo de extremo a extremo para poner una tarjeta funcional en manos de un titular.
De un vistazo
1. Entorno de la empresa habilitado para tarjetas (se hace en el onboarding por Migo)
│
▼
2. Crear el titular POST /users ──► userId
│
▼
3. Entregar la tarjeta física (plástico) logística
│
▼
4. El titular activa la tarjeta webview de activación
│
▼
5. Gestión de tarjeta habilitada bloqueo · desbloqueo · movimientos · detalles · PIN · CVV · fondos
1. Entorno habilitado para tarjetas
La emisión de tarjetas se habilita para tu empresa durante el onboarding — Migo aprovisiona el programa de tarjetas para tu tenant (marca, moneda y límites del producto). No existe un endpoint público para este paso; coordínalo con tu account manager antes de empezar a crear titulares.
2. Crear el titular
Cada tarjeta pertenece a un titular — un usuario en el entorno de tu empresa. Registra al titular con POST /users (pasando su información personal); la respuesta devuelve el userId que usarás durante el resto del flujo.
curl -X POST https://api.ali.app/rest/users \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "firstName": "Example", "lastName": "User", "...": "..." }'
Gestión del titular es la referencia canónica de este endpoint — documenta el registro con la información del titular, el esquema completo de campos y las validaciones.
3. Entregar la tarjeta física
El plástico impreso se entrega al titular a través de tu proceso de distribución. La tarjeta llega inactiva — no puede transaccionar hasta que el titular la active.
4. Activar la tarjeta
El titular activa su tarjeta a través del webview de activación hospedado por Migo. Ábrelo con el userId del titular:
https://web.migopayments.com/card-activation?client=migoDeveloper&userId=YOUR_USER_ID
| Query param | Requerido | Propósito |
|---|---|---|
userId | Sí | El titular creado en el paso 2 |
client | No | Pista de marca para la pantalla de activación (el slug de tu cliente) |
En el webview el titular ingresa el número de tarjeta y el nombre del titular impreso en el plástico, y confirma. El webview asocia la tarjeta con el usuario y la activa — no se requiere integración por API de tu lado para este paso.
Usa el host de sandbox para pruebas: https://sandbox.migopayments.com/card-activation?client=migoDeveloper&userId=YOUR_USER_ID.
Si prefieres activar la tarjeta desde tu propio backend en lugar del webview, también hay disponible un endpoint de activación por API. Consulta Ciclo de vida de la tarjeta → Dar de alta una tarjeta en un usuario para ambas rutas de activación.
5. Gestionar la tarjeta
Una vez que la tarjeta está activa, la API de gestión queda habilitada para ella. Desde aquí puedes:
- Ciclo de vida de la tarjeta — leer detalles de la tarjeta, bloquear / desbloquear, actualizar el alias, generar estados de cuenta
- Gestión de PIN — establecer, rotar y verificar el PIN de la tarjeta
- Asignar fondos — cargar o retirar saldo de la tarjeta
- Transferencias tarjeta a tarjeta — mover dinero entre tarjetas emitidas por Migo
- Vinculación de tarjetas de terceros — asociar tarjetas externas a un titular