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 |
| 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.
Utwórz link weryfikacyjny lub bezpośrednio przekaż dokumenty.
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 |
|
|
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
|
string |
|
||
|
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 |
|
|
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 |