استرداد بلیت پرواز

اول شرایط استرداد بلیت صادرشده را پیش‌نمایش کنید و بعد استرداد را اجرا کنید.

استرداد دو مرحله دارد. ابتدا پیش‌نمایش استرداد را بگیرید تا جریمهٔ هر بلیت را ببینید. سپس استرداد را برای بلیت‌هایی که می‌خواهید برگردانید اجرا کنید. هر دو مرحله UniqueId رزرو را می‌گیرند.

پیش‌نمایش استرداد#

POST/Air/AirRefundDisplay

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

پیش از قطعی‌کردن استرداد، جریمه و قابل‌استرداد بودن هر بلیت الکترونیکی را بخوانید.

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

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

curl -X POST https://api.simorghapi.com/api/Air/AirRefundDisplay \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "TP-2026-000512"
  }'

const res = await fetch("https://api.simorghapi.com/api/Air/AirRefundDisplay", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "TP-2026-000512"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.simorghapi.com/api/Air/AirRefundDisplay",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "TP-2026-000512",
    },
)

data = res.json()

پاسخ#

فیلد	نوع	توضیح
`Success`	boolean	در صورت موفقیت `true`.
`RefundType`	integer	کد روش استرداد.
`EticketNumbers`	array of object	برای هر بلیت الکترونیکی یک مورد. جزئیات در ادامه.
`Error`	object	در صورت موفقیت `null`.

EticketNumbers[] object

فیلد	نوع	توضیح
`ETicketNumber`	string	شمارهٔ بلیت الکترونیکی.
`EticketStatus`	string	وضعیت فعلی بلیت.
`IsRefunded`	boolean	آیا قبلاً مسترد شده است.
`PenaltyAmount`	number	جریمه‌ای که از مبلغ استرداد کسر می‌شود.
`IsNonRefundable`	boolean	اگر بلیت قابل استرداد نباشد `true`.
`Route`	string	مسیر بلیت.
`AirlinePnr`	string	کد رزرو ایرلاین (PNR).

{
  "Success": true,
  "RefundType": 1,
  "EticketNumbers": [
    {
      "ETicketNumber": "235-1234567890",
      "EticketStatus": "OPEN",
      "IsRefunded": false,
      "PenaltyAmount": 45.00,
      "IsNonRefundable": false,
      "Route": "IST-DXB",
      "AirlinePnr": "ABC123"
    }
  ],
  "Error": null
}

اجرای استرداد#

POST/Air/AirRefund

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

استرداد را برای بلیت‌های الکترونیکی انتخابی اجرا کنید. برای استرداد کل رزرو، EticketNumbers را نفرستید.

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

نام	نوع	الزامی	پیش‌فرض	توضیح
`SessionId`	string	الزامی	-	شناسهٔ نشست شما.
`UniqueId`	string	الزامی	-	شناسهٔ رزروی که بلیتش صادر شده است.
`RefundType`	integer	اختیاری	`1`	کد روش استرداد که در مرحلهٔ پیش‌نمایش برگشته است.
`EticketNumbers`	array of string	اختیاری	-	بلیت‌های الکترونیکی که باید مسترد شوند. برای همه، این فیلد را نفرستید.
`RefundPaymentMode`	integer	اختیاری	-	روش بازپرداخت مبلغ استرداد.

curl -X POST https://api.simorghapi.com/api/Air/AirRefund \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "TP-2026-000512",
    "RefundType": 1,
    "EticketNumbers": ["235-1234567890"]
  }'

const res = await fetch("https://api.simorghapi.com/api/Air/AirRefund", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "TP-2026-000512",
    RefundType: 1,
    EticketNumbers: ["235-1234567890"]
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.simorghapi.com/api/Air/AirRefund",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "TP-2026-000512",
        "RefundType": 1,
        "EticketNumbers": ["235-1234567890"],
    },
)

data = res.json()

پاسخ#

فیلد	نوع	توضیح
`Success`	boolean	در صورت موفقیت `true`.
`RefundEticketNumbers`	array of object	بلیت‌های مستردشده، همراه با مبلغ استرداد هر کدام.
`Error`	object	در صورت موفقیت `null`.

{
  "Success": true,
  "RefundEticketNumbers": [
    { "ETicketNumber": "235-1234567890", "RefundAmount": 174.60, "Currency": "USD" }
  ],
  "Error": null
}

خطاها#

کد	معنا	راه‌حل
`Err0103003`	رزرو پیدا نشد.	`UniqueId` را بررسی کنید.
`Err0103010`	رزرو قابل استرداد نیست.	وضعیت قابل‌استرداد بودن هر بلیت را در مرحلهٔ پیش‌نمایش بخوانید.

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