Udostępnij przez


Personr (wersja zapoznawcza)

Tworzenie, weryfikowanie i pobieranie danych wnioskodawcy przy użyciu osoby. Bezproblemowe weryfikowanie tożsamości i wykrywanie złożonych oszustw.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Imię i nazwisko
adres URL https://personr.co/contact
Email help@personr.co
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://personr.co
Zasady ochrony prywatności https://personr.co/legals
Kategorie Dane

Osoba upraszcza weryfikację tożsamości, wykrywając złożone oszustwa, umożliwiając firmie przestrzeganie przepisów Know Your Customer (KYC) i anti-money laundering (AML). Łącznik umożliwia tworzenie, weryfikowanie i żądanie stanu oraz szczegółów wnioskodawcy.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności...

  • Aktywne/subskrybowane konto osoby. Jeśli nie masz obecnie subskrypcji, możesz to zrobić, przechodząc do https://personr.co konta lub logując się do swojego konta i wybierając plan.

Jak uzyskać poświadczenia

Należy wygenerować token elementu nośnego autoryzacji, który jest ważny przez jeden rok. W tym celu wyślij żądanie POST do https://enterprise.personr.co/api/1.1/wf/api-token-generate

Treść powinna zawierać adres e-mail i hasło konta. Interfejs API zwróci odpowiedź z tokenem elementu nośnego autoryzacji, tak jak w poniższym przykładzie:

{
  "status": "success",
  "response": {
    "token": "your_auth_token",
    "expires": "expiry_date_in_seconds"
  }
}

Podczas wprowadzania tokenu do łącznika podczas instalacji upewnij się, że przed tokenem dołączono wyraz Bearer: Bearer your_auth_token

Wprowadzenie do łącznika

Aby rozpocząć weryfikację pierwszego wnioskodawcy, wykonaj poniższą metodę.

Utwórz pierwszego kandydata.

Create an Applicant actionUżyj elementu , a następnie wprowadź wymagane szczegóły, takie jak ich adres e-mail, numer telefonu i przepływ, przez który chcesz przejść. Możesz również wprowadzić swoje imię i nazwisko (opcjonalnie).

Uwaga: Flow Name element powinien być zgodny z elementem utworzonym na platformie.

Możesz zweryfikować kandydata na dwa sposoby — podając im link weryfikacyjny lub bezpośrednio przekazać dokumenty w formacie base64.

Aby wygenerować link weryfikacji, użyj Create a Verification Link akcji i wprowadź identyfikator wnioskodawcy otrzymany z poprzedniego kroku. Link weryfikacyjny umożliwia wnioskodawcom przekazywanie swoich dokumentów zgodnie z wybranym przepływem.

W przypadku korzystania z linku weryfikacyjnego nie są wymagane żadne dalsze akcje, przetwarzanie jest uruchamiane automatycznie.


Aby bezpośrednio przekazać dokumenty do profilu wnioskodawcy, użyj Upload a Document akcji i wprowadź wymagane informacje — takie jak identyfikator wnioskodawcy, typ dokumentu, podtyp, kraj dokumentu, nazwa pliku i zawartość base64.

Po przekazaniu wymaganych dokumentów (z przodu i z tyłu) dla wybranego przepływu użyj Request an Applicant Check akcji w celu potwierdzenia i rozpoczęcia przetwarzania. Nie jest to wymagane, jeśli używasz metody linku weryfikacji — w miarę automatycznego uruchamiania przetwarzania.

Uwaga: nazwa pliku powinna zawierać rozszerzenie pliku, na przykład: id_card.jpg Ponadto zawartość base64 nie powinna zawierać typu pliku. Przykład: /9j/4AAQSkZJRgABAQAAAQABAAD...

Aby uzyskać więcej informacji na temat typów dokumentów i podtypów, zobacz naszą publiczną dokumentację tutaj: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd

Pobierz status wnioskodawcy i wyodrębnione informacje.

Proces weryfikacji zwykle trwa około 2 minut. Aby pobrać status wnioskodawcy, należy użyć Retrieve Applicant Status działania ze skorelowaniem identyfikatora wnioskodawcy.

Ta akcja zapewnia Approved etykiety odrzucenia lub lub Rejected oraz wyodrębnione informacje o dokumencie.

Pobierz szczegóły wnioskodawcy. (Opcjonalnie)

Podobnie jak w powyższym działaniu, Retrieve Applicant Details można pobrać dodatkowe informacje na temat wnioskodawcy, używając korelujące identyfikatora wnioskodawcy.

Znane problemy i ograniczenia

Weryfikacje nie będą kontynuowane, jeśli obraz jest bardzo rozmyty lub poza fokusem. Obsługujemy typy plików JPEG, PNG i PDF.

Typowe błędy i środki zaradcze

Jeśli podczas korzystania z Create an Applicant akcji wystąpi błąd, upewnij się, że nazwa przepływu jest zgodna z nazwą utworzoną na platformie.

Jeśli używasz Upload a Document akcji do przekazania obrazu selfie (jeśli przepływ wymaga), upewnij się, że typ dokumentu to SELFIE, a podtyp dokumentu ma wartość NULL.

Często zadawane pytania

W jaki sposób zweryfikowane są dane wnioskodawcy?

Po wyodrębnieniu dane wnioskodawcy są sprawdzane przy użyciu zweryfikowanych baz danych rządowych i komercyjnych, w tym nie tylko do spisu wyborczego, pojazdu, telco, śmierci i innych rejestrów.

Co to jest złożone wykrywanie oszustw lub manipulowanie cyfrowe?

