STRYK, POS API
Poveži blagajno s STRYK
Poraba v restavraciji in baru na sobo: nastavitev, pogodba API in varno ponavljanje.
Nalaganje …
1Nastavitev
Pri ponudniku blagajne preveri podporo za STRYK API. Lastni API ali OAuth zahteva adapter; ustvarjen ključ ne potrjuje združljivosti. V nastavitvah POS ustvari prodajno mesto z veljavnim davkom in nanj omejen ključ. GET /ping preveri povezavo; nadzorovano knjiženje na sobo preveri zapis.
2Ključi in varnost
Celoten ključ se začne s pos_live_ in je na voljo samo ob ustvarjanju. Oko spreminja vidnost; kopiranje vedno uporabi celotno vrednost. Pozneje ostane oznaka. Uporabljajte ga strežniško prek HTTPS, nikoli v brskalniku ali dnevnikih. Pred menjavo uskladi čakajoče račune s starim ključem: reference so vezane nanj. Starih računov ne pošiljajte z novim ključem; nato prekličite starega.
3Račun sobe in zneski
Preveri gosta in sobo prek /accounts ali /room-lookup. Knjižiti je mogoče samo dejansko prijavljena, še neodjavljena bivanja. Upoštevajte allowCharge, prepoved, limit in zaprt račun. Pošlji bookingId in room skupaj. Pozitivne bruto cene v valuti hotela, davek veljaven na dan storitve. Količina na tri decimalke, denar na dve; chargedAt s časovnim pasom. Po odjavi ni knjiženja API.
4Knjiženje in ponavljanje
Vsaka postavka potrebuje trajni externalRef. Po časovni omejitvi najprej GET /charges/{externalRef}; samo pri 404 ponovi enako zahtevo z istim ključem. Natančna ponovitev: 201 in idempotentReplay=true; sprememba ali stornirana referenca: 409. Do 50 postavk atomarno. Pri 429 počakajte vsaj 60 sekund; največ 100 zahtev na minuto na ključ.
5Storno in račun
DELETE /charges/{externalRef} stornira lastno odprto postavko brez dvojnega učinka pri ponovitvi. Prenesene postavke popravi v financah. Knjiženje na sobo ni plačilo; ob odjavi odprte postavke preidejo na račun. Ročne vnose med prekinitvijo uskladi pred pošiljanjem API.
6Webhooki in preverjanje
Izbirni webhooki: charge.posted in charge.cancelled. Nastavi ločeno skrivnost in preveri HMAC-SHA256 na izvirnem telesu. X-STRYK-Webhook-Id označuje naročnino. Odstranite dvojnike po event in data.chargeId; vrstni red ni zagotovljen. Preizkusi knjiženje, ponavljanje, prepoved, limit, več sob, storno, prenos na račun in webhooke.
