---
title: Cardholder Verification
description: قدرة تؤكد أن البطاقة تنتمي إلى حاملها المُعلن عنه من خلال إعادة استخدام عملية تم التحقق منها مسبقاً، إلى جانب رقم CPF الخاص بالشخص وبيانات البطاقة.
canonical: https://developer.unico.io/ar/dual-api/capabilities/cardholder-verification
locale: ar
generated_by: markdown-export
---

تؤكد Cardholder Verification أن البطاقة تنتمي إلى حاملها المُعلن عنه — بالكامل من جهة الخادم، دون أي خطوة التقاط بصري.

### ما الذي تقوم به

تتحقق من أن رقم CPF والبطاقة المُقدَّمة ينتميان إلى الشخص نفسه — فحص ملكية للبطاقة غير الحاضرة. تُعيد استخدام عملية تم التحقق منها مسبقاً (يُشار إليها بمعرّفها، `referenceProcessId`) إلى جانب رقم CPF وبيانات البطاقة الخاصة بالشخص (`bin`/`last4`) للإجابة عن الفحص مباشرة، دون تشغيل خطوة التقاط جديدة.

:::note[ليست نفس التحقق من البطاقة غير الحاضرة]
تُعد هذه القدرة سطح تكامل مختلفاً عن منتج [التحقق من البطاقة غير الحاضرة](/products/regional-solutions/card-not-present-verification/index).
:::

### المدخلات

- نوع الوثيقة، يُرسَل عبر `subject.duiType` (حالياً `DUI_TYPE_BR_CPF` فقط)، وقيمة رقم CPF عبر `subject.code`.
- `card`: `bin` (أول 6 أو 8 أرقام من البطاقة) و`last4` (آخر 4 أرقام)، ويُعد `name` اختيارياً.
- `referenceProcessId` — معرّف العملية التي تم التحقق منها مسبقاً والمُعاد استخدامها، حيث تم تأكيد هوية هذا الشخص من قبل (التحقق من الهوية أو لايفنس). النسخة الحالية من هذه القدرة تعتمد على إعادة الاستخدام: بدون هذا الحقل، لا يتم تشغيل البوابة أبداً وتُعيد الاستجابة تلقائياً النتيجة القياسية `unsure` — ولا يفشل الطلب نفسه أبداً.
- يتم تشغيلها عبر [`POST /processes/v1`](/dual-api/developers/api-reference/api/post-processes) باستخدام Recipe (مفتاح API) يتضمن Cardholder Verification. يتم تفعيلها لكل مفتاح API من خلال Recipe (أو `capabilities_enabled`)، لا من خلال حقل `flow`.

### الاستجابات الممكنة

| الاستجابة | المعنى |
|---|---|
| `approved` | رقم CPF والبطاقة يخصان الشخص نفسه. |
| `unsure` | لا توجد عملية صالحة لإعادة استخدامها، أو كان التحقق نفسه غير قاطع. |
| _(محذوفة)_ | لم يكتمل التحقق خلال الاستدعاء التزامني. حقل `cardholderVerification` غائب من استجابة [الحصول على العملية](/dual-api/developers/api-reference/api/get-process)، وتعكس `status` أن العملية لا تزال قيد المعالجة. |

### التوافر

| السطح | مدعوم |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ❌ قدرة من جهة الخادم فقط، بلا خطوة التقاط |
| **Web** (iFrame, Redirect) | ❌ قدرة من جهة الخادم فقط، بلا خطوة التقاط |
| **API** (بدون واجهة مستخدم، بدون SDK) | ✅ |

### المجموعات الصالحة

Cardholder Verification ليست جزءاً من كتالوج `flow` المُعدّ مسبقاً — يتم تفعيلها مباشرة على Recipe الخاصة بمفتاح API (أو `capabilities_enabled`، للمفاتيح غير IDCloud)، بشكل مستقل عن التدفقات الموجودة في [التدفقات المتاحة](/dual-api/capabilities/available-flows).

### حالات الاستخدام التي تستخدم هذه القدرة

لا توجد حتى الآن حالات استخدام منشورة تشير إلى هذه القدرة.