مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

تأیید نهایی رزرو هتل

رزرو هتلِ نگه‌داشته‌شده را نهایی کنید. در این مرحله مبلغ کل کسر و رزرو تأیید می‌شود.

POST/v2/Hotel/HotelOrder

دسترسی نیازمند مجوز hotel_order

این اندپوینت را پس از اینکه مسافر مبلغ را به شما پرداخت کرد و پیش از انقضای نگه‌داشت فراخوانی کنید. مبلغ کل رزرو از موجودی دفتر شما کسر و رزرو تأیید می‌شود. اگر مهلت را از دست بدهید، نگه‌داشت آزاد می‌شود و باید نرخ را دوباره اعتبارسنجی و رزرو کنید.

دو نسخه. مسیر v1 یعنی /Hotel/HotelOrder همین عملیات را انجام می‌دهد. یکپارچه‌سازی‌های جدید باید از مسیر v2 بالا استفاده کنند.

پارامترهای مسیر#

ندارد.

پارامترهای کوئری#

ندارد.

پارامترهای بدنه#

نامنوعالزامیتوضیح
SessionIdstringالزامیشناسهٔ نشست شما.
UniqueIdstringالزامیشناسهٔ رزرو از رزرو.

درخواست#

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()

پاسخ#

فیلدنوعتوضیح
Successbooleanدر صورت موفقیت true.
UniqueIdstringشناسهٔ رزرو تأییدشده.
Statusintegerوضعیت رزرو پس از تأیید.
Errorobjectدر صورت موفقیت null.
{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 20,
  "Error": null
}
این مرحله مبلغ رزرو را کسر می‌کند. کسر از موجودی فقط اینجا انجام می‌شود، هرگز در مرحلهٔ رزرو. پیش از فراخوانی مطمئن شوید مسافر مبلغ را به شما پرداخت کرده است.

خطاها#

کدمعناراه‌حل
Err0104002رزرو هتل پیدا نشد.UniqueId را بررسی کنید.
Err0102003مهلت نگه‌داشت تمام شده و نرخ دیگر موجود نیست.نرخ را دوباره اعتبارسنجی و رزرو کنید.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.