استعلام اینماد

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): با وارد کردن نام شرکت و آدرس وب‌سایت، اطلاعات گواهینامه اینماد شامل تاریخ ثبت و تاریخ انقضا…

مستندات فنی

سرویس «استعلام اینماد» در دسته شناخت کسب‌وکار KYB فینوتک با گرفتن نام شرکت و نشانی وب‌سایت، اطلاعات گواهی‌نامه اینماد آن کسب‌وکار شامل دارنده گواهی، تاریخ ثبت و تاریخ انقضا را برمی‌گرداند. با این سرویس می‌توانید پیش از پذیرش یک فروشگاه اینترنتی یا فعال‌سازی ابزار پرداخت روی یک دامنه، بررسی کنید نشان اعتماد الکترونیکی آن وب‌سایت وجود دارد، به چه کسی تعلق دارد و تا چه زمانی معتبر است.

استعلام اینماد چه مشکلی را حل می‌کند؟

نشان اعتماد الکترونیکی روی صفحه یک وب‌سایت، یک تصویر است؛ همان تصویر می‌تواند از سایت دیگری کپی شده باشد، به دامنه دیگری تعلق داشته باشد یا اعتبارش تمام شده باشد. در پذیرش کسب‌وکارهای اینترنتی، کارشناس معمولاً دامنه را باز می‌کند، نشان را می‌بیند، نام دارنده را به چشم مقایسه می‌کند و همین بررسی چشمی را برای هر متقاضی تکرار می‌کند. این روش نه در حجم بالا شدنی است و نه ردی برای ممیزی باقی می‌گذارد.

این سرویس همان بررسی را به یک فراخوانی API تبدیل می‌کند: با نام شرکت و نشانی وب‌سایت، مشخص می‌شود گواهی اینماد به نام چه دارنده‌ای ثبت شده، چه تاریخی صادر شده و تاریخ انقضای آن چه زمانی است. نتیجه را می‌توانید در همان فرم ثبت‌نام به قاعده تصمیم بدهید: پذیرش دامنه‌هایی که گواهی معتبر و هم‌نام با متقاضی دارند، توقف موارد منقضی‌شده و ارسال موارد مغایر به بررسی دستی. همچنین می‌توانید تاریخ انقضا را در سامانه خود نگه دارید و پیش از پایان اعتبار به مشتری هشدار بدهید.

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

  • پذیرش فروشگاه اینترنتی و راه‌اندازی درگاه پرداخت — پیش از فعال‌سازی پرداخت روی یک دامنه، وجود و اعتبار نشان اعتماد الکترونیکی همان دامنه بررسی می‌شود.
  • بررسی فروشنده در مارکت‌پلیس و پلتفرم چندفروشندگی — دامنه فروشنده‌ای که با نام تجاری خود کالا عرضه می‌کند پیش از پذیرش کنترل می‌شود.
  • پایش تاریخ انقضا در سبد مشتریان فعال — تاریخ انقضای گواهی مشتریان موجود بازبینی می‌شود تا پیش از پایان اعتبار، تمدید یادآوری یا سطح خدمت بازنگری شود.
  • تطبیق مالک دامنه با متقاضی پذیرش — دارنده گواهی با شرکت متقاضی مقایسه می‌شود تا پذیرش دامنه‌ای که به شخص دیگری تعلق دارد جلوگیری شود.
  • پذیرش تبلیغ‌دهنده و شریک تجاری اینترنتی — پلتفرم‌های تبلیغات و همکاری در فروش پیش از انتشار لینک، اعتبار نشان کسب‌وکار مقصد را کنترل می‌کنند.

مزایای استعلام اینماد

  • بررسی دامنه‌محور به‌جای بررسی چشمی — تصمیم بر پایه دادهٔ ساخت‌یافته گرفته می‌شود، نه تصویر نشان روی صفحه سایت.
  • تشخیص گواهی منقضی‌شده — تاریخ انقضا در پاسخ می‌آید و می‌توانید اعتبار زمانی را دقیق کنترل کنید.
  • تطبیق نام دارنده گواهی — روشن می‌شود گواهی به چه دارنده‌ای ثبت شده و می‌توانید آن را با متقاضی پذیرش مقایسه کنید.
  • قابل استفاده وقتی شناسه ملی در دست نیست — این سرویس با نام شرکت و نشانی وب‌سایت کار می‌کند و به شناسه ملی شرکت نیاز ندارد.
  • پیاده‌سازی سبک — یک فراخوانی با توکن Client Credential، بدون نیاز به حضور یا رضایت پیامکی کاربر.

