قسيمة الخصم
تتحقق من قسائم الخصم الإلكترونية التي عرّفها الفندق في لوحة التحكم. طبّق الخصم من جهتك وأرسل المبالغ بعد الخصم عند إرسال الحجز.
التحقق من قسيمة#
POST
/external/online/coupon/searchالمصادقة: Authorization: Bearer · المتن: application/x-www-form-urlencoded أو multipart/form-data
تتحقق من أن رمز القسيمة نشط وغير منتهي الصلاحية ومتاح للاستخدام في هذا الفندق، وتعيد نوع الخصم ونسبته.
حقول النموذج
hotelIDintegerإلزاميمعرّف الفندق.
couponstringإلزاميرمز القسيمة الذي أدخله النزيل.
الاستجابة
200 نجاح.
cupon.idintegerمعرّف القسيمة.
cupon.changeintegerنوع الخصم:
0 نسبة مئوية (rate قيمة %)، 1 مبلغ ثابت (rate بعملة الفندق).cupon.ratestringنسبة الخصم أو مبلغه.
استجابات الأخطاء
- 200
online_cupon_is_not_found— رمز غير معروف أو غير نشط أو منتهي الصلاحية؛hotel_id_is_not_found—hotelIDمفقود.
curl "https://test.hms.gen.tr/external/online/coupon/search" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" \
-d "coupon=SUMMER2026"const res = await fetch("https://test.hms.gen.tr/external/online/coupon/search", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.HMS_TOKEN}`
},
body: new URLSearchParams([
["hotelID", "1000"],
["coupon", "SUMMER2026"]
])
});
const data = await res.json();$ch = curl_init('https://test.hms.gen.tr/external/online/coupon/search');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('HMS_TOKEN'),
],
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query([
'hotelID' => '1000',
'coupon' => 'SUMMER2026',
]),
]);
$data = json_decode(curl_exec($ch), true);{
"success": true,
"cupon": {
"id": 12,
"change": 0,
"rate": "10.00"
}
}{
"success": false,
"message": "online_cupon_is_not_found"
}