Personr (preview)
Gegevens van aanvragers maken, verifiëren en ophalen met Behulp van Personr. Controleer moeiteloos de identiteit en detecteer complexe fraude.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Volledige naam |
| URL | https://personr.co/contact |
| E-mailen | help@personr.co |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://personr.co |
| Privacybeleid | https://personr.co/legals |
| Categorieën | Gegevens |
Personr vereenvoudigt identiteitsverificatie tijdens het detecteren van complexe fraude, zodat uw bedrijf voldoet aan de regels Know Your Customer (KYC) en Anti-Money Laundering (AML). Met de connector kunt u de status en details van een aanvrager maken, verifiëren en aanvragen.
Vereiste voorwaarden
U hebt het volgende nodig om door te gaan...
- Een actief/geabonneerd Personr-account. Als u momenteel niet bent geabonneerd, kunt u dit doen door naar https://personr.co of door u aan te melden bij uw account en een abonnement te kiezen.
Referenties ophalen
U moet een Bearer-token voor autorisatie genereren, dat één jaar geldig is. Hiervoor verzendt u een POST-aanvraag naar https://enterprise.personr.co/api/1.1/wf/api-token-generate
De hoofdtekst moet het e-mailadres en wachtwoord van uw account bevatten. De API retourneert een antwoord met uw Authorization Bearer-token, zoals in het onderstaande voorbeeld:
{
"status": "success",
"response": {
"token": "your_auth_token",
"expires": "expiry_date_in_seconds"
}
}
Wanneer u het token tijdens de installatie in de connector invoert, moet u ervoor zorgen dat het woord Bearer vóór het token wordt opgenomen: Bearer your_auth_token
Aan de slag met uw connector
Volg de onderstaande methode om uw eerste aanvrager te verifiëren.
Maak uw eerste aanvrager.
Gebruik de Create an Applicant actionen voer de vereiste gegevens in, zoals hun e-mailadres, telefoonnummer en de stroom die u wilt doorlopen. U kunt ook hun voornaam en achternaam invoeren (optioneel).
Opmerking: de Flow Name moet overeenkomen met het platform dat u hebt gemaakt.
Maak een verificatiekoppeling of upload rechtstreeks documenten.
U kunt een aanvrager op twee manieren verifiëren door hen een verificatiekoppeling op te geven of hun documenten rechtstreeks te uploaden in de base64-indeling.
Als u een verificatiekoppeling wilt genereren, gebruikt u de Create a Verification Link actie en voert u de aanvrager-id in die u hebt ontvangen uit de vorige stap. Met de verificatiekoppeling kunnen aanvragers hun documenten uploaden volgens de door u gekozen stroom.
Er zijn geen verdere acties vereist voor verificatie bij het gebruik van een verificatiekoppeling. De verwerking wordt automatisch gestart.
Als u documenten rechtstreeks wilt uploaden naar een aanvragerprofiel, gebruikt u de Upload a Document actie en voert u de vereiste gegevens in, zoals de aanvrager-id, het documenttype, het subtype, het land van het document, de bestandsnaam en de inhoud van base64.
Zodra u de vereiste documenten (voor- en achterzijde) voor de gekozen stroom hebt geüpload, gebruikt u de Request an Applicant Check actie om de verwerking te bevestigen en te starten. Dit is niet vereist als u de verificatiekoppelingsmethode gebruikt, omdat de verwerking automatisch wordt gestart.
Opmerking: de bestandsnaam moet de bestandsextensie bevatten, bijvoorbeeld: id_card.jpg Daarnaast mag de base64-inhoud het bestandstype niet bevatten. Bijvoorbeeld: /9j/4AAQSkZJRgABAQAAAQABAAD...
Zie onze openbare documentatie hier voor meer informatie over documenttypen en subtypen: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd
Haal de status van een aanvrager en geëxtraheerde informatie op.
Het verwerken van verificaties duurt doorgaans ongeveer 2 minuten. Als u de status van een aanvrager wilt ophalen, gebruikt u de Retrieve Applicant Status actie met de correlerende aanvragerId.
Deze actie bevat een Approved of Rejected meer antwoorden, afwijzingslabels en geëxtraheerde documentgegevens.
Haal de gegevens van een aanvrager op. (Optioneel)
Net als bij de bovenstaande Retrieve Applicant Details actie kunt u aanvullende informatie over een aanvrager ophalen met behulp van de correlerende aanvragerId.
Bekende problemen en beperkingen
Verificaties gaan niet verder als de afbeelding extreem wazig of onscherp is. We ondersteunen JPEG-, PNG- en PDF-bestandstypen.
Veelvoorkomende fouten en oplossingen
Als u de Create an Applicant actie gebruikt, controleert u of uw stroomnaam overeenkomt met de naam die u op het platform hebt gemaakt.
Wanneer u de Upload a Document actie gebruikt om een selfie-afbeelding te uploaden (als uw stroom vereist is), controleert u of het documenttype 'SELFIE' is en het documentsubtype null is.
Veelgestelde vragen
Hoe worden de gegevens van een aanvrager geverifieerd?
Zodra deze gegevens zijn geëxtraheerd, worden aanvragergegevens gecontroleerd met gecontroleerde overheids- en commerciële databases, waaronder maar niet beperkt tot verkiezingsroll, voertuig, telco, dood en andere registers.
Wat is complexe fraudedetectie of digitale manipulatie?
Complexe fraudedetectie of digitale manipulatiedetectie is het proces om te controleren of documenten grafisch zijn bewerkt, vervalst of ongevraagd online zijn gekocht. Dit proces wordt op de achtergrond uitgevoerd op elke verificatie en helpt fraude te voorkomen voordat het plaatsvindt: het beschermen van bedrijven en individuen.
Kunt u een aangepaste stroom maken die ik voor mijn bedrijf kan gebruiken?
Absoluut, elk bedrijf is uniek (en dus elke verificatie). Neem contact op met ons team, die een aangepaste stroom kan maken die is afgestemd op uw behoeften.
Welke landen worden ondersteund voor een verificatie?
We verifiëren documenten en individuen wereldwijd, van bestuurderslicenties tot nutsrekeningen, bankafschriften en zelfs correspondentie met overheidsinstanties, ongeacht taal of typescript.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Autorisatietoken | beveiligde string | Voer uw Autorisatie Bearer-token in | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Aanvrager maken |
Maak een nieuwe verificatieaanvrager. |
| Controle aanvrager aanvragen |
Controleer of alle documenten zijn geüpload en start de controle. |
| Details van aanvrager ophalen |
Haal de gegevens van een aanvrager op. |
| Documenten uploaden naar een aanvrager |
Documenten uploaden naar een aanvrager met een base64-tekenreeks. |
| Status van aanvrager ophalen |
Haal de verificatiestatus van een aanvrager en hun gegevens op. |
| Verificatiekoppeling maken |
Maak een verificatiekoppeling om eenvoudig documenten te uploaden. |
Aanvrager maken
Maak een nieuwe verificatieaanvrager.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailadres
|
string |
e-mailadres |
||
|
Telefoonnummer
|
phone | string |
phone |
|
|
Voornaam
|
nameFirst | string |
naamVoornaam |
|
|
Achternaam
|
nameLast | string |
naamLaatste |
|
|
Stroom van aanvrager
|
flowName | string |
flowNaam |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
status |
|
aanvragerId
|
response.applicantId | string |
aanvragerId |
|
e-mailadres
|
response.email | string |
e-mailadres |
|
phone
|
response.phone | string |
phone |
|
naamVoornaam
|
response.nameFirst | string |
naamVoornaam |
|
naamLaatste
|
response.nameLast | string |
naamLaatste |
|
flowNaam
|
response.flowName | string |
flowNaam |
|
aanvragerStatus
|
response.applicantStatus | string |
aanvragerStatus |
Controle aanvrager aanvragen
Controleer of alle documenten zijn geüpload en start de controle.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
applicantId | string |
aanvragerId |
Details van aanvrager ophalen
Haal de gegevens van een aanvrager op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
applicantId | string |
aanvragerId |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
status |
|
e-mailadres
|
response.email | string |
e-mailadres |
|
phone
|
response.phone | string |
phone |
|
naamVoornaam
|
response.nameFirst | string |
naamVoornaam |
|
naamLaatste
|
response.nameLast | string |
naamLaatste |
|
tags
|
response.tags | array of |
tags |
|
flowNaam
|
response.flowName | string |
flowNaam |
|
status
|
response.status | string |
status |
Documenten uploaden naar een aanvrager
Documenten uploaden naar een aanvrager met een base64-tekenreeks.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
applicantId | string |
aanvragerId |
|
|
Documenttype (bijvoorbeeld ID_CARD)
|
docType | string |
docType |
|
|
Documentsubtype (bijvoorbeeld FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
Document Land ISO (bijvoorbeeld AUS)
|
docCountryISO | string |
docCountryISO |
|
|
Bestandsnaam + extensie (bijvoorbeeld document.jpeg)
|
filename | string |
filename |
|
|
Bestandsinhoud (Base64-tekenreeks)
|
contents | string |
contents |
Status van aanvrager ophalen
Haal de verificatiestatus van een aanvrager en hun gegevens op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
applicantId | string |
aanvragerId |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
status |
|
aanvragerStatus
|
response.applicantStatus | string |
aanvragerStatus |
|
aanvragerActionStatus
|
response.applicantActionStatus | string |
aanvragerActionStatus |
|
Gewijzigd op
|
response.result.Modified Date | integer |
Gewijzigd op |
|
Aanmaakdatum
|
response.result.Created Date | integer |
Aanmaakdatum |
|
Gemaakt door
|
response.result.Created By | string |
Gemaakt door |
|
reviewAnswer
|
response.result.reviewAnswer | string |
reviewAnswer |
|
aanvrager
|
response.result.applicant | string |
aanvrager |
|
commentClient
|
response.result.commentClient | string |
commentClient |
|
bedrijf
|
response.result.company | string |
bedrijf |
|
commentModeration
|
response.result.commentModeration | string |
commentModeration |
|
rejectLabels
|
response.result.rejectLabels | array of string |
rejectLabels |
|
reviewRejectType
|
response.result.reviewRejectType | string |
reviewRejectType |
|
verificatie
|
response.result.verification | string |
verificatie |
|
_id
|
response.result._id | string |
_id |
|
geëxtraheerdeFirstName
|
response.extractedFirstName | string |
geëxtraheerdeFirstName |
|
extractLastName
|
response.extractedLastName | string |
extractLastName |
|
extractedBirthDate
|
response.extractedBirthDate | string |
extractedBirthDate |
|
documentCountry
|
response.documentCountry | string |
documentCountry |
|
geëxtraheerdStreetNum
|
response.extractedStreetNum | string |
geëxtraheerdStreetNum |
|
geëxtraheerdStraat
|
response.extractedStreet | string |
geëxtraheerdStraat |
|
extractedCity
|
response.extractedCity | string |
extractedCity |
|
extractedState
|
response.extractedState | string |
extractedState |
|
extractedPostCode
|
response.extractedPostCode | string |
extractedPostCode |
Verificatiekoppeling maken
Maak een verificatiekoppeling om eenvoudig documenten te uploaden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
applicant | string |
aanvrager |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
status
|
status | string |
status |
|
verificationLink
|
response.verificationLink | string |
verificationLink |