STRYK, POS API
Połącz kasę ze STRYK
Obciążenia pokoju z restauracji i baru: konfiguracja, kontrakt API i bezpieczne ponawianie.
Wczytywanie …
1Konfiguracja
Potwierdź u dostawcy kasy obsługę API STRYK. Własne API lub OAuth wymaga adaptera; utworzenie klucza nie potwierdza zgodności. W konfiguracji POS utwórz punkt sprzedaży z właściwym podatkiem i ograniczony do niego klucz. GET /ping sprawdza połączenie; kontrolowane obciążenie pokoju potwierdza zapis.
2Klucze i bezpieczeństwo
Pełny klucz zaczyna się od pos_live_ i jest dostępny tylko przy tworzeniu. Oko zmienia widoczność; kopiowanie zawsze pobiera całą wartość. Później pozostaje identyfikator. Używaj klucza po stronie serwera przez HTTPS, nigdy w przeglądarce ani logach. Przed wymianą uzgodnij oczekujące paragony starym kluczem: referencje należą do niego. Nie wysyłaj starych paragonów nowym kluczem; następnie unieważnij stary.
3Rachunek pokoju i kwoty
Sprawdź gościa i pokój przez /accounts lub /room-lookup. Obciążenia dotyczą tylko faktycznie zameldowanych, jeszcze niewymeldowanych pobytów. Uwzględnij allowCharge, blokadę, limit i zamknięty rachunek. Wysyłaj bookingId i room razem. Dodatnie ceny brutto w walucie hotelu, podatek obowiązujący w dniu usługi. Ilość do trzech miejsc, pieniądze do dwóch; chargedAt ze strefą czasową. Po wymeldowaniu API nie przyjmuje obciążeń.
4Księgowanie i ponawianie
Każda pozycja wymaga stałego externalRef. Po przekroczeniu czasu najpierw GET /charges/{externalRef}; tylko przy 404 powtórz identyczne żądanie tym samym kluczem. Dokładne powtórzenie: 201 i idempotentReplay=true; zmiana lub anulowana referencja: 409. Do 50 pozycji atomowo. Przy 429 odczekaj minimum 60 sekund; limit 100 żądań na minutę i klucz.
5Anulowanie i faktura
DELETE /charges/{externalRef} anuluje własną otwartą pozycję bez podwójnego skutku przy powtórzeniu. Pozycje przeniesione na fakturę koryguj w Finansach. Obciążenie pokoju nie jest płatnością; przy wymeldowaniu otwarte pozycje trafiają na fakturę. Uzgodnij wpisy ręczne z czasu awarii przed wysłaniem przez API.
6Webhooki i odbiór
Opcjonalne webhooki: charge.posted i charge.cancelled. Ustaw osobny sekret i weryfikuj HMAC-SHA256 na surowej treści. X-STRYK-Webhook-Id identyfikuje subskrypcję. Usuwaj duplikaty według event i data.chargeId; kolejność nie jest gwarantowana. Sprawdź obciążenie, ponowienia, blokadę, limit, wiele pokoi, anulowanie, fakturę i webhooki.
