API caisse — INDEV Fidélité

Authentification

Créez une clé depuis votre interface staff (onglet ✉️ Campagnes → Intégration caisse), puis envoyez-la dans l'en-tête de chaque requête :

Authorization: Bearer fid_votre_cle_api

Limite : 60 requêtes/minute par clé. La clé est liée à votre commerce (et à votre enseigne si vous êtes en multi-établissements).

1. Rechercher un client

GET https://fidelite.vision2jeunes.fr/api/v1/clients?identifiant=IDENTIFIANT_DU_QR
GET https://fidelite.vision2jeunes.fr/api/v1/clients?telephone=0612345678

→ 200
{
  "clients": [{
    "identifiant": "fWq_bo12vUzdm1oj",
    "nom": "Marie Dupont",
    "telephone": "0612345678",
    "points": 7,
    "seuil_recompense": 10,
    "recompense_disponible": false
  }]
}

L'identifiant est le contenu du QR code scanné sur la carte Wallet du client.

2. Ajouter les points d'un achat

POST https://fidelite.vision2jeunes.fr/api/v1/points
Content-Type: application/json

{ "identifiant": "fWq_bo12vUzdm1oj", "montant": 12.50 }

→ 200  { "client": { …, "points": 19 }, "points_ajoutes": 12 }
→ 429  { "erreur": "Des points ont déjà été ajoutés il y a moins de 5 min…",
         "code": "ANTI_FRAUDE", "retry_dans_secondes": 240 }

Mêmes règles que la caisse : calcul par euro, anti-fraude, mise à jour automatique des passes Google/Apple Wallet et notifications e-mail.

3. Valider une récompense

POST https://fidelite.vision2jeunes.fr/api/v1/recompense
Content-Type: application/json

{ "identifiant": "fWq_bo12vUzdm1oj" }

→ 200  { "client": { …, "points": 0 }, "libelle_recompense": "-10% sur votre prochain achat" }
→ 400  { "erreur": "Seuil non atteint (7/10 points)", "code": "SEUIL_NON_ATTEINT" }

Codes d'erreur

• 401 — clé absente, invalide ou révoquée
• 404 — client inconnu pour ce commerce
• 429 — anti-fraude ou limite de débit
• 400 — paramètres invalides