Partilhar via


Personr (Pré-visualização)

Crie, verifique e recupere dados de candidatos usando o Personr. Verifique facilmente a identidade e detete fraudes complexas.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Nome completo
URL https://personr.co/contact
Email help@personr.co
Metadados do conector
Editora Microsoft
Sítio Web https://personr.co
Política de privacidade https://personr.co/legals
Categorias Data

O Personr simplifica a verificação de identidade enquanto deteta fraudes complexas, permitindo que sua empresa cumpra as regulamentações Conheça Seu Cliente (KYC) e Antilavagem de Dinheiro (AML). O conector permite criar, verificar e solicitar o status e os detalhes de um candidato.

Pré-requisitos

Você precisará do seguinte para prosseguir...

  • Uma conta Personr ativa/subscrita. Se ainda não está inscrito, pode fazê-lo acedendo ou https://personr.co iniciando sessão na sua conta e escolhendo um plano.

Como obter credenciais

Você precisará gerar um token de Portador de Autorização, que é válido por um ano. Para fazer isso, envie uma solicitação POST para https://enterprise.personr.co/api/1.1/wf/api-token-generate

O corpo deve incluir o e-mail e a senha da sua conta. A API retornará uma resposta com seu token de Portador de Autorização, como no exemplo abaixo:

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

Ao inserir o token no conector durante a configuração, verifique se a palavra Portador está incluída antes do token: Bearer your_auth_token

Introdução ao conector

Para começar a verificar o seu primeiro candidato, siga o método abaixo.

Crie o seu primeiro candidato.

Use o Create an Applicant action, e insira os detalhes necessários, como e-mail, número de telefone e o fluxo pelo qual você gostaria que eles passassem. Você também pode inserir seu nome e sobrenome (opcional).

Observação: o deve corresponder ao Flow Name que você criou na plataforma.

Você pode verificar um candidato de duas maneiras: fornecendo-lhe um link de verificação ou carregando diretamente seus documentos no formato base64.

Para gerar um link de verificação, use a Create a Verification Link ação e insira o ID do Candidato que você recebeu da etapa anterior. O link de verificação permite que os candidatos carreguem seus documentos de acordo com o fluxo escolhido.

Nenhuma ação adicional é necessária para a verificação ao usar um link de verificação, o processamento é iniciado automaticamente.


Para carregar diretamente documentos para um perfil de candidato, use a Upload a Document ação e insira as informações necessárias - como ID do candidato, tipo de documento, subtipo, país do documento, nome do arquivo e o conteúdo da base64.

Depois de carregar os documentos necessários (frente e verso) para o fluxo escolhido, use a Request an Applicant Check ação para confirmar e iniciar o processamento. Isso não é necessário se você estiver usando o método de link de verificação - pois o processamento começa automaticamente.

Nota: o nome do arquivo deve incluir a extensão do arquivo, por exemplo: id_card.jpg Além disso, o conteúdo base64 não deve incluir o tipo de arquivo. Por exemplo: /9j/4AAQSkZJRgABAQAAAQABAAD...

Para obter mais informações sobre tipos e subtipos de documentos, consulte nossa documentação pública aqui: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd

Recupere o status de um candidato e as informações extraídas.

As verificações normalmente levam ~2 minutos para serem processadas. Para recuperar o status de um candidato, use a Retrieve Applicant Status ação com o applicantId correlacionado.

Esta ação fornece uma Approved ou Rejected resposta, rótulos de rejeição e informações extraídas do documento.

Recuperar os dados de um candidato. (Opcional)

Semelhante à ação acima, Retrieve Applicant Details permite que você recupere informações adicionais sobre um candidato, usando o applicantId correlacionado.

Problemas conhecidos e limitações

As verificações não prosseguirão se a imagem estiver extremamente desfocada ou fora de foco. Suportamos os tipos de ficheiros JPEG, PNG e PDF.

Erros e soluções comuns

Ao usar a Create an Applicant ação, se você receber um erro, verifique se o Nome do Fluxo corresponde ao que você criou na plataforma.

Ao usar a Upload a Document ação para carregar uma imagem selfie (se o seu fluxo exigir), verifique se o Tipo de documento é 'SELFIE' e o Subtipo de documento é 'NULL'.

FAQ

Como são verificados os dados de um candidato?

Uma vez extraídos, os dados dos candidatos são verificados com bases de dados governamentais e comerciais examinadas, incluindo, entre outros, cadernos eleitorais, veículos, telecomunicações, óbitos e outros registos.

O que é deteção de fraude complexa ou manipulação digital?

Deteção de fraude complexa, ou deteção de manipulação digital, é o processo de verificação para ver se os documentos foram graficamente editados, falsificados ou comprados ilegitimamente on-line. Esse processo é executado em segundo plano em cada verificação e ajuda a prevenir fraudes antes que elas ocorram, protegendo empresas e indivíduos.

Você é capaz de criar um fluxo personalizado que eu possa usar para o meu negócio?

Absolutamente, cada negócio é único (assim como cada verificação). Entre em contacto com a nossa equipa, que poderá criar um fluxo personalizado à medida das suas necessidades.

