STRYK, POS API
Poveži blagajnu sa STRYK-om
Troškovi restorana i bara na sobu: postavljanje, API ugovor i sigurno ponavljanje.
Učitavanje …
1Postavljanje
Provjeri podržava li dobavljač blagajne STRYK API. Vlastiti API ili OAuth zahtijeva adapter; izrada ključa ne potvrđuje kompatibilnost. U postavljanju POS-a izradi prodajno mjesto s važećim porezom i ključ ograničen na njega. GET /ping provjerava vezu; kontrolirano knjiženje na sobu provjerava upis.
2Ključevi i sigurnost
Cijeli ključ počinje s pos_live_ i dostupan je samo pri izradi. Oko mijenja vidljivost; kopiranje uvijek koristi cijelu vrijednost. Kasnije ostaje oznaka. Koristiš ga serverski putem HTTPS-a, nikada u pregledniku ili zapisnicima. Prije zamjene uskladite otvorene račune starim ključem: reference su vezane uz njega. Ne šaljite stare račune novim ključem; zatim opozovite stari.
3Račun sobe i iznosi
Provjeri gosta i sobu putem /accounts ili /room-lookup. Teretiti se mogu samo stvarno prijavljeni, još neodjavljeni boravci. Poštujte allowCharge, zabranu, limit i zatvoren račun. Šaljite bookingId i room zajedno. Pozitivna bruto cijena u valuti hotela, porez važeći na datum usluge. Količina na tri decimale, novac na dvije; chargedAt s vremenskom zonom. Nakon odjave nema API knjiženja.
4Knjiženje i ponavljanje
Svaka stavka treba trajni externalRef. Nakon isteka vremena prvo GET /charges/{externalRef}; samo nakon 404 ponovi isti zahtjev istim ključem. Točno ponavljanje vraća 201 i idempotentReplay=true; izmjena ili stornirana referenca 409. Do 50 stavki atomarno. Nakon 429 pričekajte najmanje 60 sekundi; limit je 100 zahtjeva po minuti i ključu.
5Storno i račun
DELETE /charges/{externalRef} stornira vlastitu otvorenu stavku bez dvostrukog učinka pri ponavljanju. Prenesene stavke ispravljaju se u financijama. Knjiženje na sobu nije plaćanje; pri odjavi otvorene stavke prelaze na račun. Ručne unose tijekom prekida uskladite prije API slanja.
6Webhookovi i provjera
Neobvezni webhookovi: charge.posted i charge.cancelled. Postavi zasebnu tajnu i provjeri HMAC-SHA256 na izvornom tijelu. X-STRYK-Webhook-Id označava pretplatu. Uklonite duplikate prema event i data.chargeId; redoslijed nije zajamčen. Testirajte knjiženje, ponavljanje, zabranu, limit, više soba, storno, prijenos na račun i webhookove.
