La API de Loyaltify permite que tu desarrollador conecte Loyaltify a tus propios sistemas, como una caja, una herramienta de reservas o tu web. Por ejemplo, una caja puede añadir puntos automáticamente después de cada venta, así tu equipo no tiene que escanear la tarjeta.
Esta guía es para ti y para tu desarrollador: dónde encontrar tu clave API, dónde está la documentación y lo que conviene saber antes de empezar a desarrollar.
💡 Conviene saber: esto forma parte del plan Advanced. Deja de funcionar si cambias a un plan inferior.
Encuentra tu clave API
En Loyaltify, haz clic en tu nombre arriba a la derecha.
Ve a Perfil y copia tu clave API.
¿No ves la clave API en tu cuenta Advanced? Contacta con el soporte por el chat en vivo y te la activaremos.
⚠️ Trata tu clave API como una contraseña. Compártela solo con tu desarrollador y no la pongas nunca en el código de una web ni en un enlace.
Lee la documentación
La documentación completa de la API está en api.loyaltify.io/api-docs. Algunas cosas que tu desarrollador debe saber:
Envía la clave API en la cabecera
X-API-Keycon cada solicitud.Usa la dirección de producción,
api.loyaltify.io.Si abres un endpoint en el navegador, verás «Unauthorized». Es normal, porque el navegador no envía tu clave.
Qué puedes hacer con la API
Registrar clientes a través de uno de tus formularios de registro, por ejemplo desde tu propia web o app. La respuesta incluye los enlaces a la tarjeta del cliente en Apple Wallet y Google Wallet.
Consultar clientes y sus transacciones, actualizar sus datos o eliminarlos.
Añadir sellos, puntos o crédito, o canjear recompensas con una solicitud de escaneo, igual que hace tu equipo en la app Loyaltify Store. Lo que envías depende del tipo de tarjeta.
Conviene saber
El código QR de cada tarjeta siempre tiene el mismo formato:
lytf-, el ID de tu tienda y, a continuación, el ID del cliente. Una caja puede leerlo para encontrar al cliente correcto.Cada cliente tiene dos ID: un ID de cliente corto (el que aparece en su tarjeta y en los webhooks) y un número interno que usan algunas solicitudes de la API. La documentación explica cómo obtener uno a partir del otro.
¿Necesitas el ID de tu tienda? Contacta con el soporte por el chat en vivo.
Varios locales o cajas pueden usar la misma clave API.
¿Quieres saber cuándo pasa algo? Usa los Webhooks para recibir un mensaje cada vez que un cliente se registra o acumula.
💡 ¿Quieres que lo desarrollemos nosotros? También creamos integraciones a medida, con presupuesto aparte. Contacta con nosotros por el chat en vivo indicando el sistema que usas y lo que te gustaría que pasara.
¿Necesitas ayuda?
¡Estamos aquí para ayudarte!
Si tienes cualquier pregunta sobre la API, escríbenos por el chat en vivo dentro de Loyaltify o usa el botón de chat abajo a la derecha de esta página. Nuestro equipo te ayudará encantado.