STRYK, POS API
Propojte pokladnu se STRYK
Útrata z restaurace a baru na pokoj: nastavení, smlouva API a bezpečné opakování.
Načítání …
1Nastavení
Ověř u dodavatele pokladny podporu STRYK API. Vlastní API nebo OAuth vyžaduje adaptér; vytvoření klíče nepotvrzuje kompatibilitu. V nastavení POS vytvoř prodejní místo s platnou daní a klíč omezený na něj. GET /ping ověřuje spojení; kontrolované účtování na pokoj ověří zápis.
2Klíče a zabezpečení
Celý klíč začíná pos_live_ a je dostupný pouze při vytvoření. Oko mění viditelnost; kopírování vždy použije celou hodnotu. Později zůstane identifikátor. Používej jej na serveru přes HTTPS, nikdy v prohlížeči nebo logu. Před výměnou srovnej čekající doklady starým klíčem: reference patří ke klíči. Staré doklady neposílej pod novým klíčem; starý pak zneplatněte.
3Účet pokoje a částky
Ověř hosta a pokoj přes /accounts nebo /room-lookup. Účtovat lze jen skutečně přihlášené, dosud neodhlášené pobyty. Respektuj allowCharge, zákaz, úvěrový limit a uzavřený účet. Posílej bookingId a room společně. Kladné ceny včetně daně v měně hotelu; daň platná k datu služby. Množství tři desetinná místa, peníze dvě; chargedAt s časovým pásmem. Po odhlášení API účtování nelze.
4Účtování a opakování
Každá položka potřebuje stálý externalRef. Po timeoutu nejprve GET /charges/{externalRef}; jen při 404 opakuj stejný požadavek se stejným klíčem. Přesné opakování: 201 a idempotentReplay=true; změna nebo stornovaná reference: 409. Nejvýše 50 položek atomicky. Při 429 počkej alespoň 60 sekund; limit 100 požadavků za minutu na klíč.
5Storno a faktura
Deleš /charges/{externalRef} stornuje vlastní otevřenou položku bez opakovaného účinku. Položky převedené na fakturu opravuj ve financích. Účtování na pokoj není platba; při odhlášení přejdou otevřené položky na fakturu. Ruční zadání během výpadku srovnej před API odesláním.
6Webhooky a ověření
Volitelné webhooky: charge.posted a charge.cancelled. Nastav samostatné tajemství a ověřuj HMAC-SHA256 nad původním tělem. X-STRYK-Webhook-Id označuje odběr. Deduplikuj podle event a data.chargeId; pořadí není zaručeno. Otestuj účtování, opakování, zákaz, limit, více pokojů, storno, fakturaci a webhooky.
