تأیید نهایی رزرو هتل
رزرو هتلِ نگهداشتهشده را نهایی کنید. در این مرحله مبلغ کل کسر و رزرو تأیید میشود.
POST/v2/Hotel/HotelOrder
دسترسی نیازمند مجوز hotel_order
این اندپوینت را پس از اینکه مسافر مبلغ را به شما پرداخت کرد و پیش از انقضای نگهداشت فراخوانی کنید. مبلغ کل رزرو از موجودی دفتر شما کسر و رزرو تأیید میشود. اگر مهلت را از دست بدهید، نگهداشت آزاد میشود و باید نرخ را دوباره اعتبارسنجی و رزرو کنید.
دو نسخه.
مسیر v1 یعنی
/Hotel/HotelOrder همین عملیات را انجام میدهد. یکپارچهسازیهای جدید باید از مسیر v2 بالا استفاده کنند.
پارامترهای مسیر#
ندارد.
پارامترهای کوئری#
ندارد.
پارامترهای بدنه#
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
SessionId | string | الزامی | شناسهٔ نشست شما. |
UniqueId | string | الزامی | شناسهٔ رزرو از رزرو. |
درخواست#
curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelOrder \
-H "Content-Type: application/json" \
-d '{
"SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
"UniqueId": "HB-2026-004417"
}'const res = await fetch("https://api.simorghapi.com/api/v2/Hotel/HotelOrder", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
UniqueId: "HB-2026-004417"
})
});
const data = await res.json();import requests
res = requests.post(
"https://api.simorghapi.com/api/v2/Hotel/HotelOrder",
json={
"SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
"UniqueId": "HB-2026-004417",
},
)
data = res.json()پاسخ#
| فیلد | نوع | توضیح |
|---|---|---|
Success | boolean | در صورت موفقیت true. |
UniqueId | string | شناسهٔ رزرو تأییدشده. |
Status | integer | وضعیت رزرو پس از تأیید. |
Error | object | در صورت موفقیت null. |
{
"Success": true,
"UniqueId": "HB-2026-004417",
"Status": 20,
"Error": null
}
این مرحله مبلغ رزرو را کسر میکند.
کسر از موجودی فقط اینجا انجام میشود، هرگز در مرحلهٔ رزرو. پیش از فراخوانی مطمئن شوید مسافر مبلغ را به شما پرداخت کرده است.
خطاها#
| کد | معنا | راهحل |
|---|---|---|
Err0104002 | رزرو هتل پیدا نشد. | UniqueId را بررسی کنید. |
Err0102003 | مهلت نگهداشت تمام شده و نرخ دیگر موجود نیست. | نرخ را دوباره اعتبارسنجی و رزرو کنید. |
ویرایش این صفحه در گیتهابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.