Les reçus de votre caisse remplissent la carte.
Odoo, Loyverse ou une autre caisse : Fidelyo reçoit vos reçus et donne leurs tampons ou points à vos clients. Pour cela, votre équipe encaisse comme avant et indique le client sur le reçu.
Pas encore ouvert, sans date fixée. On regarde votre caisse avec vous.
Quatre façons de relier votre caisse
Une boutique ou plusieurs : chaque boutique de votre caisse est reliée à sa boutique Fidelyo.
Odoo
Toutes les 5 minVous donnez l’adresse de votre Odoo, sa base et une clé en lecture seule : les reçus payés sont lus toutes les 5 min. Une récompense se valide sur l’écran Fidelyo du comptoir, puis la remise se fait dans Odoo.
Loyverse
À chaque reçuVous reliez votre compte Loyverse : chaque reçu et chaque retour est enregistré dès que Loyverse l’envoie à Fidelyo. Vous coupez les points de Loyverse, pour ne pas compter deux fois.
Un fichier CSV
Chaque nuitVotre caisse dépose un fichier CSV des reçus par SFTP, ou vous l’importez dans Fidelyo. Un message WhatsApp vous dit combien de lignes sont refusées ; le rapport donne la raison de chaque refus.
L’API
À chaque envoiVotre logiciel envoie les reçus et les retours, retrouve un client et utilise une récompense. Pour toute autre caisse.
Le bon client, sans deviner
Un client est reconnu par son numéro, sa carte Fidelyo ou le numéro de votre propre carte de fidélité, si vous en avez une. Un reçu sans client reconnu ne donne ni tampon ni point. Si le numéro et la carte désignent deux clients, Fidelyo ne choisit pas : le reçu attend dans « À traiter » et vous l’attribuez.
Ce qui protège vos reçus
- Un reçu envoyé deux fois ne compte qu’une fois.
- Un retour reprend ce que ses lignes avaient donné. Sans sa vente d’origine après 7 jours, il est refusé et rien n’est retiré.
- Alerte WhatsApp si Odoo ne répond plus depuis 15 min, si Loyverse reste muet 2 h pendant vos heures d’ouverture, ou si le fichier SFTP manque à 6 h, heure de Lomé.
- Une alerte par incident, puis un message quand tout fonctionne à nouveau.
- Les reçus à traiter vous attendent dans une seule liste.
Pour la personne qui gère votre caisse
Une API REST en JSON sur HTTPS :
https://api.fidelyo.co/v1
Chaque reçu passe par le même enregistrement que le comptoir et suit les règles de votre programme.
- Une clé par boutique, avec ses droits : lire les clients, écrire les reçus, utiliser une récompense, exporter. Affichée une seule fois, révocable à tout moment.
- Chaque reçu et chaque récompense utilisée porte un external_id et ne s’applique qu’une fois. Même external_id, contenu différent : 409 duplicate_receipt.
- Numéro et carte de deux clients différents : 202, statut identity_conflict, 0 point. Le reçu est enregistré : ne le renvoyez pas.
- Webhooks vers votre logiciel, signés par X-Fidelyo-Signature : customer.created, points.changed, reward.reached, redemption.created, tier.changed, membership.changed. Nouveaux essais pendant 24 h.
- 20 requêtes par seconde par clé ; au-delà, 429 avec un délai. Chaque erreur a un code stable et un message en français et en anglais.
- Fichier CSV, une ligne par ligne de reçu : shop_code, receipt_id, closed_at, customer_phone, customer_card, total_fcfa, sku, product_name, category, quantity, line_total, type (sale ou return).
- Chaque appel est journalisé ; vous voyez les 30 derniers jours.
- Pas encore de documentation publique : écrivez-nous pour en parler.
POST /receipts
{
"shop": "BELLE-BE",
"external_id": "POS-000123",
"closed_at": "2026-11-09T10:42Z",
"customer": {
"phone": "+22890124521"
},
"total_fcfa": 15000,
"lines": [
{
"sku": "TRS-01",
"name": "Tresses",
"category": "Coiffure",
"quantity": 1,
"line_total": 15000
}
],
"payment_method": "cash"
}
- Reçus et retours
- POST /receipts, POST /receipts/{external_id}/return.
- Clients
- GET /customers/lookup (phone ou card), POST /customers, PATCH /customers/{id}.
- Récompenses
- GET /customers/{id}/rewards, POST /redemptions, POST /redemptions/{id}/cancel sous 24 h.
- Catalogue, fichiers, exports
- PUT /products, POST /imports, GET /imports/{id}, GET /exports/customers, /ledger et /receipts, paginés, en JSON ou CSV.
Votre caisse, reliée à Fidelyo ?
Dites-nous quelle caisse vous utilisez, pour une boutique ou plusieurs. On regarde avec vous comment ça marchera chez vous.
