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

Создание кандидата

Создайте нового претендента на проверку.

Параметры

Имя Ключ Обязательно Тип Описание
Электронная почта
email 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