Skip to main content
El flujo estándar de enlace alojado difiere todo al destinatario: tú creas un enlace y Fluz no crea la tarjeta virtual hasta que el destinatario lo abre, se verifica y la reclama. Este flujo invierte eso para destinatarios que ya identificaste. Registras tú mismo la identidad y la dirección de facturación del destinatario con registerUser, luego generas un enlace para compartir con generateVCShareLinks usando shareMethod: EXISTING_USER. Fluz crea la tarjeta virtual de forma inmediata, en el momento de la generación — no al reclamar — y la vincula a ese único destinatario. El enlace aún se entrega y reclama de la forma normal; solo la creación de la tarjeta se adelanta. El fondeo igual se realiza al momento de la reclamación, igual que en el flujo estándar — desde userCashBalanceId, recurriendo a tu saldo de prepago o recompensas si está habilitado y la cuenta de gasto se queda corta.
Cuándo usar esto en lugar de un enlace sencillo para compartir
  • Ya sabes exactamente quién es el destinatario (por ID de usuario) y quieres que la tarjeta se cree y esté lista antes de notificarle, en lugar de esperar a que la reclame.
  • Quieres una garantía estricta de que solo el destinatario previsto podrá ver el enlace — no “la primera persona que haga clic”.
  • Estás enviando a un lote de destinatarios conocidos y quieres una asignación determinista 1:1 entre destinatario y tarjeta.

​
Antes de comenzar

Necesitarás un token Bearer de acceso. La autenticación básica no se acepta para ninguna de las operaciones.
El registro de usuarios no está habilitado por defecto. registerUser es una mutación restringida: Fluz debe aprobar explícitamente tu aplicación antes de que pueda crear usuarios. Contacta a tu representante de ventas o gerente de cuenta de Fluz para habilitarlo. Las llamadas desde una aplicación no aprobada fallan con AUTH-0022.Si el destinatario ya tiene una cuenta de Fluz, puedes omitir el registro e ir directamente a generateVCShareLinks con sus recipientUserIds existentes.
Consulta Autenticación para ver cómo generar un token con alcance. Demo open loop cards

​
En qué difiere del flujo estándar

Consulta Enviar Open Loop Cards para el flujo estándar y Experiencia del destinatario para la guía completa de reclamación.

​
Notas y limitaciones

  • recipientUserIds debe hacer referencia a usuarios de Fluz existentes. Si el destinatario aún no está registrado, regístralo primero con registerUser (este flujo), o usa el flujo estándar de enlace alojado y permite que Fluz lo incorpore al momento de la reclamación.
  • La longitud de recipientUserIds debe ser igual a quantity. Una discrepancia devuelve un error de validación y no crea registros.
  • La creación de la tarjeta se mueve al momento de la generación — el fondeo no. El objeto de la tarjeta virtual y la vinculación del destinatario se crean cuando llamas a generateVCShareLinks, pero los fondos aún se descuentan al reclamar, igual que en el flujo estándar: primero desde userCashBalanceId, luego tu saldo de prepago o recompensas como respaldo si usePrepaymentBalance / useRewardsBalance están configurados y la cuenta de gasto es insuficiente.
  • El registro es por aplicación y por entorno. El permiso otorgado para staging no se traslada a producción. Consulta Implementación en Producción.
  • Nunca registres personas reales en staging. Consulta Staging vs. Live.

​
Próximos pasos

Enviar Open Loop Cards

El flujo estándar: genera enlaces y permite que Fluz emita la tarjeta al momento de la reclamación.

Experiencia del destinatario

Lo que ve el destinatario cuando abre y reclama un enlace alojado.

Registrar clientes

Referencia completa de registerUser, incluyendo manejo de errores y patrones de respaldo.