Conecte su caja registradora con su programa de fidelización
BonusQR funciona por sí solo con un escáner en el móvil. Si quiere que su caja gestione también la fidelización, su proveedor de TPV puede conectarla mediante nuestra API REST documentada: la caja escanea el código del cliente, aplica el descuento y canjea las recompensas en un solo paso.
- API REST documentada
- Descuentos y recompensas en caja
- Opcional: BonusQR funciona sin ella

Tarjeta de fidelización escaneada: descuento del 10 % aplicado
¿Qué es una integración TPV con fidelización?
Una integración TPV permite que su caja registradora se comunique con su programa de fidelización. En lugar de escanear en una app aparte, el personal escanea en la caja el código QR de fidelización del cliente y el TPV aplica lo que corresponda según el programa.
BonusQR ofrece para ello una API REST. La caja envía el código escaneado y, si hace falta, el importe de la compra. BonusQR responde con lo que hay que hacer (aplicar un descuento porcentual o de importe, canjear un cupón o una recompensa de puntos) y con mensajes listos para el personal.
La integración es opcional y se realiza como un proyecto a medida con su proveedor de TPV. BonusQR emite las claves de API y la integración se presupuesta aparte.
Lo que recibe su caja con un solo escaneo
Un vistazo a la documentación interactiva de la API con la que su proveedor de TPV conecta su caja.
- 1
Identificar al cliente
La caja escanea el código QR de fidelización y obtiene el nombre del cliente, su número de visita y sus saldos.
- 2
Aplicar descuentos
Los descuentos porcentuales o de importe llegan como acciones que la caja aplica a la cuenta.
- 3
Canjear recompensas
Cupones, recompensas de puntos y pagos con saldo de cashback se canjean directamente en caja.
- 4
Mensajes para el personal
Cada respuesta incluye mensajes listos para el personal en el idioma de su negocio.
/api/pos/configConfiguración del programa de fidelización para la caja/api/pos/scanEscanear un código en la caja{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Lucía García",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Socios del club de fidelización"
}],
"messages": [{ 4
"level": "warning",
"title": "Descuento del 10 %",
"lines": ["Réstelo del total."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Enviar el importe o el número de artículos/api/pos/scan/{scan_id}/cancelCancelar un escaneo pendienteSu proveedor de TPV dispone de la documentación interactiva de la API y de una caja de demostración para probar la integración.
Cómo funciona la integración
Así transcurre una compra con la caja conectada.
- ClienteCajaMuestra su código QR de fidelización
- CajaBonusQREnvía el código escaneado
POST /api/pos/scan - BonusQRCajaSi hace falta, pide el importe
input_required - CajaBonusQRResponde con el importe que paga el cliente
POST /api/pos/scan/{scan_id} - BonusQRCajaDevuelve descuento, recompensas y mensajes para el personal
completed - CajaAplica el descuento y cierra la venta
- BonusQRClienteVe sellos, puntos y recompensas en la app
La integración está diseñada para que la fidelización nunca retrase un pago: si BonusQR no responde, la venta sigue adelante.
Sin integración, el personal simplemente escanea con un móvil o una tableta: BonusQR funciona por completo por sí solo.
Funciona con cualquier programa de fidelización
La API entiende todos los programas de su oferta. Por ejemplo:
Las recompensas obtenidas en caja aparecen en la app del cliente para su próxima visita.
Tarjeta de sellos: la caja envía el número de artículos
Descuento fijo: un porcentaje de la cuenta
Cashback: el saldo paga la cuenta como descuento de importe
Cupón de recompensa: se canjea al pagar
Puntos: una recompensa del catálogo canjeada en caja
Recompensa por gasto: la compra suma para el próximo cupón
REST APIPensada para el cobro real
La caja escanea en el momento del pago. Si BonusQR necesita algo más (el importe o el número de artículos), lo pide y la caja responde. Un escaneo pendiente se puede cancelar, y la venta nunca se bloquea.
- Estados claros: completado, datos requeridos, fallido
- Los escaneos pendientes se pueden cancelar
- Importes en la moneda de su negocio
- Hasta 60 solicitudes por minuto por clave
Integración TPV frente al escáner de BonusQR
Ambos funcionan. Elija lo que mejor encaje en su mostrador.
Integración con TPV
- Puesta en marcha
- Un proyecto a medida con su proveedor de TPV
- Dónde escanea el personal
- En la caja
- Descuentos
- Los aplica la caja automáticamente
- Precio
- Presupuesto aparte
Escáner de BonusQR
- Puesta en marcha
- Listo en minutos
- Dónde escanea el personal
- En un móvil, una tableta o un escáner de mostrador
- Descuentos
- Se muestran al personal, que los aplica
- Precio
- Incluido en todos los planes
Preguntas sobre la integración TPV
Lo que más preguntan los propietarios y los proveedores de TPV.
¿Necesito una integración TPV para usar BonusQR?
No. BonusQR funciona por completo por sí solo: el personal escanea los códigos de los clientes con un móvil, una tableta o un escáner de mostrador. La integración es opcional.
¿Qué sistemas TPV se pueden conectar?
Cualquier sistema cuyo proveedor pueda llamar a una API REST. BonusQR no tiene complementos listos para cajas registradoras concretas; su proveedor la conecta con nuestra documentación.
¿Cuánto cuesta la integración?
Es un proyecto a medida, así que se presupuesta aparte. Escríbanos y prepararemos una oferta junto con su proveedor de TPV.
¿Cómo obtenemos las claves de API?
BonusQR las emite bajo petición. Una clave se puede limitar a un solo local de su negocio.
¿Qué recibe la caja tras un escaneo?
El nombre del cliente, su número de visita y sus saldos, las acciones que hay que aplicar (un descuento porcentual o de importe, un cupón o una recompensa de puntos), las recompensas obtenidas y mensajes listos para el personal.
¿Y si la caja necesita más información?
BonusQR la pide (por ejemplo, el importe de la compra o el número de artículos) y la caja responde. Un escaneo pendiente también se puede cancelar.
¿Hay documentación?
Sí. Hay documentación interactiva de la API, junto con una caja de demostración que su proveedor puede usar para hacer pruebas.
¿Y las tiendas online?
Para WooCommerce y Shopify hay integraciones listas en el plan Basic.
¿Quiere la fidelización directamente en su caja?
Díganos qué TPV usa y le prepararemos una oferta para la integración.