استعلام تسهیلات و اعتبارسنجی

استعلام ضمانت های فرد با پیامک

<!--seo-open-->

سرویس «استعلام ضمانت های فرد با پیامک» (National ID / SMS/OTP) در دسته تسهیلات و اعتبارسنجی فینوتک؛ نسخه پیامکی برای فراخوانی با تایید کاربر. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی با تایید پیامکی کاربر (authorization_sms) انجام می‌شود. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

این سرویس با وارد کردن کد ملی یا شناسه ملی، فهرست وام‌هایی را برمی‌گرداند که شخص به‌عنوان ضامن در آن‌ها ثبت شده است (شامل مشخصات بدهکار، مبلغ و شعبه بانک).

Scope: credit:sms-guaranty-inquiry:get<br />

Grant type: authorization_sms

get/credit/v2/clients/{clientId}/users/{nid}/sms/guarantyInquiry

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/credit/v2/clients/{clientId}/users/{nid}/sms/guarantyInquiry
  • Auth: HTTP bearer

Path parameters

clientIdstring required
nidstring required

National ID (کد ملی)

Query parameters

trackIdstring

Response

Successful response

responseCodestring

ریسپانس‌ کد مربوط به این فراخوانی

trackIdstring

کد پیگیری، اگر ارسال شده باشد همان مقدار و در غیر اینصورت یک رشته تصادفی تولید و برگردانده میشود

statusstring

وضعیت فراخوانی سرویس

Example response

{
  "responseCode": "FN-CTKZ-20002300000",
  "trackId": "0705ae6c-ac95-4574-moho-0e85d149d9bf",
  "status": "DONE",
  "result": {
    "guarantyFirstName": "امیرمحمد",
    "guarantyLastName": "اسد",
    "guarantyNationalCode": "1234567890",
    "inquiryResultId": "12345678",
    "debtorList": [
      {
        "debtorFirstName": "اکبر",
        "debtorLastName": "اکبری",
        "totalAmount": "97488736",
        "benefitAmount": "90445871",
        "obligationAmount": "0",
        "suspiciousAmount": "0",
        "deferredAmount": "0",
        "orginalAmount": "300000000",
        "pastExpiredAmount": "0",
        "bankCode": "13",
        "setDate": "13980521",
        "endDate": "14010621",
        "guarantyPercent": "100",
        "requestNumber": "2222222222222222",
        "requestType": "3",
        "branchCode": "00144",
        "branchDescription": "بانک صادرات - شعبه شهید نامجو",
        "guarantyIdNumber": "0123456789",
        "guarantyLegalId": "0",
        "commitmentBalanceAmount": "0",
        "latePenaltyAmount": "0"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.