Personr (Preview)

Create, verify and retrieve applicant data using Personr. Effortlessly verify identity and detect complex fraud.

This connector is available in the following products and regions:

Personr simplifies identity verification whilst detecting complex fraud, allowing your business to comply with Know Your Customer (KYC) and Anti-Money Laundering (AML) regulations. The connector allows you to create, verify and request the status and details of an applicant.

Prerequisites

You will need the following to proceed...

• An active/subscribed Personr account. If you aren't currently subscribed, you can do so by going to https://personr.co or by logging into your account and choosing a plan.

How to get credentials

You will need to generate an Authorization Bearer token, which is valid for one year. To do this, send a POST request to https://enterprise.personr.co/api/1.1/wf/api-token-generate

The body should include your account email and password. The API will return a response with your Authorization Bearer token, like in the example below:

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

When entering the token into the connector during setup, ensure the word Bearer is included before the token: Bearer your_auth_token

Get started with your connector

To start verifying your first applicant, follow the method below.

Create your first applicant.

Use the Create an Applicant action, and enter the required details - such as their email, phone number and the flow you'd like them to go through. You can also enter their first name and last name (optional).

Note: the Flow Name should match one that you've created on the platform.

Create a verification link, or directly upload documents.

You can verify an applicant two ways - by providing them a verification link or directly upload their documents in base64 format.

To generate a verification link, use the Create a Verification Link action, and enter the Applicant ID you received from the previous step. The verification link allows applicants to upload their documents according to your chosen flow.

No further actions are required for verification when using a verification link, processing starts automatically.

To directly upload documents to an applicant profile, use the Upload a Document action and enter the required information - such as the Applicant ID, Document Type, Sub Type, Document Country, File Name and the base64 contents.

Once you have uploaded the required documents (front and back side) for your chosen flow, use the Request an Applicant Check action in order to confirm and start the processing. This is not required if you are using the verification link method - as processing starts automatically.

Note: the file name should include the file extension, for example: id_card.jpg Additionally, the base64 contents should not include the filetype. For example: /9j/4AAQSkZJRgABAQAAAQABAAD...

For more information on document types and sub types, see our public documentation here: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd

Retrieve an applicant's status and extracted information.

Verifications typically take ~2 minutes to process. To retrieve an applicant's status, use the Retrieve Applicant Status action with the correlating applicantId.

This action provides an Approved or Rejected answer, rejection labels and extracted document information.

Retrieve an applicant's details. (Optional)

Similar to the action above, Retrieve Applicant Details allows you to retrieve additional information on an applicant, using the correlating applicantId.

Known issues and limitations

Verifications won't proceed if the image is extremely blurry or out-of-focus. We support JPEG, PNG and PDF file types.

Common errors and remedies

When using the Create an Applicant action, if you receive an error, make sure your Flow Name matches the one that you have created on the platform.

When using the Upload a Document action to upload a selfie image (if your flow requires), ensure the Document Type is 'SELFIE' and Document SubType is 'NULL'.

FAQ

How is the data of an applicant verified?

Once extracted, applicant data is checked with vetted government and commercial databases including but not limited to electoral roll, vehicle, telco, death and other registries.

What is complex fraud detection or digital manipulation?

Complex fraud detection, or digital manipulation detection, is the process of checking to see if documents have been graphically edited, forged or purchased illegitimately online. This process is run in the background on every verification and helps prevent fraud before it occurs - protecting businesses and individuals.

Are you able to create a custom flow I can use for my business?

Absolutely, each business is unique (and so is every verification). Get in touch with our team, who will be able to create a custom flow tailored to your requirements.

Which countries are supported for a verification?

We verify documents and individuals globally, from drivers licenses to utility bills, bank statements and even correspondence with government authorities - regardless of language or typescript.

Creating a connection

The connector supports the following authentication types:

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Actions

Create Applicant

Create Verification Link

Request Applicant Check

Retrieve Applicant Details

Retrieve Applicant Status

Upload Documents to an Applicant