Conceptos fundamentales
Esta página explica las ideas clave en las que se basa Spraed. No es necesario leerla antes de empezar, pero te ayudará a entender los términos y comportamientos que encontrarás en toda la plataforma.
Cuentas
Cada participante en un programa Spraed tiene una cuenta. La cuenta contiene su saldo actual, el historial de transacciones y la membresía al programa. Existen tres tipos de cuenta, uno por rol:
- Cuenta Individual — la cuenta del consumidor. Registra los beneficios obtenidos, el saldo disponible y el saldo pending.
- Cuenta Business — la cuenta del gestor del programa. Registra el total del saldo loyalty en circulación entre todos los miembros.
- Cuenta Merchant — la cuenta de un merchant dentro de una coalition. Registra los beneficios emitidos, los cargos pendientes y los reembolsos debidos.
Cuando se produce una transacción, Spraed crea un asiento contable en cada una de las cuentas afectadas de forma simultánea.
La tarjeta digital
Cada Individual tiene una tarjeta digital — un código QR mostrado en la app Spraed en la sección "Tu tarjeta". El código QR es dinámico: se genera en el momento en que se abre la página y codifica un token temporal vinculado a la identidad del miembro.
Para procesar una transacción, el Business o el Merchant escanea el código QR del miembro e introduce el importe de la compra. El enfoque con código QR significa que no se necesita tarjeta física, ni hardware NFC, ni lector de tarjetas — solo dos smartphones.
Tipos de programa
Spraed soporta actualmente tres tipos de programa completamente operativos, con más en desarrollo. Consulta Tipos de programa para una visión completa.
Transacciones
Una transacción en Spraed es cualquier evento que modifica un saldo de cuenta. Cuando un miembro realiza una compra:
- El merchant escanea la tarjeta digital del miembro e introduce el importe
- La app Spraed envía la transacción al API gateway
- El gateway crea asientos contables en todas las cuentas afectadas (miembro, business, merchant)
- Se inicia un evento de settlement, procesado en cuestión de segundos
- El miembro recibe una notificación push confirmando el beneficio obtenido
Todo el flujo — desde el escaneo del código QR hasta la notificación — se completa normalmente en pocos segundos.
Settlement
El settlement es el proceso de resolución de las obligaciones financieras creadas por una transacción.
En un programa Single Brand, el settlement es inmediato e interno. No hay pagos entre las partes.
En un programa Coalition, el settlement implica movimientos de dinero reales entre entidades independientes:
- El merchant emisor (donde el miembro compró) recibe un cargo por el importe del beneficio más las comisiones, que se acreditan en la cuenta moneda del Business
- El beneficio del miembro pasa de pending a disponible una vez confirmado el cargo
- El merchant que acepta el canje recibe un reembolso del Business mediante transferencia bancaria o compensación
La cuenta moneda es el float de settlement del Business — recibe las contribuciones de los merchants y paga los canjes.
Saldo loyalty
Tu saldo loyalty es el valor total de los beneficios actualmente en circulación — todo lo que has prometido a los miembros y que aún no ha sido canjeado. Puedes verlo como tu exposición loyalty. Spraed lo muestra de forma destacada en tu dashboard para que siempre tengas controlada tu posición.
En una coalition, cada merchant también tiene su propio saldo que muestra lo que ha emitido y lo que está actualmente pendiente de settlement.
Incorporación de miembros
Incorporar un nuevo miembro no requiere ningún trabajo manual. Cuando se activa un programa, Spraed genera un cartel imprimible en formato A5 con un código QR único para ese programa. El cliente lo escanea, descarga la app Spraed, crea una cuenta (usuario, contraseña o passkey) y queda inmediatamente inscrito. Todo el proceso lleva menos de un minuto.
Una única cuenta Spraed puede estar inscrita en múltiples programas — la app incluye un program switcher para moverse entre ellos.
Integración API
Para los businesses que necesitan una integración más profunda — conectar Spraed a un sistema de caja existente, un ERP o una plataforma de e-commerce — Spraed pone a disposición una REST API a través de un API gateway dedicado. La API cubre identidades, programas, cuentas, transacciones, promociones y mucho más.
Consulta la documentación API para más detalles.