داشبورد
یک داشبورد احراز هویت برای کلیدها، میزان استفاده و نتایج.
میزان استفادهٔ این ماه را ببینید، کلیدهای API مربوط به sandbox و محیط زنده را مدیریت کنید، صورتحساب را بررسی کنید و همهٔ نتایج احراز هویت را دقیقاً همانگونه که تیم شما میبیند بخوانید. به انگلیسی یا فرانسوی.
- کلیدهای sandbox و زنده، جدا از هم
- هر نتیجه بهصورت نتایج جداگانهٔ هر بررسی
- انگلیسی و فرانسوی، از ابتدا تا انتها
در پورتال
هر آنچه یک پورتال KYC باید به شما نشان دهد، در یک مکان.
پورتال مشتری جایی است که تیم شما هر روز در آن کار میکند: نه یک گزارش خام از فراخوانیهای API، بلکه مصرف، کلیدها، صورتحساب و نتایج که برای خواندهشدن توسط انسان سازماندهی شدهاند.
طرح و اشتراک
کلیدهای API
سابقهی مصرف
صورتحساب و فاکتورها
برندسازی، در طرحهای واجد شرایط
Sign-in
آنگونه که یک پورتال KYC باید ایمن باشد، ایمن شده است.
این پورتالی است که مسئول انطباق (compliance) شما وارد آن میشود، بنابراین خود فرایند ورود به همان اندازهی بررسیهای پشت آن مورد توجه قرار گرفته است.
- گذرواژهها هش میشوند و هرگز بهصورت متن ساده ذخیره نمیشوند.
- هشت بار ورود ناموفق، حساب را برای پانزده دقیقه قفل میکند، بنابراین اسکریپت حدس گذرواژه به جایی نمیرسد.
- نشست (session) یک توکن تصادفی است؛ فقط هش آن روی سرور نگهداری میشود و کوکی با HttpOnly علامتگذاری شده است.
- ورود دومرحلهای — بهزودی.
- ورود به سیستم و کل پورتال به زبانهای انگلیسی و فرانسوی در دسترس است.
کلیدهای API
کلیدهایی که از هم قابل تشخیصاند و بدون ثبت درخواست پشتیبانی قابل ابطالاند.
کلیدها فقط از طریق پورتال ساخته میشوند، هرگز با یک فراخوانی ناشناس API، و هر کلید فقط به حساب شما محدود است.
- کلیدهای sandbox و کلیدهای زنده همیشه متمایز هستند، بنابراین یک اسکریپت آزمایشی هرگز نمیتواند بهطور تصادفی به محیط عملیاتی دست بزند.
- کلید کامل فقط یک بار، بلافاصله پس از ساخت، نمایش داده میشود. پس از آن فقط یک پیشوند کوتاه را بهصورت آشکار نگه میداریم.
- ابطال یک کلید بلافاصله اعمال میشود: درخواست بعدی با آن کلید رد میشود.
- محدودیت نرخ درخواست برای هر کلید در همهٔ طرحها وجود دارد.
کلیدهای API
دادههای نمونهکلید sandbox جدید ایجاد شد
vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4
همین حالا آن را کپی کنید. دیگر نمایش داده نخواهد شد — پس از این فقط پیشوند آن قابل مشاهده میماند.
پیشفرض sandbox
vk_sand_8Kd9…
Sandbox12 سپتامبر 2026فعالمحیط عملیاتی (Production)
vk_live_2Qf1…
زنده3 اوت 2026فعالآزمون قدیمی یکپارچهسازی
vk_sand_9Ta2…
Sandbox18 فوریهٔ 2026ابطالشده
دادههای نمونه
نتیجه چه شکلی دارد.
هر احراز هویت در قالب نتایج جداگانه و نامدار برمیگردد، نه یک امتیاز مبهم. این یک نمونهی فرضی است: نامها و سند ساختگی هستند، اما ساختار نتیجه واقعی است.
Morgan Ellis
California driver's license
- سند
- موفق
- کارت شناسایی اصالتسنجی میشود: روی کارت، پشت کارت، بارکد و MRZ، در صورت وجود، همگی خوانده میشوند.
- هویت
- موفق
- بارکد، MRZ و صفحهی چاپی در تمام فیلدها با هم مطابقت دارند. منبعی که مغایرت داشته باشد علامتگذاری میشود و هرگز میانگینگیری نمیشود.
- تطابق نام
- موفق
- نامی که یکپارچهسازی شما انتظار داشته با نام روی کارت شناسایی مطابقت دارد.
- تشخیص زندهبودن
- موفق
- یک چالش هدایتشده که روی ۴۷۸ نقطهی مشخصهی چهره در دستکم ده فریم ردیابی میشود.
- Anti-spoof
- موفق
- نه عکسِ یک عکس، نه بازپخش از روی صفحهنمایش و نه چهرهی چاپشده.
- دیپفیک
- موفق
- نشانهای از چهرهی مصنوعی یا دستکاریشده وجود ندارد.
- ماسک
- موفق
- نشانهای از ماسک سهبعدی یا پروتز وجود ندارد.
- دستکاری
- گزارش شد
- یک سیگنال مشورتی روی تصویر سند، نه یک دروازهی قبول/رد.
- تطبیق چهره
- موفق
- چهرهی زنده با تصویر چهرهی روی سند مطابقت دارد و نتیجه در برابر یک مرز تصمیمگیری ثابت گزارش میشود. ما هرگز درصد را چاپ نمیکنیم.
- تحریمها
- Add-on
- فهرستهای OFAC، UN، EU، Canada OSFI، UK HMT، Australia DFAT و OpenSanctions را برای حسابهایی که این گزینه را اضافه میکنند بررسی میکند؛ بهروزرسانی فهرستها بهصورت دستی یا با همگامسازی زمانبندیشدهی بیرونی انجام میشود، نه با بازآوری روزانهی خودکار.
- نشانی
- موفق
- نشانی ثبتشده با نشانی چاپشده یا رمزگذاریشده روی کارت شناسایی مطابقت دارد، در صورتی که نشانی برای مقایسه ارائه شده باشد.
کالبدشکافی یک نتیجه
یک نمونه احراز هویت، فیلد به فیلد.
دادههای نمونه: یک نشست ساختگی برای یک متقاضی ساختگی، به همان شکلی که به داشبورد و دریافتکنندهٔ webhook شما میرسد.
- شناسهٔ نشست
- ses_7f2a91c0b3d4 — شناسهای که نشست را با آن ایجاد کردید و همان شناسهای که هر جستوجو و webhook بعدی از آن استفاده میکند.
- وضعیت
- VERIFIED، FAILED، PENDING، IN_PROGRESS یا EXPIRED.
- محیط
- Sandbox یا production، که روی نشست ثبت میشود و هرگز با هم مخلوط نمیشوند.
- متقاضی
- نام، تاریخ تولد، نوع مدرک، کشور و حوزهٔ قضایی مدرک و نشانی، بههمان صورت که از مدرک شناسایی خوانده شده است.
- نتیجهٔ هر بررسی
- مدرک، زندهبودن (liveness)، ضدجعل (anti-spoof)، تطبیق چهره و در صورت فعالبودن، تحریمها؛ هرکدام بهتنهایی PASS، FAIL یا SKIPPED.
- تطبیق چهره
- با یک مرز تصمیمگیری ثابت مقایسه میشود. ما قبولی یا ردی را گزارش میکنیم، نه درصد.
- راهنمای عکسبرداری مجدد
- در صورت شکست، کدام طرف — مدرک یا سلفی — واقعاً نیاز به عکسبرداری دوباره دارد، بهجای یک «دوباره تلاش کنید» کلی.
- زمان تکمیل
- زمانی که نشست به وضعیت نهایی خود رسید.
- روش تحویل
- یک webhook امضاشده به webhook_url شما، و همان نتیجه در داشبورد و API.
تصاویر مربوط به این نتیجه بهصورت خودکار و با یک زمانسنج کوتاه، بهطور پیشفرض هفت روز، پاک میشوند. خود نتیجه باقی میماند.
بقیهٔ تصویر
بخش مدیریت، نقشها و محدودیتها، صادقانه.
دو نکته که بهتر است صریح گفته شود، نه اینکه خودتان بعداً کشف کنید.
بخش مدیریت
در پشت هر پورتال مشتری، یک کنسول داخلی جداگانه وجود دارد که تیم خودمان از آن استفاده میکند: میزان استفاده و صورتحساب هر حساب در یک جستوجو، تغییر طرحها و تنظیمات مشترک تشخیص که در محدودههای ثابت و آزمایششده تنظیم میشوند. این کنسول بخشی از حساب شما نیست و آن را نخواهید دید.
نقشها و محدودیتها
در حال حاضر هر حساب یک ورود دارد. دعوت از همتیمیها با نقش مخصوص خودشان — مدیر، صورتحساب، فقطخواندنی — بهزودی ارائه میشود. محدودیت نرخ درخواست برای هر کلید در همهٔ طرحها وجود دارد؛ اِعمال آن در API زنده بهزودی ارائه میشود، پس محدودیت طرح خود را عددی بدانید که باید طراحی را بر مبنای آن انجام دهید، نه هنوز مانعی که API اِعمال میکند.
Quick-start
از ثبتنام تا اولین نتیجهٔ شما.
پورتال برای این ساخته شده که شما را سریع به یک نتیجهٔ واقعی برساند، نه اینکه ابتدا مجبور شوید راهنما بخوانید.
حساب خود را ایجاد کنید
در پورتال ثبتنام کنید و انگلیسی یا فرانسوی را انتخاب کنید. برای sandbox نیازی به کارت نیست.کلید sandbox خود را کپی کنید
فقط یک بار، بلافاصله پس از ایجاد نمایش داده میشود. آن را در محیط (environment) خود قرار دهید، نه در کنترل نسخهٔ سورس.یک نشست ایجاد کنید
یک فراخوانی API با نشانی بازگشت و نشانی webhook. پیوندی را که برمیگرداند برای متقاضی بفرستید.نتیجه را بخوانید
آن را در داشبورد ببینید، یا بهمحض رسیدن از روی webhook امضاشده بخوانید.
بیشتر تیمها همان بعدازظهر به یکپارچهسازی کارآمد sandbox میرسند.
پرسشها
پاسخهای روشن درباره داشبورد.
شروع کنید
وارد شوید و خودتان ببینید.
سریعترین راه برای شناخت داشبورد این است که آن را باز کنید: یک کلید sandbox بسازید، یک احراز هویت اجرا کنید و نتیجه را لحظهبهلحظه ببینید.