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
Cada canal propio carga menús vía Fire spark — catálogo completo o variante compuesta por superficie. Las actualizaciones operativas del POS siguen un solo sync; tú controlas si app, web y kiosco muestran el mismo surtido o menús afinados por contexto.
Cómo funciona un canal propio
1
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.
2
Intercambia el ID token por un access token de Fire spark
Tu app llama a
POST /oauth/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.3
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.
4
Crea y gestiona pedidos
Crea pedidos en nombre del cliente autenticado. Consulta estado, actualiza
detalles, cancela antes del fulfillment o reembolsa poco después.
5
Fire spark enruta el pedido a operaciones
El pedido entra al mismo pipeline que los canales agregadores. Fire spark lo
inyecta al POS o RMS del comercio a través de la capa de Integrations API.
Á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.
Inspeccionar token
Permite que el proxy de un socio confirme que el mismo access token sigue
vigente.
Clientes
Registra y gestiona perfiles de cliente, consentimiento de marketing, preferencias de notificación, 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, cancela antes del fulfillment y reembolsa pedidos fulfilled dentro de 24 horas.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.Kiosco
Las tablets autentican con un device code estable de hardware y un device secret en el body JSON — no con un access token de cliente. Vincula la tablet, envía heartbeats y suscríbete a comandos.Vincular dispositivo kiosco
Consulta un device code hasta que el panel lo reclama.
API Storefront vs API de integraciones
La mayoría de comercios usan ambas: la API Storefront impulsa los canales con los que interactúa el cliente directamente, y la API de integraciones mantiene esos canales conectados a la cocina.
URL base
Colección de Postman
Descarga todos los endpoints de la API Storefront. Intercambia un ID token
OIDC primero, luego define
bearerToken para las solicitudes autenticadas.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
Vincular dispositivo kiosco
Reclama tablets por device code