Consumos
Registrar las compras de tus clientes para que sumen puntos, por código de cliente o por email.
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 fidelidad. 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 email | |
|---|---|---|
| Identifica al cliente con | Su client_code | Su email |
| Si el cliente no existe | Devuelve 404 | Registra el consumo igual y lo invita por mail |
| Cuándo usarlo | Caja o app donde el cliente da su código | Checkout online, donde ya tenés el email |
Crear consumo por código
Cuando el cliente se identifica con su código de Loybox.
Crear consumo por email
Cuando ya tenés el email, aunque el cliente no esté registrado.
Cuántos puntos suma
Eso no lo decide la llamada: lo decide la configuración del comercio. Vos mandás el monto de la compra y Loybox aplica la regla de dinero por punto, los puntos dobles si están vigentes y el bonus 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}