STRYK, POS API
Connecter ta caisse à STRYK
Consommations du restaurant et du bar sur la chambre : configuration, contrat API et reprises fiables.
Chargement …
1Configuration
Vérifie avec le fournisseur que la caisse peut appeler l’API STRYK. Une caisse avec sa propre API ou OAuth nécessite un adaptateur ; créer une clé ne prouve pas la compatibilité. Dans la configuration POS, crée un point de vente avec une taxe valide et une clé limitée à celui-ci. GET /ping vérifie la connexion ; une imputation contrôlée valide l’écriture.
2Clés et sécurité
La clé complète commence par pos_live_ et n’est disponible qu’à sa création. L’œil change sa visibilité ; Copier reprend toujours la valeur complète. Ensuite, seul l’identifiant reste visible. Utilise-la côté serveur via HTTPS, jamais dans le navigateur ou les journaux. Avant rotation, rapproche les tickets en attente avec l’ancienne clé : les références lui appartiennent. Ne renvoie pas d’anciens tickets avec une nouvelle clé ; révoque ensuite l’ancienne.
3Compte chambre et montants
Vérifie le client et la chambre via /accounts ou /room-lookup. Seuls les séjours réellement enregistrés et non terminés sont imputables. Respecte allowCharge, les blocages, le plafond et la clôture du compte. Envoie bookingId et room ensemble. Prix TTC positifs en devise de l’hôtel, taxe configurée à la date de prestation. Quantité à trois décimales, argent à deux ; chargedAt avec fuseau horaire. Aucune imputation API après le départ.
4Imputation et nouvelles tentatives
Chaque ligne exige un externalRef stable. Après un délai dépassé, appelle GET /charges/{externalRef} ; uniquement sur 404, renvoie la même requête avec la même clé. Reprise identique : 201 avec idempotentReplay=true ; contenu modifié ou référence annulée : 409. Jusqu’à 50 lignes atomiques. Sur 429, attends au moins 60 secondes ; limite de 100 requêtes par minute et par clé.
5Annulation et facture
DELETE /charges/{externalRef} annule une ligne ouverte de cette connexion ; une répétition ne double pas l’effet. Une ligne transférée en facture se corrige dans Finances. Imputer une chambre n’est pas un paiement. Au départ, les lignes ouvertes passent en facture. Rapproche les saisies manuelles effectuées pendant une panne avant tout envoi API.
6Webhooks et validation
Les webhooks facultatifs signalent charge.posted et charge.cancelled. Configure un secret distinct et vérifie HMAC-SHA256 sur le corps brut. X-STRYK-Webhook-Id identifie l’abonnement. Déduplique avec event et data.chargeId ; ne présume pas l’ordre. Valide imputation, répétitions, blocages, plafond, séjour multichambre, annulation, facturation et webhooks.
