Skip to main content
Usa estos IDs de oferta para emitir tarjetas virtuales en el entorno de staging. Cada tarjeta virtual se crea a partir de una oferta, que determina el programa de la tarjeta (red, BIN y recompensas). Los IDs de oferta a continuación están habilitados para staging y se pueden pasar directamente a createVirtualCard.
Completa KYC primeroLas tarjetas virtuales solo se pueden emitir en una cuenta que haya completado la verificación de identidad. Hasta que la cuenta — y, en el caso de una empresa, sus beneficiarios finales — apruebe KYC/KYB, getVirtualCardOffers puede devolver vacío y createVirtualCard fallará. Ejecuta la verificación antes de hacer pruebas. Consulta Verificación KYC de Usuario para saber cómo enviarla, y obtén identidades de prueba en Probar flujos de KYC.
Solo stagingEstos IDs de oferta se aceptan únicamente en el endpoint de staging (https://transactional-graph.staging.fluzapp.com/api/v1/graphql). Serán rechazados en producción, donde debes recuperar un ID de oferta activo desde Obtener ofertas de Tarjeta Virtual.

​
IDs de oferta en staging

​
¿Cuál oferta deberías elegir?

Cada programa emite una tarjeta Mastercard prepago, pero difieren en dónde se puede gastar la tarjeta y cómo se financia. Elige la que coincida con el comportamiento que quieres probar:
El programa de propósito general: una tarjeta prepago estándar de uso múltiple que se puede gastar en cualquier lugar donde se acepte Mastercard, dentro de los límites de gasto que configures. Comienza aquí si solo quieres ejecutar el camino feliz de punta a punta.
Una tarjeta restringida a un solo comercio o marca. Las transacciones en cualquier otro comercio se rechazan. Úsala para probar controles de gasto restringidos por comercio — por ejemplo, una tarjeta que solo funciona con un proveedor.
Una tarjeta financiada una sola vez, en la creación. El saldo se carga por adelantado y se va consumiendo — no se puede recargar después. Úsala para probar flujos de tarjetas de valor fijo y desechables como pagos únicos a proveedores o desembolsos.
Una tarjeta cuyo saldo se puede recargar después de la creación. Úsala para probar tarjetas de larga duración que se reponen repetidamente — asignaciones recurrentes, tarjetas de equipo o gasto continuo de suscripciones.

​
Flujo recomendado

En lugar de codificar un ID de oferta, recomendamos descubrir ofertas en tiempo de ejecución: la lista devuelta refleja exactamente a qué tiene derecho tu cuenta. Es una secuencia rápida de dos llamadas.
1

Listar ofertas disponibles

Llama a getVirtualCardOffers y toma un offer_id de la respuesta.
2

Crear la tarjeta

Pasa ese offer_id a createVirtualCard. Una respuesta exitosa devuelve un virtual_card_id con estado ACTIVE.
Mantén spendLimit en o por debajo de tu saldo disponible — la tarjeta se financia desde tu saldo de Fluz, por lo que un límite mayor fallará con un error de saldo insuficiente. Una prueba de $5 es el primer intento más seguro. Puedes omitir la dirección de facturación en tu primera tarjeta para mantener simple el camino feliz; agrega una más tarde con Agregar dirección de Tarjeta Virtual.

​
Próximos pasos

Crear Tarjeta Virtual

La referencia completa de createVirtualCard: entradas, financiamiento y el ciclo de vida de la tarjeta.

Probar flujos de KYC

Identidades de prueba que devuelven cada resultado de verificación: aprobado, rechazado y duplicado.
¿Quieres saber más? Contáctanos en partnerships@fluz.app. Habla con nuestros expertos para más información o para solicitar una demo.