# مستند راهنمای سرویس‌های پذیرنده - دایا دایموند

شماره مستند: **TA-DAYA-S10-G-MerchantServices**  
طبقه‌بندی: **محرمانه**

## اطلاعات نسخه

| تاریخ ویرایش | شرح ویرایش | نسخه |
|--------------|------------|------|
| 1404/09/12   | نسخه اول   | 1    |

---

## سرویس وضعیت قرارداد کاربران

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

- **ورودی سرویس**: لیستی از کدهای ملی  
- **خروجی سرویس**: برای هر کد ملی، شناسه قرارداد، وضعیت «امضا شده»، کد ملی مشتری درخواست‌دهنده و زمان امضای قرارداد برگردانده می‌شود.

### مشخصات فنی سرویس

- **نوع سرویس**: RESTful
- **Base Address**: `https://testdaya.tadbirandishan.com`
- **API**: `/api/merchant/contracts`
- **Method**: `POST`

### احراز هویت

در Header درخواست باید یک پارامتر با نام زیر ارسال شود:

- Header Name: `merchant-permission-key`  
- مقدار این کلید توسط شرکت اعلام می‌شود.

### نکات

- این سرویس به مدت **۲۰ دقیقه** نتیجه را کش می‌کند.

---

## نمونه درخواست به‌صورت cURL

```bash
curl --location --request POST 'https://localhost:7279/api/merchant/Contracts' \
--header 'merchant-permission-key: 14752708$Db5Wk5hnhKO4FGuoKBUZIvHW5WO1NpCxYNy_sy8epfQ-d6n6vjeZJa6EnTq876cq' \
--header 'Content-Type: application/json' \
--data '{
  "NationalCodes": [
    "2345678901",
    "1234567890"
  ]
}'
````

---

## نمونه بدنه‌ی درخواست (Request Body)

```json
{
  "NationalCodes": [
    "2345678901",
    "1234567890"
  ]
}
```

---

## نمونه پاسخ‌های موفق (Sample Successful Response)

```json
{
  "succeed": true,
  "code": 200,
  "data": [
    {
      "nationalCode": "1234567890",
      "applicationNo": "C4_U8467433",
      "statusDescription": "فعال شده (در انتظار تسویه)",
      "dateTime": "2025-11-08T11:27:34.245193+03:30"
    },
    {
      "nationalCode": "2345678901",
      "applicationNo": "C4_C8144074",
      "statusDescription": "فعال شده (در انتظار تسویه)",
      "dateTime": "2025-11-08T11:31:23.602347+03:30"
    },
    {
      "nationalCode": "1234567890",
      "applicationNo": "C4_V9343786",
      "statusDescription": "فعال شده (در انتظار تسویه)",
      "dateTime": "2025-12-01T18:00:40.939024+03:30"
    }
  ]
}
```

---

## نمونه پاسخ‌های ناموفق (Sample Failed Response)

```json
{
  "succeed": false,
  "code": 401,
  "message": "دسترسی به سرویس مورد نظر غیرمجاز است",
  "data": null
}
```

```
```