STRYK, POS API
Prepojte pokladňu so STRYK
Útrata z reštaurácie a baru na izbu: nastavenie, zmluva API a bezpečné opakovanie.
Načítavanie …
1Nastavenie
Over u dodávateľa pokladne podporu STRYK API. Vlastné API alebo OAuth vyžaduje adaptér; vytvorenie kľúča nepotvrdzuje kompatibilitu. V nastavení POS vytvor predajné miesto s platnou daňou a kľúč obmedzený naň. GET /ping overí spojenie; kontrolované účtovanie na izbu overí zápis.
2Kľúče a bezpečnosť
Celý kľúč začína pos_live_ a je dostupný iba pri vytvorení. Oko mení viditeľnosť; kopírovanie vždy použije celú hodnotu. Neskôr ostane identifikátor. Používaj ho na serveri cez HTTPS, nikdy v prehliadači alebo logu. Pred výmenou zosúlaďte čakajúce doklady starým kľúčom: referencie patria ku kľúču. Staré doklady neposielaj novým kľúčom; potom starý zrušte.
3Účet izby a sumy
Over hosťa a izbu cez /accounts alebo /room-lookup. Účtovať možno len skutočne prihlásené, ešte neodhlásené pobyty. Rešpektuj allowCharge, zákaz, limit a uzavretý účet. Posielaj bookingId a room spolu. Kladné ceny s daňou v mene hotela, daň platná k dátumu služby. Množstvo na tri desatinné miesta, peniaze na dve; chargedAt s časovým pásmom. Po odhlásení API účtovanie nie je možné.
4Účtovanie a opakovanie
Každá položka potrebuje stály externalRef. Po časovom limiš najprv GET /charges/{externalRef}; iba pri 404 zopakuj rovnakú požiadavku rovnakým kľúčom. Presné opakovanie: 201 a idempotentReplay=true; zmena alebo stornovaná referencia: 409. Najviac 50 položiek atomicky. Pri 429 počkaj aspoň 60 sekúnd; limit 100 požiadaviek za minútu na kľúč.
5Storno a faktúra
Deleš /charges/{externalRef} stornuje vlastnú otvorenú položku bez opakovaného účinku. Položky prenesené na faktúru opravuj vo financiách. Účtovanie na izbu nie je platba; pri odhlásení otvorené položky prejdú na faktúru. Ručné zápisy počas výpadku zosúlaďte pred API odoslaním.
6Webhooky a overenie
Voliteľné webhooky: charge.posted a charge.cancelled. Nastav samostatné tajomstvo a overuj HMAC-SHA256 nad pôvodným telom. X-STRYK-Webhook-Id označuje odber. Deduplikuj podľa event a data.chargeId; poradie nie je zaručené. Otestuj účtovanie, opakovanie, zákaz, limit, viac izieb, storno, fakturáciu a webhooky.
