# رویه استرداد آیتم خریداری شده – Refund Procedure

<span>در این بخش شما میتوانید رویه استرداد آیتم خریداری شده و مقدار جریمه ی استرداد آیتم مورد نظر را دریافت نمایید.</span>

# دریافت رویه استرداد آیتم از طریق API

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%88%D8%B6%D8%B9%DB%8C%D8%AA-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**وضعیت**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">Method</td><td>اجباری</td><td>GET</td><td>متد ارسال درخواست</td></tr><tr><td class="has-text-align-left" data-align="left">Domain</td><td>اجباری</td><td>نام دامنه ثبت شده در اتوماسیون</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">Api Url</td><td>اجباری</td><td>دامنه هسته مرکزی سرویس</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">Api version</td><td>اجباری</td><td>به نسخه فعلی سرویس API تلقی میشود که در قسمت [پیش نیازهای اتوماسیون](https://airplus.app/docs/%d9%be%db%8c%d8%b4-%d9%86%db%8c%d8%a7%d8%b2%d9%87%d8%a7-%d9%88-%d8%b4%d8%b1%d8%a7%db%8c%d8%b7-%d8%a7%d8%ae%d8%b0-api-%da%86%d8%a7%d8%b1%d8%aa%d8%b1%db%8c/) به ریز شرح داده شده است.</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">Authorization</td><td>اجباری</td><td>توکن JWT تولید شده</td><td>این توکن بصورت JWT تولید میشود.</td></tr></tbody></table>

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

# سربرگ – Header

```
{{Api Url}}/refund/procedure

HEADER
GET /api/reservation/{{Api version}}/refund/procedure HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Authorization: Bearer JWTToken
Domain: {{Your Domain}}
```

API Url از طریق پنل کاربری قابل مشاهده خواهد بود.

# مقادیر ارسالی – Request Data

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%86%D9%88%D8%B9-%D9%88%D8%B6%D8%B9%DB%8C%D8%AA-%D9%85%D9%82%D8%A7%D8%AF" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**نوع**</td><td>**وضعیت**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">reserve\_id</td><td>String</td><td>اجباری</td><td>آیدی یا pnr اصلی</td><td>  
</td></tr></tbody></table>

```
{
    "reserve_id": "" // id or pnr
}
```

# پاسخ صحیح – Response True

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%86%D9%88%D8%B9-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA%D9%88%D8%B6" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**نوع**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">**payload**</td><td> </td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">payload.refundable</td><td>Boolean</td><td>true/false</td><td>اگر قوانین استرداد برای آیتم مورد نظر تعریف شده باشد مقدار این کلید true خواهد بود و اگرم تعریف نشده باشد مقدار این کلید false خواهد بود.</td></tr><tr><td class="has-text-align-left" data-align="left">payload.reserve\_id</td><td>Integer</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">payload.diffrance</td><td>Integer</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">payload.price</td><td>Integer</td><td>مقدار قیمت پرداختی</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">payload.penalty</td><td>Integer</td><td>مقدار جریمه پرداختی</td><td>هنگامی که مقدار کلید payload.refundable trueباشد این کلید وجود دارد</td></tr><tr><td class="has-text-align-left" data-align="left">**meta**</td><td> </td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">meta.timestamp</td><td>Timestamp</td><td> زمان تولید پاسخ</td><td> این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود.</td></tr></tbody></table>

دریافت این پاسخ با Status Code 200 دریافت خواهد شد.

```
 {
    "payload": {
        "refundable": true,
        "reserve_id": 10011,
        "diffrance": 9117,
        "price": 0, // amount paid
        "penalty": 0 //Amount of fine paid
    },
    "meta": {
        "timestamp": "Timestamp" // Timestamp
    }
}
```

# پاسخ نادرست – Response False

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%86%D9%88%D8%B9-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA%D9%88%D8%B6" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**نوع**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">**error**</td><td> </td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">error.code</td><td>Integer</td><td>شماره خطا مربوطه</td><td>جهت استعلام خطا میتوانید از طریق [این لینک](https://airplus.app/docs/%d9%85%d8%af%db%8c%d8%b1%db%8c%d8%aa-%d8%ae%d8%b7%d8%a7%d9%87%d8%a7-error-handling/) اقدام کنید.</td></tr><tr><td class="has-text-align-left" data-align="left">**meta**</td><td> </td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">meta.timestamp</td><td>Timestamp</td><td> زمان تولید پاسخ</td><td> این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود.</td></tr></tbody></table>

```
{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}

```

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نمود اید.