update

2026-01-03 18:27:49 +03:30
parent 0369292d7f
commit 5965b98728
156 changed files with 16082 additions and 0 deletions
@@ -0,0 +1,115 @@
+
+
+# مستند راهنمای سرویس‌های پذیرنده - دایا دایموند
+
+شماره مستند: **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
+}
+```
+
+```
+```