Saltar al contenido principal
Migo Docs

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 paramRequeridoPropósito
userIdSíEl titular creado en el paso 2
clientNoPista 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 → 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: