Emisión de tarjetas

Una tarjeta es una tarjeta débito — virtual o física — que Mono aprovisiona contra una de tus cuentas de Banking en alianza con Visa. La emisión de tarjetas es el flujo que tu negocio corre cuando quieres darle a un account holder una forma de gastar su saldo en cualquier comercio habilitado para Visa directamente desde Mono, sin requerir una transferencia separada.

Usa este flujo para tarjetas de gastos de empleados, tarjetas prepago para clientes, tarjetas de gasto para vendedores de un marketplace, o cualquier caso donde un account holder necesite una credencial de tarjeta vinculada a su cuenta Mono.

Antes de empezar

Vas a necesitar:

• Una cuenta Mono con Banking (Tarjetas) habilitado y una API key. Ver Autenticación.
• Una cuenta de Banking ya creada a la que la tarjeta estará vinculada.
• Un endpoint de webhook suscrito a eventos de transacciones de tarjeta para la actividad de gasto una vez la tarjeta esté emitida.
• Una clave de idempotencia por cada solicitud de creación de tarjeta para que los reintentos sean seguros.

Vista general de la secuencia

1. Solicita una tarjeta — tu operador o aplicación dispara la creación de tarjeta para un account holder específico y un tipo de tarjeta (virtual o física).
2. Llama a Mono — tu backend envía la solicitud de creación de tarjeta con el id de la cuenta, datos del holder y una clave de idempotencia.
3. Mono aprovisiona con la red de tarjetas — Mono solicita las credenciales a Visa y recibe un número de tarjeta tokenizado, fecha de expiración y CVV.
4. Recibe la tarjeta — Mono devuelve síncronamente el id de la tarjeta y el PAN enmascarado. Las tarjetas virtuales regresan en estado active y se pueden usar inmediatamente. Las tarjetas físicas regresan en estado created y deben ser activadas por el holder en la app de Mono antes de que funcionen.
5. Entrega al holder — tu backend expone los detalles de la tarjeta al operador o al account holder. Para tarjetas físicas, también comunica el paso de activación.

Pasos

El paso a paso completo (con ejemplos en curl, Node.js y Python para creación, configuración de PIN y controles de tarjeta) está pendiente. Hasta que se publique, ver:

• La página de webhooks de transacciones de tarjeta para los payloads de eventos de gasto y autorización.
• Claves de idempotencia para reintentos seguros en solicitudes de creación.

Siguientes pasos

• Recaudo PSE — acepta pagos a la cuenta que fondea la tarjeta.
• Webhooks de Banking — los eventos que rastrean el ciclo de vida y la actividad de gasto de la tarjeta.
• Sandbox — emite una tarjeta de prueba sin activar credenciales reales de la red de tarjetas.