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

شماره مستند: 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

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)

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

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

{
  "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)

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

2.9 KiB Raw Blame History