Ventes

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 de la campagne affichent son revenu.

Déclarer une vente

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 :

{
    "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 :

celui qui a reçu le plus de clics ;
à é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

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.

L'API

Recettes

Intégrations

Déclarer une vente

Comment la vente est attribuée

Remboursement

Bonnes pratiques

​Déclarer une vente

​Comment la vente est attribuée

​Remboursement

​Bonnes pratiques

Déclarer une vente

Comment la vente est attribuée

Remboursement

Bonnes pratiques