# Consumos (https://docs.loybox.com.ar/api-reference/consumos)



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 [#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       |

<Cards>
  <Card title="Crear consumo por código" icon="User" description="Cuando el cliente se identifica con su código de Loybox." href="/api-reference/consumos/crear-por-codigo" />

  <Card title="Crear consumo por email" icon="Mail" description="Cuando ya tenés el email, aunque el cliente no esté registrado." href="/api-reference/consumos/crear-por-email" />
</Cards>

## Cuántos puntos suma [#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](https://docs.loybox.com.ar/referencia-tecnica#cálculo-de-puntos).

<Callout type="warn" title="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`.
</Callout>

## Credencial [#credencial]

Los dos endpoints van desde tu servidor, con la
[API key del comercio](https://docs.loybox.com.ar/api-reference/credenciales#api-key-del-comercio):

```
Authorization: Bearer {api-key}
```