مستندات فنی «تطبیق شاهکار موبایل و کد ملی»

اندپوینت و دسترسی تطبیق شاهکار موبایل و کد ملی

این صفحه مستندات فنی فراخوانی GET /facility/v2/clients/{clientId}/shahkar/verify است.

Scope: facility:shahkar:get

Grant type: client_credentials

دسته‌بندی OpenAPI: احراز هویت و شناخت مشتری. شناسه عملیات: facilityShahkarVerifyGet.

معرفی تطبیق شاهکار موبایل و کد ملی

استعلام شاهکار مشخص می‌کند شماره موبایل به همان کد ملی تعلق دارد یا نه. این سرویس احراز هویت (KYC) با رویکرد Client Credential است.

ورودی و خروجی تطبیق شاهکار موبایل و کد ملی

ورودی‌های اصلی: شناسه کلاینت، شماره موبایل، کد ملی.

پارامترهای اختیاری متداول: کد پیگیری.

فیلدهای مهم پاسخ: نتیجه انطباق.

جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.

کاربرد فنی تطبیق شاهکار موبایل و کد ملی

استعلام شاهکار مشخص می‌کند شماره موبایل به همان کد ملی تعلق دارد یا نه. این سرویس احراز هویت (KYC) با رویکرد Client Credential است.

پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.

در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.

برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «تطبیق شاهکار موبایل و کد ملی» مراجعه کنید.

عملیات مرتبط با تطبیق شاهکار موبایل و کد ملی

• دریافت تصویر کارت ملی — GET /facility/v2/clients/{clientId}/nationalCardImage
• دریافت تصویر کارت ملی — GET /facility/v2/clients/{clientId}/nationalCardImage
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Client Credential) — GET /facility/v2/clients/{clientId}/users/{nid}/cc/nidInquiry
• استعلام کد ملی (Authorization SMS) — GET /facility/v2/clients/{clientId}/users/{nid}/sms/nidInquiry