Que países são suportados para uma verificação?

Verificamos documentos e indivíduos em todo o mundo, desde cartas de condução a faturas de serviços públicos, extratos bancários e até correspondência com autoridades governamentais - independentemente do idioma ou datilografia.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Token de autorização securestring Introduza o seu Token de Portador de Autorização Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Carregar documentos para um candidato

Carregue documentos para um candidato com uma cadeia de caracteres base64.

Criar candidato

Crie um novo requerente de verificação.

Criar link de verificação

Crie um link de verificação para carregar documentos facilmente.

Recuperar detalhes do candidato

Recuperar os dados de um candidato.

Recuperar o status do candidato

Recupere o status de verificação de um candidato e seus detalhes.

Solicitar verificação do candidato

Confirme se todos os documentos foram carregados e inicie a verificação.

Carregar documentos para um candidato

Carregue documentos para um candidato com uma cadeia de caracteres base64.

Parâmetros

Name Chave Necessário Tipo Description
ID do candidato
applicantId string

ID do requerente

Tipo de documento (ex. ID_CARD)
docType string

docType

Subtipo de documento (ex. FRONT_SIDE)
docSubType string

docSubType

Documento ISO do país (por exemplo, AUS)
docCountryISO string

docPaísISO

Nome do arquivo + extensão (por exemplo, document.jpeg)
filename string

filename

Conteúdo do arquivo (cadeia de caracteres Base64)
contents string

contents

Criar candidato

Crie um novo requerente de verificação.

Parâmetros

Name Chave Necessário Tipo Description
Endereço de E-mail
email string

e-mail

Número de Telefone
phone string

phone

Nome Próprio
nameFirst string

nomePrimeiro

Apelido
nameLast string

nomeÚltimo

Fluxo de candidatos
flowName string

Nome do fluxo

Devoluções

Name Caminho Tipo Description
estado
status string

estado

ID do requerente
response.applicantId string

ID do requerente

e-mail
response.email string

e-mail

phone
response.phone string

phone

nomePrimeiro
response.nameFirst string

nomePrimeiro

nomeÚltimo
response.nameLast string

nomeÚltimo

Nome do fluxo
response.flowName string

Nome do fluxo

Estatuto do requerente
response.applicantStatus string

Estatuto do requerente

Crie um link de verificação para carregar documentos facilmente.

Parâmetros

Name Chave Necessário Tipo Description
ID do candidato
applicant string

requerente

Devoluções

Name Caminho Tipo Description
estado
status string

estado

verificaçãoLink
response.verificationLink string

verificaçãoLink

Recuperar detalhes do candidato

Recuperar os dados de um candidato.

Parâmetros

Name Chave Necessário Tipo Description
ID do candidato
applicantId string

ID do requerente

Devoluções

Name Caminho Tipo Description
estado
status string

estado

e-mail
response.email string

e-mail

phone
response.phone string

phone

nomePrimeiro
response.nameFirst string

nomePrimeiro

nomeÚltimo
response.nameLast string

nomeÚltimo

tags
response.tags array of

tags

Nome do fluxo
response.flowName string

Nome do fluxo

estado
response.status string

estado

Recuperar o status do candidato

Recupere o status de verificação de um candidato e seus detalhes.

Parâmetros

Name Chave Necessário Tipo Description
ID do candidato
applicantId string

ID do requerente

Devoluções

Name Caminho Tipo Description
estado
status string

estado

Estatuto do requerente
response.applicantStatus string

Estatuto do requerente

candidatoAçãoStatus
response.applicantActionStatus string

candidatoAçãoStatus

Data de Modificação
response.result.Modified Date integer

Data de Modificação

Data de criação
response.result.Created Date integer

Data de criação

Criado por
response.result.Created By string

Criado por

revisãoResposta
response.result.reviewAnswer string

revisãoResposta

requerente
response.result.applicant string

requerente

commentClient
response.result.commentClient string

commentClient

Companhia
response.result.company string

Companhia

comentárioModeração
response.result.commentModeration string

comentárioModeração

rejectLabels
response.result.rejectLabels array of string

rejectLabels

reviewRejectType
response.result.reviewRejectType string

reviewRejectType

verificação
response.result.verification string

verificação

_id
response.result._id string

_id

extractedFirstName
response.extractedFirstName string

extractedFirstName

extractedLastName
response.extractedLastName string

extractedLastName

extractedBirthDate
response.extractedBirthDate string

extractedBirthDate

documentoPaís
response.documentCountry string

documentoPaís

extraídoStreetNum
response.extractedStreetNum string

extraídoStreetNum

extraídoRua
response.extractedStreet string

extraídoRua

extraídoCidade extraída
response.extractedCity string

extraídoCidade extraída

extraídoEstado
response.extractedState string

extraídoEstado

extractedCódigo Postal
response.extractedPostCode string

extractedCódigo Postal

Solicitar verificação do candidato

Confirme se todos os documentos foram carregados e inicie a verificação.

Parâmetros

Name Chave Necessário Tipo Description
ID do candidato
applicantId string

ID do requerente