masoodafar-web
116 lines
2.9 KiB
Markdown
116 lines
2.9 KiB
Markdown
|
|
|
|
# مستند راهنمای سرویسهای پذیرنده - دایا دایموند
|
|
|
|
شماره مستند: **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
|
|
}
|
|
```
|
|
|
|
```
|
|
```
|