Delen via


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.

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
email 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