Clés & jumelage

Clés

Chaque caisse a sa propre clé : fk_live_ suivi de 40 caractères (fk_test_ dans le bac à sable). Envoyez-la à chaque requête :

Authorization: Bearer fk_live_...

Une clé appartient à un commerce et agit comme cette caisse : l’historique du commerce affiche son nom sur chaque tampon et paiement.
Fidelia ne conserve qu’une empreinte de la clé. Si elle est perdue, reconnectez la caisse.
Le commerce peut déconnecter une caisse à tout moment (Fidelia → Caisses & POS). Sa clé répond alors 401 invalid_key.
Conservez la clé comme un mot de passe : chiffrée sur la caisse, jamais dans des journaux ou sur des tickets.

Jumelage (recommandé)

Le caissier ne voit jamais de clé. Votre logiciel affiche un code ; le commerçant le tape dans Fidelia.

Démarrer : aucune clé nécessaire.

curl -X POST https://api.fidelia.se/pos/v1/pairing \
  -H "Content-Type: application/json" \
  -d '{ "device_name": "Caisse 1", "partner_id": "pt_..." }'

{ "pairing_id": "806a7164-…", "code": "760978", "poll_secret": "fp_...", "expires_at": "…" }

Affichez le code sur l’écran de la caisse : « Ouvrez Fidelia → Caisses & POS et tapez 760 978 ». Le commerçant voit le nom de votre appareil et votre société (grâce à partner_id), choisit un nom et un établissement, et connecte la caisse.
Interrogez toutes les 3 secondes avec le secret :

curl https://api.fidelia.se/pos/v1/pairing/806a7164-… \
  -H "Authorization: Pairing fp_..."

Statut	Signification
`202` `{ "status": "pending" }`	Pas encore saisi : continuez.
`200` `{ "status": "approved", "key": "fk_live_...", "shop": { … } }`	Enregistrez la clé. Elle n’est remise qu’une fois.
`410 pairing_expired`	Les 10 minutes sont écoulées : recommencez.

Appelez ensuite GET /me avec la nouvelle clé pour charger les cartes et réglages du commerce.

Identifiant partenaire

Votre partner_id (pt_ + 24 caractères) accompagne votre bac à sable. Envoyez-le lors du jumelage : la caisse et le commerce sont alors liés à votre société (accords de parrainage, support).

Sans jumelage

Un développeur qui configure un seul commerce à la main peut demander une clé au commerçant : Fidelia → Caisses & POS → Clé API pour un développeur. Elle n’est affichée qu’une fois.