Canales de venta propios
La API Storefront es cómo construyes tus propios canales de venta en Fire spark. Úsala para impulsar una app mobile, un sitio web de pedidos, un kiosco o cualquier experiencia customer-facing que controles tú — mientras Fire spark maneja menús, tiendas, pedidos y fulfillment detrás de una sola capa omnicanal. Agregadores como Uber Eats o Rappi son canales que Fire spark conecta por ti a través de la API de integraciones. La API Storefront es para canales propios: las superficies que diseñas, marcas y lanzas tú mismo.¿Nuevo en Fire spark?
Conecta un comercio en el panel antes de construir tu primer canal.
Qué puedes construir
| Canal | Uso típico |
|---|---|
| App mobile | Loyalty, reorden, push notifications, preferencias guardadas |
| Web | Sitio de pedidos con tu marca, flujos de delivery y pickup |
| Kiosco | Autoservicio de pedidos en tienda |
| Call center | Pedidos por teléfono |
| Flujos embebidos | Widgets de pedido dentro de un producto existente |
Cómo funciona un canal propio
El cliente inicia sesión con tu proveedor de identidad
Tu canal autentica clientes con un proveedor OIDC que ya uses (Auth0, Clerk,
Supabase, Firebase, Cognito y otros). Fire spark no reemplaza tu login —
confía en el ID token que tu cliente obtiene tras el sign-in.
Intercambia el ID token por un access token de Fire spark
Tu app llama a
POST /auth/exchange con el ID token del cliente. Fire spark
lo valida, resuelve el comercio desde el issuer del token y devuelve un
access token de corta duración ligado a ese cliente.Explora menús y tiendas
Obtén tiendas cercanas al cliente, carga menús con categorías y productos, y
lee opciones de fulfillment (pickup, delivery, dine-in) para la ubicación
seleccionada.
Crea y gestiona pedidos
Crea pedidos en nombre del cliente autenticado. Consulta estado, actualiza
detalles o cancela mientras el pedido siga abierto.
Áreas de la API
La API Storefront expone los recursos que tu canal necesita para ofrecer una experiencia de pedido completa.Autenticación
Los clientes se autentican con tu proveedor OIDC. Tu cliente intercambia el ID token por un access token de Fire spark — no se requiereclient_secret en el dispositivo.
Intercambiar token
Intercambia un ID token OIDC por un access token de Fire spark.
Clientes
Registra y gestiona perfiles de cliente, preferencias de consentimiento, dispositivos y transiciones de anónimo a identificado.Registrar clientes
Crea y actualiza registros de cliente desde tu canal.
Tiendas
Lista ubicaciones del comercio y lee detalles para que el cliente elija desde dónde pedir.Menús
Carga menús, navega categorías y obtén detalles de productos con precios y disponibilidad para la tienda seleccionada.Mostrar menús
Renderiza menús en tu app, web o kiosco.
Pedidos
Crea pedidos, consulta historial, actualiza pedidos abiertos y cancela cuando esté permitido.Crear pedidos
Construye el flujo de checkout y envío de pedidos.
Fulfillment
Lee opciones de delivery, pickup y otros modos de fulfillment disponibles por tienda para que tu canal ofrezca las opciones correctas en checkout.API Storefront vs API de integraciones
| API Storefront | API de integraciones | |
|---|---|---|
| Quién la construye | Tú — equipos de app, web, kiosco | Partners de POS/RMS, integradores de sistemas |
| Quién inicia sesión | Clientes finales (vía tu proveedor OIDC) | Tu servidor (client credentials) |
| Objetivo principal | Experiencia de pedido customer-facing | Sync de menús e inyección de pedidos al POS/RMS |
| Canales | Propios: app, web, kiosco | Operativos + agregadores: Uber Eats, Rappi, etc. |
URL base
Próximos pasos
Intercambiar token
Autenticar clientes con OIDC
Autenticación OIDC
Configurar tu proveedor de identidad
Mostrar menús
Cargar menús en tu canal
Crear pedidos
Enviar pedidos desde tu canal