لغو رزرو هتل

ابتدا جریمهٔ لغو را ببینید، سپس رزرو را لغو کنید.

لغو در دو مرحله انجام می‌شود: اول پیش‌نمایش لغو را بگیرید تا جریمه را ببینید، بعد لغو کنید. هر دو مرحله UniqueId رزرو را می‌گیرند.

پیش‌نمایش لغو#

POST/v2/Hotel/HotelCancelDisplay

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

پیش از نهایی کردن، قوانین لغو و جریمهٔ احتمالی را بخوانید.

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

نام	نوع	الزامی	توضیح
`SessionId`	string	الزامی	شناسهٔ نشست شما.
`UniqueId`	string	الزامی	شناسهٔ رزرو.

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelCancelDisplay \
  -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/HotelCancelDisplay", {
  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/HotelCancelDisplay",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "HB-2026-004417",
    },
)

data = res.json()

پاسخ#

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "CancellationCharge": 0.00,
  "Currency": "USD",
  "RefundAmount": 148.00,
  "Error": null
}

لغو#

POST/v2/Hotel/HotelCancel

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

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

نام	نوع	الزامی	پیش‌فرض	توضیح
`SessionId`	string	الزامی	-	شناسهٔ نشست شما.
`UniqueId`	string	الزامی	-	شناسهٔ رزرو.
`CancelActor`	integer	اختیاری	`0`	چه کسی لغو را درخواست کرده است.
`RefundPaymentMode`	integer	اختیاری	`0`	روش بازپرداخت مبلغ استرداد.
`HasAnyCanceledUser`	boolean	اختیاری	`false`	آیا پیش‌تر مهمانی لغو شده است.

POST /api/v2/Hotel/HotelCancel
{
  "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
  "UniqueId": "HB-2026-004417"
}

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 30,
  "RefundAmount": 148.00,
  "Currency": "USD",
  "Error": null
}

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

خطاها#

کد	معنا	راه‌حل
`Err0104002`	رزرو هتل پیدا نشد.	`UniqueId` را بررسی کنید.

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