Cardholder Verification

Cardholder Verification bestätigt, dass eine Karte zu ihrem angegebenen Inhaber gehört — vollständig im Backend, ohne visuellen Erfassungsschritt.

Was sie tut

Bestätigt, dass die CPF-Nummer und die vorgelegte Karte zur selben Person gehören — eine Prüfung der Karteninhaberschaft ohne physische Karte. Dabei wird ein zuvor validierter Prozess (referenziert über seine ID, referenceProcessId) zusammen mit der CPF-Nummer und den Kartendaten der Person (bin/last4) wiederverwendet, um die Prüfung direkt zu beantworten, ohne einen neuen Erfassungsschritt auszuführen.

Nicht identisch mit Verifizierung ohne physische Karte

Diese Funktion ist eine andere Integrationsoberfläche als das Produkt Verifizierung ohne physische Karte.

Eingaben

• Der Dokumenttyp, gesendet über subject.duiType (derzeit nur DUI_TYPE_BR_CPF), sowie der CPF-Wert über subject.code.
• card: bin (die ersten 6 oder 8 Ziffern der Karte) und last4 (die letzten 4 Ziffern), name ist optional.
• referenceProcessId — die ID des zuvor validierten Prozesses, der wiederverwendet wird und bei dem die Identität dieser Person bereits bestätigt wurde (Identitätsprüfung oder Lebenderkennung). Die aktuelle Version dieser Funktion basiert auf Wiederverwendung: Ohne dieses Feld wird die Prüfung nie ausgelöst, und die Antwort fällt standardmäßig auf das reguläre unsure-Ergebnis zurück — die Anfrage selbst schlägt nie fehl.
• Ausgelöst über POST /processes/v1 mit einem Recipe (API-Schlüssel), das Cardholder Verification enthält. Sie wird pro API-Schlüssel über das Recipe (oder capabilities_enabled) aktiviert, nicht über das Feld flow.

Mögliche Antworten

Antwort	Bedeutung
approved	Die CPF-Nummer und die Karte gehören zur selben Person.
unsure	Entweder gibt es keinen gültigen Prozess zur Wiederverwendung, oder die Verifizierung selbst war nicht eindeutig.
(ausgelassen)	Die Verifizierung wurde innerhalb des synchronen Aufrufs nicht abgeschlossen. Das Feld cardholderVerification fehlt in der Antwort von Get Process, und status zeigt an, dass der Prozess sich noch in Verarbeitung befindet.

Verfügbarkeit

Oberfläche	Unterstützt
SDK (Android, iOS, Flutter)	❌ Reine Backend-Funktion, kein Erfassungsschritt
Web (iFrame, Redirect)	❌ Reine Backend-Funktion, kein Erfassungsschritt
API (headless, ohne SDK)	✅

Gültige Kombinationen

Cardholder Verification ist nicht Teil des vorkonfigurierten flow-Katalogs — sie wird direkt im Recipe des API-Schlüssels aktiviert (oder über capabilities_enabled, für Nicht-IDCloud-Schlüssel), unabhängig von den Flows in Verfügbare Flows.

Anwendungsfälle, die diese Funktion verwenden

Es gibt noch keine veröffentlichten Anwendungsfälle, die auf diese Funktion verweisen.