Cardholder Verification
Cardholder Verification подтверждает, что карта принадлежит заявленному владельцу — полностью на back-end, без визуального этапа захвата.
Что делает
Подтверждает, что CPF и предъявленная карта принадлежат одному и тому же человеку — проверка владения без предъявления карты (card-not-present). Она повторно использует ранее проверенный процесс (на который ссылается его id, referenceProcessId) вместе с CPF и данными карты человека (bin/last4), чтобы ответить на проверку напрямую, без выполнения нового этапа захвата.
Эта возможность представляет с обой другую поверхность интеграции по сравнению с продуктом Верификация без предъявления карты.
Входные данные
- Тип документа, отправляемый через
subject.duiType(на данный момент толькоDUI_TYPE_BR_CPF), и значение CPF черезsubject.code. card:bin(первые 6 или 8 цифр карты) иlast4(последние 4 цифры),nameявляется необязательным.referenceProcessId— id ранее проверенного процесса, который повторно используется, в котором личность этого человека уже была подтверждена (Проверка личности или Проверка живости). Текущая версия этой возможности основана на повторном использовании: без этого поля проверка (gate) никогда не запускается, и ответ по умолчанию — стандартный результатunsure; сам запрос при этом никогда не завершается ошибкой.- Запускается через
POST /processes/v1с Recipe (API-ключом), который включает Cardholder Verification. Она включается для каждого API-ключа через Recipe (илиcapabilities_enabled), а не через полеflow.
Возможные ответы
| Ответ | Значение |
|---|---|
approved | CPF и карта принадлежат одному и тому же человеку. |
unsure | Либо нет действительного процесса для повторного использования, либо сама проверка была неубедительной. |
| (отсутствует) | Проверка не завершилась в рамках синхронного вызова. Поле cardholderVerification отсутствует в ответе Получение процесса, а status отражает, что процесс всё ещё обрабатывается. |
Доступность
| Поверхность | Поддерживается |
|---|---|
| SDK (Android, iOS, Flutter) | ❌ Только back-end возможность, без этапа захвата |
| Web (iFrame, Redirect) | ❌ Только back-end возможность, без этапа захвата |
| API (headless, без SDK) | ✅ |
Допустимые комбинации
Cardholder Verification не входит в предварительно составленный каталог flow — она включается непосредственно в Recipe API-ключа (или через capabilities_enabled для ключей, не относящихся к IDCloud), независимо от потоков в разделе Доступные потоки.
Сценарии использования, использующие эту возможность
Пока нет опубликованных сценариев использования, ссылающихся на эту возможность.