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. Cada paso enlaza a la referencia detallada.

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 ambos modos de registro, 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.

nota

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 → Activar una tarjeta 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 entre tarjetas — mover dinero entre tarjetas emitidas por Migo
• Vinculación de tarjetas de terceros — asociar tarjetas externas a un titular