Złożone wykrywanie oszustw lub wykrywanie manipulacji cyfrowej to proces sprawdzania, czy dokumenty zostały edytowane graficznie, sfałszowane lub zakupione bezprawnie online. Ten proces jest uruchamiany w tle na każdej weryfikacji i pomaga zapobiegać oszustwom przed jego wystąpieniem — chroni firmy i osoby fizyczne.

Czy możesz utworzyć przepływ niestandardowy, którego mogę użyć dla mojej firmy?

Absolutnie każda firma jest unikatowa (a więc każda weryfikacja). Skontaktuj się z naszym zespołem, który będzie mógł utworzyć niestandardowy przepływ dostosowany do Twoich wymagań.

Które kraje są obsługiwane w celu weryfikacji?

Weryfikujemy dokumenty i osoby fizyczne na całym świecie, od licencji kierowców do rachunków za usługi użyteczności publicznej, oświadczeń bankowych, a nawet korespondencji z władzami rządowymi - niezależnie od języka lub języka typescript.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Token autoryzacji securestring Wprowadź token elementu nośnego autoryzacji Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie statusu wnioskodawcy

Pobieranie stanu weryfikacji wnioskodawcy i ich szczegółów.

Pobieranie szczegółów wnioskodawcy

Pobierz szczegóły wnioskodawcy.

Przekazywanie dokumentów do wnioskodawcy

Przekaż dokumenty do wnioskodawcy z ciągiem base64.

Sprawdzanie wniosku o kandydata

Upewnij się, że wszystkie dokumenty są przekazywane i rozpocznij sprawdzanie.

Tworzenie linku weryfikacji

Utwórz link weryfikacji, aby łatwo przekazać dokumenty.

Tworzenie wnioskodawcy

Utwórz nowego wnioskodawcę weryfikacyjnego.

Pobieranie statusu wnioskodawcy

Pobieranie stanu weryfikacji wnioskodawcy i ich szczegółów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wnioskodawcy
applicantId string

identyfikator wnioskodawcy

Zwraca

Nazwa Ścieżka Typ Opis
stan
status string

stan

applicantStatus
response.applicantStatus string

applicantStatus

applicantActionStatus
response.applicantActionStatus string

applicantActionStatus

Data modyfikacji
response.result.Modified Date integer

Data modyfikacji

Data utworzenia
response.result.Created Date integer

Data utworzenia

Stworzone przez
response.result.Created By string

Stworzone przez

reviewAnswer
response.result.reviewAnswer string

reviewAnswer

kandydat
response.result.applicant string

kandydat

commentClient
response.result.commentClient string

commentClient

firma
response.result.company string

firma

commentModeration
response.result.commentModeration string

commentModeration

rejectLabels
response.result.rejectLabels array of string

rejectLabels

reviewRejectType
response.result.reviewRejectType string

reviewRejectType

weryfikacja
response.result.verification string

weryfikacja

_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

Pobieranie szczegółów wnioskodawcy

Pobierz szczegóły wnioskodawcy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wnioskodawcy
applicantId string

identyfikator wnioskodawcy

Zwraca

Nazwa Ścieżka Typ Opis
stan
status string

stan

e-mail
response.email string

e-mail

phone
response.phone string

phone

nameFirst (nazwa Pierwszy)
response.nameFirst string

nameFirst (nazwa Pierwszy)

NazwaOstatni
response.nameLast string

NazwaOstatni

tags
response.tags array of

tags

nazwa_przepływu
response.flowName string

nazwa_przepływu

stan
response.status string

stan

Przekazywanie dokumentów do wnioskodawcy

Przekaż dokumenty do wnioskodawcy z ciągiem base64.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wnioskodawcy
applicantId string

identyfikator wnioskodawcy

Typ dokumentu (np. ID_CARD)
docType string

docType

Podtyp dokumentu (np. FRONT_SIDE)
docSubType string

docSubType

Dokument country ISO (np. AUS)
docCountryISO string

docCountryISO

Nazwa pliku i rozszerzenie (np. document.jpeg)
filename string

filename

Zawartość pliku (ciąg Base64)
contents string

contents

Sprawdzanie wniosku o kandydata

Upewnij się, że wszystkie dokumenty są przekazywane i rozpocznij sprawdzanie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wnioskodawcy
applicantId string

identyfikator wnioskodawcy

Tworzenie linku weryfikacji

Utwórz link weryfikacji, aby łatwo przekazać dokumenty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wnioskodawcy
applicant string

kandydat

Zwraca

Nazwa Ścieżka Typ Opis
stan
status string

stan

verificationLink
response.verificationLink string

verificationLink

Tworzenie wnioskodawcy

Utwórz nowego wnioskodawcę weryfikacyjnego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail
email string

e-mail

Numer telefonu
phone string

phone

Imię
nameFirst string

nameFirst (nazwa Pierwszy)

Nazwisko
nameLast string

NazwaOstatni

Przepływ wnioskodawcy
flowName string

nazwa_przepływu

Zwraca

Nazwa Ścieżka Typ Opis
stan
status string

stan

identyfikator wnioskodawcy
response.applicantId string

identyfikator wnioskodawcy

e-mail
response.email string

e-mail

phone
response.phone string

phone

nameFirst (nazwa Pierwszy)
response.nameFirst string

nameFirst (nazwa Pierwszy)

NazwaOstatni
response.nameLast string

NazwaOstatni

nazwa_przepływu
response.flowName string

nazwa_przepływu

applicantStatus
response.applicantStatus string

applicantStatus