STRYK, POS API
Підключи касову систему до STRYK
Витрати ресторану й бару на номер: налаштування, контракт API та безпечні повтори.
Завантаження …
1Налаштування
Уточни у постачальника, чи підтримує каса API STRYK. Власний API або OAuth потребує адаптера; створення ключа не підтверджує сумісність. У налаштуваннях POS створи точку продажу з чинним податком і обмежений нею ключ. GET /ping перевіряє зв’язок; контрольоване нарахування на номер перевіряє запис.
2Ключі та безпека
Повний ключ починається з pos_live_ і доступний лише під час створення. Око змінює видимість; копіювання завжди бере повне значення. Пізніше залишається ідентифікатор. Використовуй ключ на сервері через HTTPS, ніколи в браузері чи журналах. Перед заміною звірте незавершені чеки старим ключем: посилання належать йому. Не надсилай старі чеки новим ключем; потім відкличте старий.
3Рахунок номера й суми
Перевір гостя й номер через /accounts або /room-lookup. Нарахування можливе лише для фактично заселених, ще не виселених гостей. Дотримуйтеся allowCharge, заборони, ліміту та закритого рахунку. Надсилай bookingId і room разом. Додатні ціни з податком у валюті готелю, податок чинний на дату послуги. Кількість до трьох знаків, гроші до двох; chargedAt із часовим поясом. Після виїзду API-нарахування неможливе.
4Нарахування та повтори
Кожна позиція потребує постійного externalRef. Після тайм-ауту спершу GET /charges/{externalRef}; лише за 404 повтори незмінний запит тим самим ключем. Точний повтор: 201 та idempotentReplay=true; зміна або скасоване посилання: 409. До 50 позицій атомарно. За 429 зачекай щонайменше 60 секунд; ліміт 100 запитів на хвилину на ключ.
5Скасування та рахунок
DELETE /charges/{externalRef} скасовує власну відкриту позицію без подвійного ефекту повторення. Перенесені до рахунку позиції виправляй у Фінансах. Нарахування на номер не є оплатою; під час виїзду відкриті позиції переходять до рахунку. Звірте ручні записи під час збою перед надсиланням API.
6Вебхуки та перевірка
Необов’язкові вебхуки: charge.posted і charge.cancelled. Налаштуй окремий секрет і перевіряй HMAC-SHA256 за оригінальним тілом. X-STRYK-Webhook-Id позначає підписку. Усуньте дублікати за event і data.chargeId; порядок не гарантований. Перевір нарахування, повтори, заборону, ліміт, кілька номерів, скасування, рахунок і вебхуки.
