> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Construye canales de venta propios — app, web y kiosco — sobre la API Storefront de Fire spark.

## 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](https://firespark.cloud/docs/es/integrations-api/introduction.md). La API Storefront es para **canales propios**: las superficies que diseñas, marcas y lanzas tú mismo.

> [card] [¿Nuevo en Fire spark?](https://firespark.cloud/docs/es/guides/connecting-a-merchant.md)
>
> 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 |

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 requiere `client_secret` en el dispositivo.

> [card] [Intercambiar token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md)
>
> Intercambia un ID token OIDC por un access token de Fire spark.

> [card] [Inspeccionar token](https://firespark.cloud/docs/es/storefront-api/oauth/introspect/post.md)
>
> 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.

> [card] [Registrar clientes](https://firespark.cloud/docs/es/storefront-api/guides/register-customers.md)
>
> 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.

> [card] [Mostrar menús](https://firespark.cloud/docs/es/storefront-api/guides/displaying-menus.md)
>
> 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.

> [card] [Crear pedidos](https://firespark.cloud/docs/es/storefront-api/guides/placing-orders.md)
>
> 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.

> [card] [Vincular dispositivo kiosco](https://firespark.cloud/docs/es/storefront-api/kiosk/devices/link/post.md)
>
> Consulta un device code hasta que el panel lo reclama.

## 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. |

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

```
https://firespark.cloud/api/storefront/v1
```

> [card] [Colección de Postman](https://firespark.cloud/docs/assets/fire-spark-storefront-api-2026-10-16.postman_collection.json)
>
> Descarga todos los endpoints de la API Storefront. Intercambia un ID token
> OIDC primero, luego define `bearerToken` para las solicitudes autenticadas.

## Próximos pasos

> [card] [Intercambiar token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md)
>
> Autenticar clientes con OIDC

> [card] [Autenticación OIDC](https://firespark.cloud/docs/es/storefront-api/guides/oidc-authentication.md)
>
> Configurar tu proveedor de identidad

> [card] [Mostrar menús](https://firespark.cloud/docs/es/storefront-api/guides/displaying-menus.md)
>
> Cargar menús en tu canal

> [card] [Crear pedidos](https://firespark.cloud/docs/es/storefront-api/guides/placing-orders.md)
>
> Enviar pedidos desde tu canal

> [card] [Vincular dispositivo kiosco](https://firespark.cloud/docs/es/storefront-api/kiosk/devices/link/post.md)
>
> Reclama tablets por device code


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.