Mã giảm giá
Kiểm tra các mã giảm giá trực tuyến mà khách sạn đã tạo trong bảng quản trị. Hãy tự áp dụng mức giảm ở phía bạn và gửi các số tiền đã giảm khi gửi đặt phòng.
Kiểm tra mã giảm giá#
POST
/external/online/coupon/searchXác thực: Authorization: Bearer · Nội dung: application/x-www-form-urlencoded hoặc multipart/form-data
Kiểm tra mã giảm giá có đang hoạt động, còn hạn và dùng được cho khách sạn này hay không; trả về loại và mức giảm giá.
Trường form
hotelIDintegerbắt buộcID khách sạn.
couponstringbắt buộcMã giảm giá do khách nhập.
Phản hồi
200 Thành công.
cupon.idintegerID mã giảm giá.
cupon.changeintegerLoại giảm giá:
0 theo phần trăm (rate là %), 1 số tiền cố định (rate tính theo đơn vị tiền tệ của khách sạn).cupon.ratestringTỷ lệ hoặc số tiền giảm.
Phản hồi lỗi
- 200
online_cupon_is_not_found— mã không tồn tại, không hoạt động hoặc đã hết hạn;hotel_id_is_not_found— thiếuhotelID.
curl "https://test.hms.gen.tr/external/online/coupon/search" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" \
-d "coupon=MUAHE2026"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", "MUAHE2026"]
])
});
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' => 'MUAHE2026',
]),
]);
$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"
}