Qué es un adaptador de API
Mapeamos nuestras llamadas de API con las de ellos. Cada operación que tu proveedor expone — crear un pedido, verificar un pedido, leer un saldo — tiene una operación de Fluz detrás, y el adaptador se sienta en el medio haciendo la traducción en ambas direcciones. El resultado es que la integración que ya construiste contra Tango, Runa o InComm ahora compra a Fluz. Conservas las formas de tus solicitudes, y una respuesta exitosa regresa en la forma que tu parser ya espera. Dos cosas son de Fluz en lugar de tu proveedor: las respuestas de error y los valores de estado de pedido. Ambas se cubren en Comportamiento del conector.
Piensa en un adaptador de enchufe de viaje. El electrodoméstico no cambia. El tomacorriente no cambia. Algo en medio hace que ambos encajen.
Cómo funciona el mapeo
Tu solicitud llega con la forma del proveedor. El adaptador traduce la ruta y los campos a la operación equivalente de Fluz, la ejecuta contra el suministro de Fluz y luego traduce el resultado de vuelta a la forma de respuesta que tu código ya espera.
Mapeo de operaciones
Cada página de conector publica la tabla completa para su proveedor. Tango Card, como ejemplo:
Las rutas y los verbos se conservan deliberadamente. El objetivo del adaptador es que tu capa de enrutamiento no tenga que saber que algo cambió.
Mapeo de campos
Tango Card de nuevo, como ejemplo:Tango e InComm devuelven resultados completos de manera síncrona. La llamada no regresa hasta que la compra haya terminado, lo que puede tardar hasta 150 segundos, así que establece el read timeout de tu cliente por encima de eso. Runa es asíncrono por defecto: devuelve un ID de referencia de inmediato y lees el pedido una vez que se completa. Envía
X-Execution-Mode: sync para esperar el resultado completo. Ambos se cubren en Comportamiento del conector.Restricciones de solicitud por proveedor
La forma de la solicitud de tu proveedor se acepta tal cual, pero algunos valores están fijos. La entrega por email al destinatario debe estar desactivada, los pedidos son de un solo destinatario y un solo producto, y los pedidos de Runa deben financiarse desde el saldo de la cuenta en USD. Una solicitud que rompa alguno de estos se rechaza. La lista completa está en Comportamiento del conector. Léela junto con los ejemplos de solicitud de la página de tu conector antes de hacer el cambio.Qué cambia y qué no
Los identificadores de marca son lo único que debes cambiar. El adaptador no traduce el catálogo de productos del proveedor al de Fluz. Un
utid de Tango U561593 no es la misma tarjeta que un utid de Fluz 1800FL-US. Mapea tu lista de marcas contra el catálogo de Fluz antes de el cambio, o tus pedidos tendrán éxito y entregarán la tarjeta equivocada.Cambiar en tres pasos
1
Cambia la URL base
Apunta tu cliente existente al host del adaptador de Fluz para tu proveedor. Para Tango Card es
https://api-adapter.staging.fluzapp.com/tangocard en staging y https://api-adapter.fluzapp.com/tangocard en producción, en lugar de https://integration-api.tangocard.com/rass. Ambos hosts aparecen en cada página de conector.2
Cambia el encabezado Authorization
Cada conector usa autenticación HTTP Basic con tu Fluz API key:
Authorization: Basic <FLUZ-API-Key>. Elimina el usuario y contraseña del proveedor.3
Remapea tus identificadores de marca y envía las mismas llamadas
Cambia tus códigos de producto del proveedor por sus equivalentes de Fluz. Todo lo demás — rutas, verbos, cuerpos de solicitud, parseo de respuestas — permanece igual.
Conectores disponibles
Tarjetas de regalo
Documentados y disponibles. Tango Card, Runa, InComm — cada uno con una comparación de endpoints publicada y ejemplos de solicitudes.
Procesamiento de pagos
Beta. Stripe, Worldpay, TSYS, Checkout, Braintree, TabaPay, Finix, Authorize.net, Sola / Cardknox. Contacta a ventas para acceso anticipado y detalles de endpoints.
Retiros de billetera
Beta. Venmo y PayPal. Contacta a ventas para acceso anticipado y detalles de endpoints.
La cobertura es por operación
El adaptador implementa las operaciones listadas en cada página de conector, y solo esas. Cada una es una traducción construida a propósito para esa operación en lugar de un passthrough general.
Los conectores son independientes de la Fluz GraphQL API
Esto confunde a la gente, así que vale la pena decirlo claramente. Fluz tiene dos superficies de desarrollador distintas y no comparten credenciales.Las keys de conector no son keys del dashboard. La API key que generas en la sección Developers del dashboard de Fluz no autenticará contra un conector, y viceversa. Las credenciales de conector son aprovisionadas por Fluz. Contacta a tu representante de Fluz para solicitar una.
Cuándo usar un conector y cuándo no
Usa un conector cuando
Tienes una integración de proveedor funcionando en producción, quieres el suministro y las tarifas de Fluz rápidamente, y no quieres invertir un ciclo de ingeniería en el cambio. El tiempo para estar en vivo se mide en días.
Usa la Fluz API cuando
Quieres la plataforma completa: tarjetas virtuales, billeteras y cuentas de gasto, datos de transacciones, webhooks, tasas de cashback, cotización de ofertas y el catálogo completo de comercios. Nada de eso es accesible mediante una interfaz con forma de proveedor.
Cómo obtener acceso
Los Conectores de API se ofrecen actualmente como un programa beta. Contacta a tu representante de Fluz o envía un email a ventas para solicitar credenciales de conector y confirmar la cobertura de operaciones para tu proveedor.Elige tu proveedor
Tango Card
Pedidos y saldos de cuenta. Basic auth, respuestas síncronas.
Runa
Pedidos y saldos por moneda. Modos de ejecución síncrono y asíncrono.
InComm
Pedidos inmediatos, detalle de pedido, recuperación de tarjeta y saldo del programa.