چه چیزی از استعلام اینماد دریافت می‌کنید؟

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

جریان کار استعلام اینماد

  • ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ kyb:enamad-inquiry:get توکن Client Credential بگیرید.
  • ۲. ارسال نام شرکت و نشانی وب‌سایت — هر دو ورودی را همراه یک trackId یکتا بفرستید.
  • ۳. خواندن اطلاعات گواهی — دارنده گواهی، تاریخ ثبت و تاریخ انقضا را از پاسخ بردارید.
  • ۴. اعمال قاعده کسب‌وکاری — اعتبار زمانی گواهی را بسنجید و دارنده آن را با متقاضی تطبیق دهید، سپس پذیرش دامنه را تایید یا متوقف کنید.
  • ۵. نگهداری برای پایش — تاریخ انقضا و شناسه پیگیری را ذخیره کنید تا یادآوری تمدید و ممیزی بعدی ممکن باشد.

نحوه شروع استعلام اینماد

این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی می‌شود. اسکوپ مورد نیاز: kyb:enamad-inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

محدودیت‌ها و نکات استعلام اینماد

  • هر دو ورودی نام شرکت و نشانی وب‌سایت لازم است؛ این سرویس با شناسه ملی شرکت فراخوانی نمی‌شود.
  • نشانی وب‌سایت را پیش از ارسال یکدست کنید؛ آنچه کاربر در فرم می‌نویسد می‌تواند شامل بخش‌های اضافه یا نگارش متفاوت دامنه باشد و ورودی نادرست، نتیجه نادرست می‌دهد.
  • نام شرکت را همان‌گونه که ثبت شده است بفرستید و در مقایسه دارنده گواهی، تفاوت‌های نگارشی مانند نیم‌فاصله و «ي» و «ك» عربی را نرمال‌سازی کنید.
  • تاریخ انقضا را نادیده نگیرید؛ وجود گواهی به‌تنهایی معنای اعتبار داشتن آن در لحظه پذیرش نیست.
  • اگر به سبد کامل مجوزهای یک شخصیت حقوقی نیاز دارید و شناسه ملی آن را دارید، استعلام مجوزهای شرکت مجوزهای اینماد را در کنار سایر گروه‌های مجوز برمی‌گرداند.
  • نتیجه تصویری از لحظه استعلام است؛ برای بازبینی دوره‌ای یا پیش از تمدید قرارداد، فراخوانی را با trackId یکتای تازه تکرار کنید.

سوالات متداول استعلام اینماد

«استعلام اینماد» چیست؟

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

برای فراخوانی چه ورودی‌هایی لازم است؟

نام شرکت و نشانی وب‌سایت آن. برخلاف سایر سرویس‌های شناخت کسب‌وکار، این سرویس با شناسه ملی شرکت کار نمی‌کند.

تفاوت این سرویس با استعلام مجوزهای شرکت چیست؟

این سرویس روی یک گواهی مشخص و یک دامنه تمرکز دارد و تاریخ ثبت و انقضای آن را می‌دهد؛ استعلام مجوزهای شرکت با شناسه ملی فراخوانی می‌شود و گروه‌های مختلف مجوز شرکت را یکجا برمی‌گرداند.

آیا با این سرویس می‌توان فهمید وب‌سایت به کدام شرکت تعلق دارد؟

دارنده گواهی در پاسخ بازگردانده می‌شود و می‌توانید آن را با متقاضی پذیرش مقایسه کنید؛ برای مشخصات ثبتی همان شرکت از استعلام اطلاعات شرکت با شناسه ملی استفاده کنید.

مستندات فنی این سرویس کجاست؟

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

چه نوع احراز هویتی لازم است؟

Grant type: client_credentials. جزئیات در راهنمای توکن.

آیا رضایت پیامکی کاربر لازم است؟

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

مستندات فنی استعلام اینماد

مشاهده مستندات فنی «استعلام اینماد» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با استعلام اینماد