Personr (предварительная версия)
Создание, проверка и получение данных заявителей с помощью Personr. Без усилий проверьте личность и определите сложное мошенничество.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | ФИО |
| URL | https://personr.co/contact |
| Адрес электронной почты | help@personr.co |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://personr.co |
| Политика конфиденциальности | https://personr.co/legals |
| Категории | Данные |
Personr упрощает проверку личности при обнаружении сложного мошенничества, что позволяет вашему бизнесу соблюдать правила знают вашего клиента (KYC) и борьбы с отмыванием денег (AML). Соединитель позволяет создавать, проверять и запрашивать состояние и сведения о заявителе.
Предпосылки
Вам потребуется следующее, чтобы продолжить...
- Активная или подписанная учетная запись Personr. Если вы сейчас не подписаны, вы можете сделать это, перейдя https://personr.co или войдите в свою учетную запись и выбрав план.
Получение учетных данных
Необходимо создать маркер носителя авторизации, действительный в течение одного года. Для этого отправьте запрос POST в https://enterprise.personr.co/api/1.1/wf/api-token-generate
Текст должен содержать электронную почту и пароль учетной записи. API вернет ответ с маркером носителя авторизации, как показано в следующем примере:
{
"status": "success",
"response": {
"token": "your_auth_token",
"expires": "expiry_date_in_seconds"
}
}
При вводе маркера в соединитель во время установки убедитесь, что перед маркером будет включен слово носителя: Bearer your_auth_token
Начало работы с соединителем
Чтобы начать проверку первого заявителя, выполните приведенный ниже метод.
Создайте своего первого кандидата.
Create an Applicant actionИспользуйте и введите необходимые сведения, такие как их электронная почта, номер телефона и поток, который вы хотите пройти. Вы также можете ввести свое имя и фамилию (необязательно).
Примечание. Должен Flow Name соответствовать тому, который вы создали на платформе.
Создайте ссылку проверки или отправьте документы напрямую.
Вы можете проверить заявителя двумя способами : предоставив им ссылку на проверку или непосредственно отправив свои документы в формате base64.
Чтобы создать ссылку проверки, используйте Create a Verification Link действие и введите идентификатор кандидата, полученный на предыдущем шаге. Ссылка на проверку позволяет заявителям отправлять свои документы в соответствии с выбранным потоком.
Дальнейшие действия не требуются для проверки при использовании ссылки проверки, обработка запускается автоматически.
Чтобы напрямую отправить документы в профиль заявителя, используйте Upload a Document действие и введите необходимые сведения, такие как идентификатор кандидата, тип документа, подтип документа, страна документа, имя файла и содержимое base64.
После отправки необходимых документов (передней и задней) для выбранного потока используйте Request an Applicant Check действие, чтобы подтвердить и начать обработку. Это не обязательно, если вы используете метод ссылки проверки , так как обработка запускается автоматически.
Примечание. Имя файла должно включать расширение файла, например: id_card.jpg кроме того, содержимое base64 не должно включать тип файла. Например: /9j/4AAQSkZJRgABAQAAAQABAAD...
Дополнительные сведения о типах документов и подтипах см. в нашей общедоступной документации: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd
Получение статуса заявителя и извлеченная информация.
Обычно для обработки проверок требуется около 2 минут. Чтобы получить статус заявителя, используйте Retrieve Applicant Status действие с соответствующим заявителем Идентификатором.
Это действие предоставляет Approved или Rejected отвечает, метки отклонений и извлеченные сведения о документе.
Получение сведений о заявителе. (Необязательно)
Как и в приведенном выше действии, Retrieve Applicant Details вы можете получить дополнительную информацию о заявителе, используя коррелирующие идентификаторы заявителей.
Известные проблемы и ограничения
Проверки не будут продолжаться, если изображение является чрезвычайно размытым или вне фокуса. Мы поддерживаем типы файлов JPEG, PNG и PDF.
Распространенные ошибки и средства устранения неполадок
При использовании Create an Applicant действия, если вы получаете ошибку, убедитесь, что имя потока соответствует созданному на платформе.
При использовании Upload a Document действия для отправки образа селфи (если требуется поток), убедитесь, что тип документа имеет значение SELFIE, а подтип документа имеет значение NULL.
Часто задаваемые вопросы
Как проверяются данные заявителя?
После извлечения данные претендента проверяются с проверенными правительственными и коммерческими базами данных, включая, но не ограничивается избирательным списком, автомобилем, телко, смертью и другими реестрами.
Что такое сложное обнаружение мошенничества или цифровые манипуляции?
Сложное обнаружение мошенничества или обнаружение цифровых манипуляций — это процесс проверки, чтобы узнать, были ли документы графически редактированы, подделаны или приобретены в Интернете нелегитимно. Этот процесс выполняется в фоновом режиме на каждой проверке и помогает предотвратить мошенничество до его возникновения - защита предприятий и лиц.
Вы можете создать пользовательский поток, который можно использовать для моего бизнеса?
Абсолютно каждый бизнес является уникальным (и так является каждой проверкой). Обратитесь к нашей команде, которая сможет создать настраиваемый поток, адаптированный к вашим требованиям.
Какие страны поддерживаются для проверки?
Мы проверяем документы и физических лиц, от лицензий водителей до счетов за коммунальные услуги, банковские выписки и даже переписку с государственными органами независимо от языка или typescript.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Маркер авторизации | securestring | Введите маркер носителя авторизации | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка документов заявителю |
Отправьте документы заявителю с строкой base64. |
| Получение сведений о кандидате |
Получение сведений о заявителе. |
| Получение статуса кандидата |
Получение статуса проверки заявителя и их подробностей. |
| Проверка претендента на запрос |
Подтвердите отправку всех документов и запустите проверку. |
| Создание кандидата |
Создайте нового претендента на проверку. |
| Создание ссылки проверки |
Создайте ссылку проверки для простой отправки документов. |
Отправка документов заявителю
Отправьте документы заявителю с строкой base64.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор кандидата
|
applicantId | string |
applicantId |
|
|
Тип документа (например, ID_CARD)
|
docType | string |
docType |
|
|
Подтип документа (например, FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
ISO страны документа (например, AUS)
|
docCountryISO | string |
docCountryISO |
|
|
Имя файла + расширение (например, document.jpeg)
|
filename | string |
filename |
|
|
Содержимое файла (строка Base64)
|
contents | string |
contents |
Получение сведений о кандидате
Получение сведений о заявителе.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор кандидата
|
applicantId | string |
applicantId |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | string |
статус |
|
электронная почта
|
response.email | string |
электронная почта |
|
phone
|
response.phone | string |
phone |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
имяПоследний
|
response.nameLast | string |
имяПоследний |
|
tags
|
response.tags | array of |
tags |
|
flowName
|
response.flowName | string |
flowName |
|
статус
|
response.status | string |
статус |
Получение статуса кандидата
Получение статуса проверки заявителя и их подробностей.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор кандидата
|
applicantId | string |
applicantId |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | string |
статус |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
|
заявительActionStatus
|
response.applicantActionStatus | string |
заявительActionStatus |
|
Дата изменения
|
response.result.Modified Date | integer |
Дата изменения |
|
Дата создания
|
response.result.Created Date | integer |
Дата создания |
|
Создано автором
|
response.result.Created By | string |
Создано автором |
|
reviewAnswer
|
response.result.reviewAnswer | string |
reviewAnswer |
|
проситель
|
response.result.applicant | string |
проситель |
|
commentClient
|
response.result.commentClient | string |
commentClient |
|
компания
|
response.result.company | string |
компания |
|
commentModeration
|
response.result.commentModeration | string |
commentModeration |
|
отклонитьLabels
|
response.result.rejectLabels | array of string |
отклонитьLabels |
|
reviewRejectType
|
response.result.reviewRejectType | string |
reviewRejectType |
|
проверка
|
response.result.verification | string |
проверка |
|
_id
|
response.result._id | string |
_id |
|
extractedFirstName
|
response.extractedFirstName | string |
extractedFirstName |
|
extractedLastName
|
response.extractedLastName | string |
extractedLastName |
|
extractedBirthDate
|
response.extractedBirthDate | string |
extractedBirthDate |
|
documentCountry
|
response.documentCountry | string |
documentCountry |
|
extractedStreetNum
|
response.extractedStreetNum | string |
extractedStreetNum |
|
extractedStreet
|
response.extractedStreet | string |
extractedStreet |
|
extractedCity
|
response.extractedCity | string |
extractedCity |
|
extractedState
|
response.extractedState | string |
extractedState |
|
extractedPostCode
|
response.extractedPostCode | string |
extractedPostCode |
Проверка претендента на запрос
Подтвердите отправку всех документов и запустите проверку.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор кандидата
|
applicantId | string |
applicantId |
Создание кандидата
Создайте нового претендента на проверку.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Электронная почта
|
string |
электронная почта |
||
|
Номер телефона
|
phone | string |
phone |
|
|
Имя (Первое имя)
|
nameFirst | string |
nameFirst |
|
|
Фамилия
|
nameLast | string |
имяПоследний |
|
|
Поток заявителей
|
flowName | string |
flowName |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | string |
статус |
|
applicantId
|
response.applicantId | string |
applicantId |
|
электронная почта
|
response.email | string |
электронная почта |
|
phone
|
response.phone | string |
phone |
|
nameFirst
|
response.nameFirst | string |
nameFirst |
|
имяПоследний
|
response.nameLast | string |
имяПоследний |
|
flowName
|
response.flowName | string |
flowName |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
Создание ссылки проверки
Создайте ссылку проверки для простой отправки документов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор кандидата
|
applicant | string |
проситель |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | string |
статус |
|
authenticationLink
|
response.verificationLink | string |
authenticationLink |