STRYK, POS API
Kasszarendszer összekötése a STRYK-kel
Éttermi és bárfogyasztás szobára terhelése: beállítás, API-szerződés és biztonságos ismétlés.
Betöltés …
1Beállítás
Egyeztesse a kassza szolgáltatójával, hogy támogatja-e a STRYK API-t. Saját API-t vagy OAuth-ot használó kasszához adapter szükséges; a kulcs létrehozása nem igazol kompatibilitást. A POS beállításában hozzon létre értékesítési pontot érvényes adóval és arra korlátozott kulcsot. A GET /ping kapcsolatot ellenőriz; az írást ellenőrzött szobaterheléssel tesztelje.
2Kulcsok és biztonság
A teljes kulcs pos_live_ kezdetű, és csak létrehozáskor érhető el. A szem csak a láthatóságot változtatja; a másolás mindig a teljes értéket másolja. Később csak az azonosító látható. HTTPS-en, szerveroldalon használja, ne böngészőkódban vagy naplóban. Kulcscsere előtt a régi kulccsal egyeztesse a függő tételeket: a referenciák kulcshoz kötöttek. Régi bizonylatot ne küldjön új kulccsal; végül vonja vissza a régit.
3Szobaszámla és összegek
Terhelés előtt ellenőrizd a vendéget és szobát: /accounts vagy /room-lookup. Csak ténylegesen bejelentkezett, még ki nem jelentkezett tartózkodás terhelhető. Vedd figyelembe az allowCharge értéket, tiltást, keretet és lezárt számlát. Küldd együtt a bookingId és room mezőt. Pozitív bruttó ár, szállodai pénznem és az adott napon beállított adó szükséges. Mennyiség három, pénz két tizedes; chargedAt időzónával. Kijelentkezés után nincs API-terhelés.
4Terhelés és ismétlés
Tételenként állandó externalRef szükséges. Időtúllépés után először GET /charges/{externalRef}; csak 404 esetén ismételje változatlan kérésként, azonos kulccsal. Azonos ismétlés: 201 és idempotentReplay=true; eltérés vagy sztornózott referencia: 409. Legfeljebb 50 tétel atomikusan. 429 után várjon legalább 60 másodpercet; kulcsonként percenként 100 kérés.
5Sztornó és számla
A DELETE /charges/{externalRef} a kapcsolat saját nyitott tételét sztornózza, ismétléskor új hatás nélkül. Számlára átadott tételt a pénzügyben kell javítani. Szobára terhelés nem fizetés; kijelentkezéskor a nyitott tételek számlára kerülnek. Üzemzavar alatti kézi rögzítés után egyeztessen az API-küldés előtt.
6Webhookok és ellenőrzés
Az opcionális webhookok: charge.posted és charge.cancelled. Külön titokkal ellenőrizze a HMAC-SHA256-aláírást a nyers törzsön. Az X-STRYK-Webhook-Id előfizetést azonosít. Az event és data.chargeId alapján szűrje az ismétléseket; a sorrend nem garantált. Átvételkor tesztelje a terhelést, ismétlést, tiltást, keretet, több szobát, sztornót, számlázást és webhookot.
