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
Cajero en el TPV de una cafetería y una clienta con un código QR de fidelización
TPVahora

Tarjeta de fidelización escaneada: descuento del 10 % aplicado

La caja lee el código de fidelización y aplica ella misma el resultado.

¿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. 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. 2

    Aplicar descuentos

    Los descuentos porcentuales o de importe llegan como acciones que la caja aplica a la cuenta.

  3. 3

    Canjear recompensas

    Cupones, recompensas de puntos y pagos con saldo de cashback se canjean directamente en caja.

  4. 4

    Mensajes para el personal

    Cada respuesta incluye mensajes listos para el personal en el idioma de su negocio.

BonusQR APIOAS 3.0
POSEscanee el código de un cliente en la caja y reciba lo que debe hacer el TPV.
GET/api/pos/configConfiguración del programa de fidelización para la caja
POST/api/pos/scanEscanear un código en la caja
Request body application/json
{ "code": "12345", "bill_amount": 12.50 }
Responses
200completedinput_requiredvoucher3failed
{
  "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": []
}
POST/api/pos/scan/{scan_id}Enviar el importe o el número de artículos
POST/api/pos/scan/{scan_id}/cancelCancelar un escaneo pendiente

Su 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.

ClienteCajaBonusQR
  1. ClienteCajaMuestra su código QR de fidelización
  2. CajaBonusQREnvía el código escaneadoPOST /api/pos/scan
  3. BonusQRCajaSi hace falta, pide el importeinput_required
  4. CajaBonusQRResponde con el importe que paga el clientePOST /api/pos/scan/{scan_id}
  5. BonusQRCajaDevuelve descuento, recompensas y mensajes para el personalcompleted
  6. CajaAplica el descuento y cierra la venta
  7. 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.

Cafeteríaahora

Tarjeta de sellos: la caja envía el número de artículos

Peluqueríaahora

Descuento fijo: un porcentaje de la cuenta

Restauranteahora

Cashback: el saldo paga la cuenta como descuento de importe

Panaderíaahora

Cupón de recompensa: se canjea al pagar

Gimnasioahora

Puntos: una recompensa del catálogo canjeada en caja

Tiendaahora

Recompensa por gasto: la compra suma para el próximo cupón

Pantalla táctil de un TPV y lector QR leyendo el código de fidelización de un clienteREST API

Pensada 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
vs.

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.