Plataforma de loyalty API-first y headless: qué es y qué pedirle
Recursos · Concepto
Una plataforma de loyalty API-first y headless expone toda la lógica del programa (socios, puntos, niveles, promociones, cupones y canje) por API, para que cada canal use su propio frontend: app, ecommerce, caja o kiosco. Qurable es API-first y headless, con SDK para iOS, Android y React Native, y además trae portal y app white-label para quien no tiene frontend.
- AppCheckout propio
- CajaPOS del local
- KioscoAutoservicio
CamilaSocia Fan · 2.480 ptsLos canales- APIUn solo motor
- SDKiOS, Android, React Native
- WebhookHecho emitido
- < 50 msSocia identificada
- ~150 msPromoción decidida
- < 1 sCompra registrada
Bancos y fintechs, en producción
Nuestros clientes de banca y fintech ya dan cashback en el pago con Qurable.
Pomelo, Santander Perú, Banisi y Konfío, entre otros. Con Pomelo, los bancos, fintechs y empresas que emiten tarjetas activan loyalty y cashback sin un proyecto técnico aparte.
- ~150 msDecisión del beneficioDentro de la autorización
- < 50 msIdentificación del sociop95, del lado del servidor
- 99,5%SLADisponibilidad comprometida
- 18MSociosEn programas sobre Qurable
Lo esencial
- API-first significa que toda la lógica del programa está en la API antes que en una pantalla; headless, que cada canal usa su propio frontend.
- A la API hay que pedirle cobertura completa, credenciales por cliente, webhooks firmados, idempotencia y SDK para tus apps.
- Headless y white-label no se excluyen: lo útil es poder usar los dos, según el canal.
La diferencia
Headless o atado a una pantalla.
Muchas plataformas de fidelización tienen una API, pero la lógica vive en su portal: hay cosas que solo se hacen desde su pantalla. En una plataforma API-first, todo lo que hace el programa se puede hacer por API.
| Loyalty atado a su frontend | API-first y headless, con Qurable | |
|---|---|---|
| Dónde vive la lógica | En el portal del proveedor; la API cubre una parte | En la API: socios, puntos, niveles, promociones, cupones y canje |
| Canales | Un frontend por defecto y adaptaciones para el resto | App, ecommerce, caja y kiosco, cada uno con su frontend, sobre el mismo motor |
| Promociones | Se configuran en un sistema y se aplican en otro | El mismo motor decide la promoción en ~150 ms y la aplica en el canal |
| Eventos | Archivos diarios o consultas periódicas | Cada hecho sale por webhook firmado, en el momento |
| Apps | Una app genérica o un desarrollo desde cero | SDK para iOS, Android y React Native, o app white-label |
| Agentes de IA | Sin acceso o con integraciones a medida | Servidor MCP con los mismos permisos que la API |
| Despliegue | Solo en la nube del proveedor | En nuestra nube, compartida o dedicada, o en la tuya, en cualquier nube y región |
Las piezas
Qué tiene una plataforma API-first.
Cuatro piezas para revisar en una demo, con la documentación abierta.
Toda la lógica por API
Alta de socios, acumulación, canje, niveles, promociones y cupones, sin pasos que solo existan en un portal.
Acceso con credenciales
La API es pública y se accede con credenciales que autoriza cada cliente, para proteger el programa y sus datos.
Idempotencia
Un reintento con la misma clave nunca genera un segundo movimiento.
Webhooks por cada hecho
Puntos ganados y gastados, cambio de nivel, cupón canjeado y misión completada.
Firmados
Cada evento lleva una firma para que el sistema que lo recibe verifique su origen.
Exportación a tu destino
Socios, movimientos, niveles y cupones, en una exportación diaria.
SDK para tus apps
iOS, Android y React Native, para sumar el programa a la app que ya tienes.
White-label cuando lo necesitas
Portal del socio y app nativa listos, con tu marca.
Cualquier canal
App, ecommerce, caja y kiosco de autoservicio sobre el mismo motor.
POS, procesadores y checkouts
Conectado con POS como Napse y Oracle, con procesadores de pago y con checkouts.
CRM y marketing
Salesforce, Microsoft Dynamics y herramientas como Braze o Klaviyo, por webhooks y API.
Agentes de IA por MCP
Un servidor MCP para consultar y operar el programa, con permisos y aprobación humana.
Qué pedirle a la API
Las preguntas para tu equipo técnico.
Una API se evalúa con la documentación abierta y una prueba real, no con un diagrama de arquitectura.
| Qué preguntar | Qué respuesta buscar |
|---|---|
| ¿Todo se puede hacer por API? | Alta, acumulación, canje, niveles, promociones y cupones, sin pasos que solo existan en el portal. |
| ¿Promociones complejas por API? | Combinables, NxM, combos, escalonadas, reglas de carrito y condiciones del medio de pago (banco o tarjeta), evaluadas en el momento de la compra. |
| ¿Cómo se accede? | Documentación de la API y credenciales por cliente y por entorno, con permisos por rol. |
| ¿Cuánto tarda cada operación? | Identificación, decisión y registro, en p95 y medidos en producción. |
| ¿Qué pasa si falla? | La venta no se bloquea: la acumulación queda en cola y se registra al volver. |
| ¿Qué hechos emite? | La lista de eventos, si están firmados y si se reintentan cuando falla el destino. |
| ¿Hay SDK? | Para las plataformas de tus apps, incluidas las multiplataforma como React Native. |
| ¿Y si no tengo frontend? | Un portal y una app white-label sobre el mismo motor, para salir rápido. |
Cuándo conviene
Headless, white-label o las dos.
No es una decisión de todo o nada: muchos programas combinan los dos según el canal.
Headless
Si ya tienes app, ecommerce y caja propios y quieres el programa dentro de cada uno.
White-label
Si necesitas salir rápido sin construir el frontend del socio.
Las dos
Tu app con SDK y un portal white-label para otro canal, sobre el mismo motor.
En 1 a 3 meses
Por etapas, empezando por el canal que más vende.
Con Qurable
API-first en producción, en programas reales.
La misma API sostiene programas con app, ecommerce, caja y kiosco en varios países de Latinoamérica.
MostaClub: app, caja y kiosco
Mostaza aplica promociones combinables, NxM, combos y descuentos escalonados en tiempo real en el checkout de la app, la caja y el kiosco de autoservicio.
Ver el caso MostaClubClub TaDa: una arquitectura basada en APIs
El ecommerce de AB InBev en Argentina lanza reglas, cupones y promociones sin escribir código nuevo.
Leer el caso Club TaDaShell Box: condiciones por medio de pago
Promociones en tiempo real que evalúan el banco y la tarjeta con que paga cada cliente, dentro de la misma compra.
Ver el caso Shell BoxPomelo y Credit Union Travel
Ofrecen loyalty a sus clientes con Qurable detrás, operado desde su propia consola.
Loyalty en el POS y el checkout
Preguntas
Lo que preguntan sobre loyalty API-first.
Respuestas cortas para equipos de tecnología, producto y loyalty.
Es una plataforma de fidelización que expone toda la lógica del programa por API antes que en una pantalla: socios, puntos, niveles, promociones, cupones y canje. Cualquier canal o sistema puede operar el programa sin depender del portal del proveedor.
Que el motor del programa está separado del frontend: la app, el ecommerce, la caja o el kiosco usan su propia interfaz y se conectan al mismo motor por API. El socio ve la experiencia de la marca, no la del proveedor.
Sí. La API de Qurable es pública y se accede con credenciales que autoriza cada cliente; cada hecho del programa sale por webhook firmado y hay SDK para iOS, Android y React Native. Mostaza la usa en la app, la caja y el kiosco; Shell Box, para promociones con condiciones de banco y tarjeta; y Pomelo y Credit Union Travel, desde su propia consola.
Sí: la API es pública y el acceso se da con credenciales autorizadas, por cliente y por entorno, para proteger el programa y sus datos. La documentación está en docs.qurable.co.
Depende del canal. Headless conviene si ya tienes app, ecommerce y caja propios; white-label, si necesitas salir rápido sin construir el frontend. Con Qurable se pueden combinar: SDK en tu app y portal white-label para otro canal, sobre el mismo motor.
Sí. Se integra por API con el resto del stack (ecommerce, POS, CRM, CDP y data warehouse) y emite cada hecho por webhook. No reemplaza tu CRM ni tu ecommerce: se conecta a ellos.
Sí, a través del servidor MCP de Qurable, con los mismos permisos y reglas que la API. Lo que tiene efecto sobre los socios no se activa sin aprobación humana.
Revisado el
Para profundizar
Seguir leyendo sobre la arquitectura.
Las páginas donde la API se ve en el producto.
- MóduloMotor de promociones
Promociones complejas decididas en el pago, en tiempo real.
- ConceptoLoyalty en tiempo real
Qué latencias importan y cómo detectar el batch disfrazado.
- ConceptoSistema de gestión de lealtad (LMS)
Qué incluye un LMS y qué exigirle.
- MóduloCustomer Data Platform
El perfil del socio que leen la API y la IA.
- ComparativaQurable vs Open Loyalty
Dos plataformas API-first, frente a frente.
Prueba la API con tu equipo técnico.
En una sesión técnica de 45 minutos recorremos la API, una compra de punta a punta y los webhooks, con un caso como el tuyo.