← Retour
← Retour

Intégration Myfidpass — Caisses et bornes

Documentation pour connecter Myfidpass à votre logiciel de caisse, borne de commande ou terminal.

Écosystème compatible (aperçu)

La même API s’utilise avec les caisses, bornes et outils listés ci-dessous (kits prêts, bêta, partenaires ou feuille de route). Le détail technique est identique pour tous les commerces Myfidpass.

Vous êtes commerçant ?

Vous n'avez pas besoin de faire la technique. Transmettez cette page (ou le lien ci-dessous) à la personne qui gère votre caisse ou votre borne : votre installateur, le support de votre logiciel de caisse, ou votre prestataire informatique. Ils disposeront de toute la documentation pour connecter Myfidpass à votre système.

Vous devrez leur communiquer également votre token d'accès, visible dans votre espace Myfidpass (section Intégration caisse / borne), ou dans l’URL de votre tableau de bord (?token=...).

Pour le prestataire / intégrateur

Myfidpass expose une API REST. Tout système qui peut scanner le QR code de la carte Myfidpass (Wallet ou écran) et envoyer une requête HTTP peut s’intégrer.

QR code : la valeur lue est l’identifiant unique du membre (UUID). À envoyer dans l’API sous le nom barcode.

Authentification : header X-Dashboard-Token: VOTRE_TOKEN (token fourni par le commerçant).

Endpoint principal (scan + crédit en un appel) :

POST {BASE_URL}/api/businesses/{slug}/integration/scan
Content-Type: application/json
X-Dashboard-Token: TOKEN

{"barcode": "UUID-DU-MEMBRE", "amount_eur": 12.50}

Remplacer {BASE_URL} par l’URL de l’API Myfidpass (fournie par le commerçant), {slug} par l’identifiant du commerce.

Documentation complète (endpoints lookup, erreurs, exemples) : disponible dans l'espace commerçant (section Intégration) ou sur demande. Fichier détaillé : INTEGRATION-API-BORNES-CAISSES.md.

Exemple de script (Node.js) pour tester l’intégration : fidpass-scan-example.js (dans docs/examples/).