STRYK, POS API
Conectează casa de marcat la STRYK
Consumație din restaurant și bar pe cameră: configurare, contract API și reîncercări sigure.
Se încarcă …
1Configurare
Confirmă cu furnizorul casei suportul pentru API-ul STRYK. Un API propriu sau OAuth necesită un adaptor; generarea cheii nu confirmă compatibilitatea. În configurarea POS creezi un punct de vânzare cu taxă validă și o cheie limitată la el. GET /ping verifică legătura; o înregistrare controlată pe cameră verifică scrierea.
2Chei și securitate
Cheia completă începe cu pos_live_ și este disponibilă numai la creare. Ochiul schimbă vizibilitatea; copierea folosește mereu valoarea completă. Ulterior rămâne identificatorul. Folosește-o pe server prin HTTPS, niciodată în browser sau jurnale. Înainte de înlocuire reconciliați bonurile în așteptare cu cheia veche: referințele îi aparțin. Nu retrimiteți bonuri vechi cu cheia nouă; apoi revocați cheia veche.
3Contul camerei și sume
Verifică oaspetele și camera prin /accounts sau /room-lookup. Doar sejururile efectiv cazate, încă neîncheiate, pot fi debitate. Respectați allowCharge, blocarea, limita și contul închis. Trimite bookingId și room împreună. Prețuri brute pozitive în moneda hotelului, taxă configurată la data serviciului. Cantitate cu trei zecimale, bani cu două; chargedAt cu fus orar. După plecare nu se acceptă debitări API.
4Înregistrare și reîncercări
Fiecare poziție necesită externalRef permanent. După expirarea timpului apelați întâi GET /charges/{externalRef}; doar la 404 retrimiteți aceeași cerere cu aceeași cheie. Repetare exactă: 201 și idempotentReplay=true; modificare sau referință anulată: 409. Maximum 50 de poziții atomice. La 429 aștepți minimum 60 de secunde; limita este 100 de cereri pe minut și cheie.
5Anulare și factură
DELETE /charges/{externalRef} anulează o poziție proprie deschisă, fără efect dublu la repetare. Pozițiile transferate pe factură se corectează în Finanțe. Debitarea camerei nu este plată; la plecare pozițiile deschise trec pe factură. Reconciliați înregistrările manuale din timpul întreruperii înainte de trimiterea API.
6Webhookuri și verificare
Webhookuri opționale: charge.posted și charge.cancelled. Configurează un secret separat și verifici HMAC-SHA256 pe corpul original. X-STRYK-Webhook-Id identifică abonamentul. Eliminați duplicatele după event și data.chargeId; ordinea nu este garantată. Testează debitarea, repetarea, blocarea, limita, mai multe camere, anularea, facturarea și webhookurile.
