API de marketplace para listados, carrito, checkout y liquidaciones

Las APIs de marketplace de ChefSphere están pensadas para equipos de producto que necesitan flujos de comercio reales — no un volcado fino de catálogo. Obtienes superficies para listados, carrito, checkout, pedidos, devoluciones y liquidaciones, de modo que compradores y vendedores cierren transacciones dentro de tu app. El módulo convive con KYC de vendedores, wallets y media para que el escaparate tenga sentido sin encadenar cinco proveedores distintos solo para un checkout.

Esta guía se centra en la intención de comercio: cómo debe comportarse un backend de marketplace cuando lanzas descubrimiento, compra, traspaso al fulfillment y movimiento de dinero al vendedor. No es una visión general de arquitectura de producto ni una guía práctica del vertical restaurante; esos temas tienen páginas propias con otra intención de búsqueda. Aquí nos quedamos en listados hasta liquidaciones, y en cómo se aplica el consumo de tokens prepago cuando checkout y escrituras de pedido cuestan más que las lecturas ordinarias de catálogo.

Los listados necesitan detalle estructurado, referencias a media y una propiedad clara del vendedor que tus clientes puedan renderizar sin inventar el esquema a mitad de sprint. Carrito y checkout requieren capturas de precio deterministas, reservas conscientes del inventario y modos de fallo que soporte pueda explicar cuando el stock se mueve. Pedidos, devoluciones y liquidaciones necesitan rutas de estado ligadas a la verificación del vendedor, para que el dinero no salga antes de lo que permite la política.

En el saldo prepago las lecturas se mantienen baratas, mientras que las escrituras de checkout de marketplace viven en la banda de peso más alta porque mutan dinero e inventario. Es intencional: pagas por operaciones con riesgo de negocio, mientras que la navegación y el detalle de catálogo siguen ligeros para sesiones con mucho descubrimiento. Los tokens no usados permanecen en tu saldo en los diecinueve módulos de ChefSphere — no quedan bloqueados solo en comercio —, así que una semana tranquila de navegación no desperdicia capacidad de lanzamiento.

Solicita acceso anticipado; revisamos qué estás construyendo y te contactamos cuando abran claves y onboarding para tus mercados y modelo de vendedor. La documentación de hoy incluye formas OpenAPI ilustrativas para planificar; los contratos y entornos de producción llegan cuando te conceden el acceso anticipado.

La autenticación es estilo Firebase: un X-API-Key en cada llamada, cobrada contra tu saldo de tokens prepago compartido en toda la superficie de la plataforma. Los packs Starter empiezan en 29 $ por 200.000 tokens; Growth y Scale suben volumen y tarifa efectiva dentro de la banda pública de julio de 2026. Un solo saldo se gasta en marketplace, live, IA, social, facturación y el resto de los diecinueve módulos, sin un medidor aparte por funcionalidad.

Planifica capacidad según tu mix, no según un coste medio de llamada que oculte picos de checkout y KYC en semanas de onboarding de vendedores. Si tu primer lanzamiento es muy de navegación con poco checkout, un pack Starter puede bastar para integrar y validar los caminos comerciales clave. Si esperas checkout concurrente más IA o live en el mismo mes, Growth a 79 $ o Scale a 149 $ es la banda de planificación honesta.

Elige este módulo cuando el comercio sea la columna vertebral del producto: listados multi-vendedor, carrito, checkout, devoluciones y liquidaciones como viaje principal del usuario. Elige las guías de composición de producto cuando necesites catálogo, planificación, social y comercio juntos bajo una misma historia — fitness, creadores, social o con el comercio primero. Elige la guía de backend de marketplace restaurante cuando dominen el descubrimiento de restaurantes, menús y flujos de operador, en lugar de patrones multi-vendedor genéricos.

Solicita acceso anticipado con una nota breve sobre modelo de vendedor, geografía y si necesitas KYC antes del primer payout, para que prioricemos el onboarding. La lectura relacionada cubre KYC de vendedores, moneda en wallet y backends de marketplace restaurante, de modo que el camino del dinero y la historia vertical se diseñen pronto. Esa preparación supera cablear un escaparate contra muestras ilustrativas sin un plan de confianza o liquidación que tu equipo financiero pueda defender.