Puntos
Relaciona compras elegibles con las reglas de acumulación y muestra el saldo resultante.
Para desarrolladores
Conecta la fidelización a los sistemas que ya utilizas.
Integra Fair Loyalty con tu web, POS o aplicación mediante la API. Conserva tu experiencia actual y conecta compras elegibles, progreso y recompensas con un programa de fidelización.
La compatibilidad depende del acceso API de tu sistema y de las operaciones disponibles en Fair Loyalty.
Del sistema existente al resultado de fidelización
Flujo de referencia. Verifica endpoints y permisos de tu cuenta antes de implementar.
- 01Web, POS o aplicación
- 02Adaptador en tu servidor
- 03API de Fair Loyalty
- 04Progreso y recompensas
Elige la experiencia. Conserva tu tecnología.
Conecta las mecánicas adecuadas. Valida cada operación y regla con el contrato API vigente.
Sellos
Registra visitas o compras elegibles y muestra el progreso hacia un objetivo.
Recompensas
Consulta recompensas elegibles y conecta el canje al pago tras la autorización.
Tarjetas de socio
Relaciona la identidad del cliente con la cuenta y presenta su tarjeta digital.
Integra en tu recorrido actual
Web y comercio electrónico
Conecta inscripciones y pedidos elegibles. Muestra el progreso dentro del área de cliente.
POS y pago
Usa un adaptador para eventos compatibles. Relaciona compras, devoluciones e identificación con operaciones documentadas.
Aplicaciones y portales
Presenta saldos y recompensas en tu interfaz mediante solicitudes autorizadas desde el servidor.
Un límite claro entre tu sistema y la fidelización
Guarda credenciales en tu servidor. El adaptador convierte eventos en solicitudes documentadas y devuelve resultados a tu interfaz.
Mapeo ilustrativo · no es una solicitud API
{
"source": "pos",
"event": "purchase.completed",
"business_reference": "morrow-cafe",
"member_reference": "member-0084",
"purchase": {
"amount": 24,
"currency": "QAR"
},
"external_transaction_reference": "sale-0026"
}Planifica una integración fiable
Protege credenciales
No incluyas secretos en el navegador ni en aplicaciones. Limita el acceso a la empresa y operaciones necesarias.
Relaciona identidades
Define las correspondencias de clientes, empresas, sucursales y transacciones.
Gestiona eventos repetidos
Elige un método documentado de deduplicación. Confirma la idempotencia antes de reintentar.
Valida las anulaciones
Comprueba operaciones de devolución y cancelación para conservar un progreso correcto.
Prueba el recorrido completo
Prueba inscripción, acumulación, actualización y canje con cuentas autorizadas.
Observa resultados
Monitoriza errores y conciliación sin registrar datos personales o secretos innecesarios.
Recursos para desarrolladores
Empieza con las guías disponibles. Aquí se enlazarán la referencia API y ejemplos cuando estén configurados.
Guía de configuración
Comprende la configuración antes de conectar transacciones.
Guía del personal
Consulta identificación, compras y canjes en caja.
IA y acceso autorizado
Explora el recorrido de agentes y los permisos.
Referencia APIPróximamente
Ejemplos de integraciónPróximamente
Catálogo de webhooksPróximamente
Preguntas de integración
¿Se conecta con cualquier sistema existente?
Los sistemas con API, eventos o conectores adecuados pueden integrarse mediante un adaptador. Un sistema cerrado puede necesitar apoyo del proveedor. La compatibilidad se evalúa según las operaciones disponibles.
¿Debo sustituir mi POS o web?
Puedes conservar tu interfaz. Tu servidor o middleware conecta los eventos compatibles con la API de fidelización.
¿El ejemplo se puede ejecutar?
No. Es un esquema conceptual, no un endpoint, formato de autenticación ni contrato de solicitud publicado. Implementa con el contrato API vigente.
Añade fidelización a tu experiencia actual.
Comparte tu sistema y las operaciones necesarias. Confirma el contrato API y después implementa y prueba el adaptador.
Consultar la integración ↗