Registrar clientes y emitir tarjetas
Crea el cliente con su teléfono y tu ID interno, emite la tarjeta del programa que corresponda y recibe el link de instalación para Apple y Google Wallet.
API REST v2 · Desarrolladores e integradores
Registra clientes, emite tarjetas en Apple Wallet y Google Wallet, suma sellos y puntos en cada venta y lee el historial completo de tu programa desde tu propio sistema. JSON, clave por cuenta y sin app que instalar.
Base: https://api.ldeloyal.com/api/v2/ · Autenticación por encabezado X-API-Key
# La venta se cobró en tu POS: suma 1 sello y registra el monto curl -X POST "https://api.ldeloyal.com/api/v2/cards/449250-228-457/add-stamp" \ -H "X-API-Key: TU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "stamps": 1, "purchaseSum": 8500, "comment": "Boleta 10293" }' # Respuesta { "code": 200, "data": { "balance": { "stamps": 4, "stampsBeforeReward": 2 } } }
# Un cliente nuevo en tu CRM: créalo y emítele su tarjeta curl -X POST "https://api.ldeloyal.com/api/v2/customers" \ -H "X-API-Key: TU_API_KEY" -H "Content-Type: application/json" \ -d '{ "firstName": "María", "surname": "González", "phone": "56912345678", "externalUserId": "CRM-10482" }' curl -X POST "https://api.ldeloyal.com/api/v2/cards" \ -H "X-API-Key: TU_API_KEY" -H "Content-Type: application/json" \ -d '{ "templateId": 1234567, "customerId": "01a0e939-a350-72fe-9cd0-d702c0ee17c2" }' # La respuesta trae installLink: envíalo por WhatsApp y la tarjeta queda en su wallet
# Todo lo que pasó en septiembre, para tu BI curl "https://api.ldeloyal.com/api/v2/operations?startDate=2026-09-01&endDate=2026-09-30&itemsPerPage=500" \ -H "X-API-Key: TU_API_KEY" # Cada operación: eventName, amount, purchaseSum, balance, cardId, customerId, locationId, createdAt { "meta": { "totalItems": 816, "itemsPerPage": 500, "currentPage": 1 }, "data": [ … ] }
Qué puedes hacer
La misma API que usa nuestra plataforma, acotada a tu cuenta. Cuatro grupos de operaciones cubren el 95 % de las integraciones.
Crea el cliente con su teléfono y tu ID interno, emite la tarjeta del programa que corresponda y recibe el link de instalación para Apple y Google Wallet.
Al cobrar en tu POS, la venta suma sellos o puntos en la tarjeta del cliente con el monto y un comentario. El wallet se actualiza al instante.
Descuenta la recompensa disponible desde tu caja y deja el canje registrado con su monto, sin que el cajero salga de tu sistema.
Cada sello, punto, compra, canje y visita con fecha, sucursal, monto y saldo. Hasta 1.000 registros por página para alimentar tu BI.
Cómo empezar
La entrega el equipo de LdeLoyal a pedido de la empresa. Cada clave está asociada a una sola cuenta y solo ve los clientes, tarjetas y programas de esa cuenta.
Un GET /templates con tu clave devuelve tus programas con su id y el link público de registro. Si responde "code": 200, estás dentro.
Busca al cliente por teléfono, emite su tarjeta y suma sellos o puntos en cada venta. Todo en JSON, con paginación estándar y 10 solicitudes por segundo.
Endpoints principales
La referencia completa, con cuerpos, filtros y respuestas de ejemplo, está en la documentación de la API.
Casos de integración
El cajero no toca otra pantalla. El monto viaja en purchaseSum y el ticket queda en comment para conciliar.
Tu ID interno viaja en externalUserId, así cruzas los datos en ambos sentidos sin tablas intermedias.
Cualquier plataforma de automatización con un módulo HTTP conecta en minutos. Ideal para reportes diarios por sucursal.
Límites y seguridad
429: espera un segundo y reintenta. Listas paginadas con page e itemsPerPage (máximo 1.000).Preguntas frecuentes
No. La clave de API se entrega a pedido a las cuentas con plan activo (USD 57/mes o USD 342/año), sin cargo adicional. Escríbenos con el nombre de tu empresa y la recibes por un canal seguro.
Para conectar un punto de venta o un sistema propio, sí: es una API REST con JSON, como cualquier otra. Para automatizaciones simples (un cliente nuevo en tu CRM → una tarjeta en su wallet) basta con Make, n8n o Zapier usando su módulo HTTP; te pasamos el flujo.
No. Todo lo que hagas con tu clave ocurre en tu cuenta real y lo ven tus clientes en su wallet. Prueba primero con un cliente tuyo (tu propio teléfono) y usa los movimientos inversos (subtract-stamp, subtract-point) si te equivocas.
Cualquiera que pueda hacer una llamada HTTP: puntos de venta, software de agenda, CRM, ERP, e-commerce, plataformas de automatización y paneles de datos. Los casos más comunes son sumar puntos desde el POS al cobrar y crear la tarjeta cuando el cliente se registra en otro sistema.
Sí. GET /operations devuelve cada sello, punto, compra, canje y visita con fecha, sucursal, monto y saldo. Con startDate y endDate y hasta 1.000 registros por página puedes alimentar Google Sheets, Looker Studio o tu BI.
Cada clave está asociada a una sola cuenta y solo ve y modifica los clientes, tarjetas y programas de esa cuenta. Úsala solo desde tu servidor, nunca en una web o app pública. Si crees que se filtró, la reemplazamos al instante.
Cuéntanos qué sistema quieres conectar (POS, agenda, CRM, Make/n8n) y te respondemos con la clave, el flujo recomendado y un contacto técnico directo.