> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lekalao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ventes

> Déclarer ce que vos e-mails rapportent, pour voir le revenu de chaque campagne.

Quand un client achète, votre boutique le dit à Lekalao. Lekalao attribue la vente au dernier e-mail qui a pu la provoquer, et les [statistiques](/fr/campaigns/statistics) de la campagne affichent son revenu.

## Déclarer une vente

```bash theme={null}
curl -X POST https://lekalao.example.com/api/v1/conversions \
  -H "Authorization: Bearer $LEKALAO_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "ada@example.com",
    "amount": 12500,
    "currency": "XAF",
    "reference": "commande-2026-00481",
    "occurred_at": "2026-09-17T10:14:00+01:00",
    "meta": { "canal": "boutique-en-ligne" }
  }'
```

| Champ         |                                                                                               |
| ------------- | --------------------------------------------------------------------------------------------- |
| `email`       | L'acheteur. Obligatoire.                                                                      |
| `list`        | Uuid d'une liste, si la même adresse est sur plusieurs. Sinon, l'inscription la plus récente. |
| `amount`      | Entier, dans la plus petite unité : `1250` = 12,50 €, `12500` = 12 500 FCFA.                  |
| `currency`    | Code à trois lettres : `XAF`, `EUR`, `USD`…                                                   |
| `reference`   | Votre numéro de commande. **Une même référence ne compte qu'une fois.**                       |
| `occurred_at` | Quand la vente a eu lieu. Maintenant, par défaut.                                             |
| `meta`        | Objet libre, gardé tel quel.                                                                  |

Réponse :

```json theme={null}
{
    "data": {
        "id": "a7f2…",
        "amount": 12500,
        "currency": "XAF",
        "reference": "commande-2026-00481",
        "campaign": "0c9e3f5a-…",
        "attributed": true,
        "occurred_at": "2026-09-17T09:14:00+00:00"
    }
}
```

`201` pour une vente nouvelle ; `200` quand la `reference` existait déjà et que la vente a été mise à jour. `404` si l'adresse n'est sur aucune liste.

## Comment la vente est attribuée

Lekalao cherche, parmi les e-mails envoyés à cette personne **dans les 14 jours avant la vente** (durée réglable par l'installation) et qu'elle a **ouverts ou cliqués** :

1. celui qui a reçu le plus de clics ;
2. à égalité, le plus récent.

Campagnes et e-mails d'automatisation sont pris en compte, variante d'A/B test comprise. Sans e-mail qui corresponde, la vente est enregistrée avec `"attributed": false` et ne compte pour aucune campagne.

## Remboursement

```bash theme={null}
curl -X DELETE https://lekalao.example.com/api/v1/conversions/a7f2… \
  -H "Authorization: Bearer $LEKALAO_TOKEN" -H "Accept: application/json"
```

La vente disparaît des chiffres. Pour un remboursement partiel, redéclarez la même `reference` avec le nouveau montant.

## Bonnes pratiques

* Déclarez la vente **une fois payée**, depuis le serveur, pas depuis la page de remerciement que le client peut recharger.
* Envoyez **toujours** une `reference` : les renvois et doublons ne gonflent rien.
* Gardez une seule devise par équipe si vous voulez des totaux lisibles.