Kortingscode
Valideert de online kortingscodes die het hotel in het beheerpaneel heeft ingesteld. Pas de korting zelf toe en stuur bij het doorsturen van de boeking de bedragen na korting mee.
Kortingscode valideren#
POST
/external/online/coupon/searchAuthenticatie: Authorization: Bearer · Body: application/x-www-form-urlencoded of multipart/form-data
Controleert of de kortingscode voor dit hotel actief, niet verlopen en beschikbaar is; geeft het kortingstype en de kortingswaarde terug.
Formuliervelden
hotelIDintegerverplichtHotel-ID.
couponstringverplichtKortingscode die de gast heeft ingevoerd.
Antwoord
200 Geslaagd.
cupon.idintegerID van de kortingscode.
cupon.changeintegerKortingstype:
0 percentage (rate is een %), 1 vast bedrag (rate in de valuta van het hotel).cupon.ratestringKortingspercentage of -bedrag.
Foutantwoorden
- 200
online_cupon_is_not_found— onbekende, inactieve of verlopen code;hotel_id_is_not_found—hotelIDontbreekt.
curl "https://test.hms.gen.tr/external/online/coupon/search" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" \
-d "coupon=ZOMER2026"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", "ZOMER2026"]
])
});
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' => 'ZOMER2026',
]),
]);
$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"
}