Cardholder Verification
تؤكد Cardholder Verification أن البطاقة تنتمي إلى حاملها المُعلن عنه — بالكامل من جهة الخادم، دون أي خطوة التقاط بصري.
ما الذي تقوم به
تتحقق من أن رقم CPF والبطاقة المُقدَّمة ينتميان إلى الشخص نفسه — فحص ملكية للبطاقة غير الحاضرة. تُعيد استخدام عملية تم التحقق منها مسبقاً (يُشار إليها بمعرّفها، referenceProcessId) إلى جانب رقم CPF وبيانات البطاقة الخاصة بالشخص (bin/last4) للإجابة عن الفحص مباشرة، دون تشغيل خطوة التقاط جديدة.
تُعد هذه القدرة سطح تكامل مختلفاً عن منتج التحقق من البطاقة غير الحاضرة.
المدخلات
- نوع الوثيقة، يُرسَل عبر
subject.duiType(حالياًDUI_TYPE_BR_CPFفقط)، وقيمة رقم CPF عبرsubject.code. card:bin(أول 6 أو 8 أرقام من البطاقة) وlast4(آخر 4 أرقام)، ويُعدnameاختيارياً.referenceProcessId— معرّف العملية التي تم التحقق منها مسبقاً والمُعاد استخدامها، حيث تم تأكيد هوية هذا الشخص من قبل (التحقق من الهوية أو لايفنس). النسخة الحالية من هذه القدرة تعتمد على إعادة الاستخدام: بدون هذا الحقل، لا يتم تشغيل البوابة أبداً وتُعيد الاستجابة تلقائياً النتيجة القياسيةunsure— ولا يفشل الطلب نفسه أبداً.- يتم تشغيلها عبر
POST /processes/v1باستخدام Recipe (مفتاح API) يتضمن Cardholder Verification. يتم تفعيلها لكل مفتاح API من خلال Recipe (أوcapabilities_enabled)، لا من خلال حقلflow.
الاستجابات الممكنة
| الاستجابة | المعنى |
|---|---|
approved | رقم CPF والبطاقة يخصان الشخص نفسه. |
unsure | لا توجد عملية صالحة لإعادة استخدامها، أو كان التحقق نفسه غير قاطع. |
| (محذوفة) | لم يكتمل التحقق خلال الاستدعاء التزامني. حقل cardholderVerification غائب من استجابة الحصول على العملية، وتعكس status أن العملية لا تزال قيد المعالجة. |
التوافر
| السطح | مدعوم |
|---|---|
| SDK (Android, iOS, Flutter) | ❌ قدرة من جهة الخادم فقط، بلا خطوة التقاط |
| Web (iFrame, Redirect) | ❌ قدرة من جهة الخادم فقط، بلا خطوة التقاط |
| API (بدون واجهة مستخدم، بدون SDK) | ✅ |
المجموعات الصالحة
Cardholder Verification ليست جزءاً من كتالوج flow المُعدّ مسبقاً — يتم تفعيلها مباشرة على Recipe الخاصة بمفتاح API (أو capabilities_enabled، للمفاتيح غير IDCloud)، بشكل مستقل عن التدفقات الموجودة في التدفقات المتاحة.
حالات الاستخدام التي تستخدم هذه القدرة
لا توجد حتى الآن حالات استخدام منشورة تشير إلى هذه القدرة.