Fidelyo
Bientôt de retour à Lomé

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.

Écrire sur WhatsApp

Pas encore ouvert, sans date fixée. On regarde votre caisse avec vous.

Exemple : un reçu Odoo de Belle Coiffure, sur une carte à 10 tampons. Odoo est lu toutes les 5 min ; la cliente est reconnue par son numéro.

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 min

    Vous 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çu

    Vous 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 nuit

    Votre 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 envoi

    Votre 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.

Exemple : la même cliente, retrouvée par l’un des trois.

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"
}
Exemple : le reçu de Belle Coiffure, envoyé à l’API. La clé de la boutique n’est pas montrée. La réponse donne les tampons ou points ajoutés, le nouveau solde, les récompenses disponibles et une récompense surprise s’il y en a une.
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.