STRYK, POS API
Koppel je kassasysteem aan STRYK
Restaurant- en barverbruik op de kamer: inrichting, API-contract en veilig opnieuw proberen.
Laden …
1Inrichting
Controleer bij de kassaleverancier of de kassa de STRYK-API ondersteunt. Een eigen API of OAuth vereist een adapter; een sleutel aanmaken bewijst geen compatibiliteit. Maak bij POS-inrichting een verkooppunt met geldige belasting en een daartoe beperkte sleutel. GET /ping test de verbinding; een gecontroleerde kamerboeking test het schrijven.
2Sleutels en beveiliging
De volledige sleutel begint met pos_live_ en verschijnt alleen bij aanmaak. Het oog verandert de zichtbaarheid; Kopiëren gebruikt altijd de volledige waarde. Later blijft alleen de identificatie over. Gebruik sleutels op de server via HTTPS, nooit in browsercode of logs. Stem vóór vervanging wachtende bonnen af met de oude sleutel: referenties horen bij die sleutel. Verstuur oude bonnen nooit met een nieuwe sleutel; trek daarna de oude in.
3Kamerrekening en bedragen
Controleer gast en kamer via /accounts of /room-lookup. Alleen daadwerkelijk ingecheckte, nog niet uitgecheckte verblijven kunnen worden belast. Respecteer allowCharge, blokkades, kredietlimiet en gesloten factuurrekening. Stuur bookingId en room samen. Positieve brutoprijzen in hotelvaluta, belasting geldig op de dienstdatum. Hoeveelheid op drie decimalen, geld op twee; chargedAt met tijdzone. Geen API-boeking na uitchecken.
4Boeken en opnieuw proberen
Elke regel vereist een vaste externalRef. Na een time-out eerst GET /charges/{externalRef}; alleen bij 404 hetzelfde verzoek met dezelfde sleutel herhalen. Exacte herhaling: 201 met idempotentReplay=true; gewijzigde of geannuleerde referentie: 409. Maximaal 50 regels atomair. Wacht bij 429 minstens 60 seconden; maximaal 100 verzoeken per minuut per sleutel.
5Annulering en factuur
DELETE /charges/{externalRef} annuleert een eigen open regel zonder dubbele werking bij herhaling. Gefactureerde regels corrigeert je in Financiën. Op de kamer boeken is geen betaling; bij uitchecken gaan open regels naar de factuur. Stem handmatige invoer tijdens een storing af vóór API-verzending.
6Webhooks en acceptatie
Optionele webhooks: charge.posted en charge.cancelled. Stel een apart geheim in en controleer HMAC-SHA256 op de ongewijzigde body. X-STRYK-Webhook-Id identificeert het abonnement. Ontdubbel met event en data.chargeId; volgorde is niet gegarandeerd. Test boeken, herhalen, blokkades, limieten, meerdere kamers, annuleren, factureren en webhooks.
