Consumos
Registrar las compras de tus clientes para que sumen puntos, por código de cliente o por correo.
Un consumo es el registro de una compra. Es lo que dispara el cálculo de puntos: cada vez que un cliente compra, tu sistema avisa a Loybox y Loybox le suma los puntos que correspondan.
Es la integración mínima de un programa de lealtad. Si sólo vas a llamar un endpoint de toda esta API, es alguno de estos dos.
Los dos endpoints
Hacen lo mismo y se diferencian sólo en cómo identifican al cliente:
| Por código | Por correo | |
|---|---|---|
| Identifica al cliente con | Su client_code | Su correo |
| Si el cliente no existe | Devuelve 404 | Registra el consumo igual y lo invita por correo |
| Cuándo usarlo | Punto de venta o app donde el cliente da su código | Checkout online, donde ya tienes el correo |
Crear consumo por código
Cuando el cliente se identifica con su código de Loybox.
Crear consumo por correo
Cuando ya tienes el correo, aunque el cliente no esté registrado.
Cuántos puntos suma
Eso no lo decide la llamada: lo decide la configuración del comercio. Tú mandas el monto de la compra y Loybox aplica la regla de dinero por punto, los puntos dobles si están vigentes y el bono del nivel del cliente, en ese orden.
La fórmula y el orden de los multiplicadores están en Referencia técnica.
El monto va en entero
El campo amount es un integer: son unidades de la moneda del comercio, sin
decimales. Una compra de 1.750,50 se manda como 1750.
Credencial
Los dos endpoints van desde tu servidor, con la API key del comercio:
Authorization: Bearer {api-key}