Personr (versión preliminar)
Cree, compruebe y recupere los datos del solicitante mediante Personr. Compruebe sin esfuerzo la identidad y detecte fraudes complejos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Nombre completo |
| URL | https://personr.co/contact |
| Correo Electrónico | help@personr.co |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://personr.co |
| Directiva de privacidad | https://personr.co/legals |
| Categorías | Data |
Personr simplifica la verificación de identidad al detectar fraudes complejos, lo que permite a su empresa cumplir con las regulaciones Know Your Customer (KYC) y Anti-Money Laundering (AML). El conector permite crear, comprobar y solicitar el estado y los detalles de un solicitante.
Prerrequisitos
Necesitará lo siguiente para continuar...
- Una cuenta activa o suscrita de Personr. Si no está suscrito actualmente, puede hacerlo si va a https://personr.co o inicia sesión en su cuenta y elige un plan.
Obtención de credenciales
Deberá generar un token de portador de autorización, que es válido durante un año. Para ello, envíe una solicitud POST a https://enterprise.personr.co/api/1.1/wf/api-token-generate
El cuerpo debe incluir el correo electrónico y la contraseña de la cuenta. La API devolverá una respuesta con el token de portador de autorización, como en el ejemplo siguiente:
{
"status": "success",
"response": {
"token": "your_auth_token",
"expires": "expiry_date_in_seconds"
}
}
Al escribir el token en el conector durante la instalación, asegúrese de que la palabra Bearer se incluye antes del token: Bearer your_auth_token
Introducción al conector
Para empezar a comprobar su primer solicitante, siga el método siguiente.
Cree su primer solicitante.
Create an Applicant actionUse y escriba los detalles necesarios, como su correo electrónico, el número de teléfono y el flujo que desea que pasen. También puede escribir su nombre y apellidos (opcional).
Nota: Flow Name debe coincidir con una que haya creado en la plataforma.
Cree un vínculo de verificación o cargue directamente documentos.
Puede comprobar dos maneras a un solicitante, ya sea proporcionando un vínculo de verificación o cargando directamente sus documentos en formato base64.
Para generar un vínculo de verificación, use la Create a Verification Link acción y escriba el identificador de solicitante que recibió del paso anterior. El vínculo de verificación permite a los solicitantes cargar sus documentos según su flujo elegido.
No se requieren más acciones para la comprobación cuando se usa un vínculo de verificación, el procesamiento se inicia automáticamente.
Para cargar directamente documentos en un perfil de solicitante, use la Upload a Document acción y escriba la información necesaria, como el identificador de solicitante, el tipo de documento, el subtipo, el país del documento, el nombre de archivo y el contenido de base64.
Una vez que haya cargado los documentos necesarios (front-and back-side) para el flujo elegido, use la Request an Applicant Check acción para confirmar e iniciar el procesamiento. Esto no es necesario si usa el método de vínculo de verificación, ya que el procesamiento se inicia automáticamente.
Nota: El nombre de archivo debe incluir la extensión de archivo, por ejemplo: id_card.jpg Además, el contenido de Base64 no debe incluir el tipo de archivo. Por ejemplo: /9j/4AAQSkZJRgABAQAAAQABAAD...
Para obtener más información sobre los tipos de documento y los subtipos, consulte nuestra documentación pública aquí: https://documenter.getpostman.com/view/23863579/2s8YzWSLzB#799aec14-d363-4c97-9447-9d20832b75dd
Recupere el estado de un solicitante y extraiga información.
Las comprobaciones suelen tardar aproximadamente 2 minutos en procesarse. Para recuperar el estado de un solicitante, utilice la Retrieve Applicant Status acción con el valor de applicantId correspondiente.
Esta acción proporciona una ApprovedRejected respuesta, etiquetas de rechazo y información extraída del documento.
Recuperar los detalles de un solicitante. (Opcional)
De forma similar a la acción anterior, Retrieve Applicant Details le permite recuperar información adicional sobre un solicitante, utilizando el valor de applicantId correspondiente.
Problemas y limitaciones conocidos
Las comprobaciones no continuarán si la imagen es extremadamente borrosa o fuera del foco. Se admiten tipos de archivo JPEG, PNG y PDF.
Errores y soluciones comunes
Al usar la Create an Applicant acción, si recibe un error, asegúrese de que el nombre del flujo coincide con el que ha creado en la plataforma.
Al usar la Upload a Document acción para cargar una imagen de selfie (si el flujo requiere), asegúrese de que el tipo de documento es "SELFIE" y el subtipo de documento es "NULL".
Preguntas más frecuentes
¿Cómo se comprueban los datos de un solicitante?
Una vez extraídos, los datos del solicitante se comprueban con bases de datos gubernamentales y comerciales comprobadas, entre las que se incluyen, entre otras, la lista electoral, el vehículo, la telco, la muerte y otros registros.
¿Qué es la detección compleja de fraudes o la manipulación digital?
La detección compleja de fraudes o la detección de manipulación digital es el proceso de comprobación de si los documentos se han editado gráficamente, falsificado o comprado ilegítimamente en línea. Este proceso se ejecuta en segundo plano en cada comprobación y ayuda a evitar el fraude antes de que se produzca: proteger a las empresas y a las personas.
¿Puede crear un flujo personalizado que pueda usar para mi negocio?
Absolutamente, cada negocio es único (y así es cada comprobación). Póngase en contacto con nuestro equipo, que podrá crear un flujo personalizado adaptado a sus requisitos.
¿Qué países son compatibles con una verificación?
Comprobamos documentos e individuos globalmente, desde licencias de conducir hasta facturas de servicios públicos, declaraciones bancarias e incluso correspondencia con autoridades gubernamentales, independientemente del idioma o el tipo de escritura.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Token de autorización | securestring | Escriba el token de portador de autorización. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Cargar documentos en un solicitante |
Cargue documentos en un solicitante con una cadena base64. |
| Crear solicitante |
Cree un nuevo solicitante de verificación. |
| Crear vínculo de verificación |
Cree un vínculo de verificación para cargar fácilmente documentos. |
| Recuperar detalles del solicitante |
Recuperar los detalles de un solicitante. |
| Recuperar estado del solicitante |
Recupere el estado de verificación de un solicitante y sus detalles. |
| Solicitud de comprobación del solicitante |
Confirme que todos los documentos se cargan e inicie la comprobación. |
Cargar documentos en un solicitante
Cargue documentos en un solicitante con una cadena base64.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de solicitante
|
applicantId | string |
applicantId |
|
|
Tipo de documento (por ejemplo, ID_CARD)
|
docType | string |
docType |
|
|
Subtipo de documento (por ejemplo, FRONT_SIDE)
|
docSubType | string |
docSubType |
|
|
Iso del país de documento (por ejemplo, AUS)
|
docCountryISO | string |
docCountryISO |
|
|
Nombre de archivo + extensión (por ejemplo, document.jpeg)
|
filename | string |
filename |
|
|
Contenido del archivo (cadena Base64)
|
contents | string |
contents |
Crear solicitante
Cree un nuevo solicitante de verificación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección de correo electrónico
|
string |
Correo electrónico |
||
|
Número de teléfono
|
phone | string |
phone |
|
|
Nombre
|
nameFirst | string |
nombrePrimero |
|
|
Apellido
|
nameLast | string |
nombreApellido |
|
|
Flujo de solicitantes
|
flowName | string |
flowName |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
applicantId
|
response.applicantId | string |
applicantId |
|
Correo electrónico
|
response.email | string |
Correo electrónico |
|
phone
|
response.phone | string |
phone |
|
nombrePrimero
|
response.nameFirst | string |
nombrePrimero |
|
nombreApellido
|
response.nameLast | string |
nombreApellido |
|
flowName
|
response.flowName | string |
flowName |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
Crear vínculo de verificación
Cree un vínculo de verificación para cargar fácilmente documentos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de solicitante
|
applicant | string |
solicitante |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
verificationLink
|
response.verificationLink | string |
verificationLink |
Recuperar detalles del solicitante
Recuperar los detalles de un solicitante.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de solicitante
|
applicantId | string |
applicantId |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
Correo electrónico
|
response.email | string |
Correo electrónico |
|
phone
|
response.phone | string |
phone |
|
nombrePrimero
|
response.nameFirst | string |
nombrePrimero |
|
nombreApellido
|
response.nameLast | string |
nombreApellido |
|
tags
|
response.tags | array of |
tags |
|
flowName
|
response.flowName | string |
flowName |
|
estado
|
response.status | string |
estado |
Recuperar estado del solicitante
Recupere el estado de verificación de un solicitante y sus detalles.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de solicitante
|
applicantId | string |
applicantId |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
estado |
|
applicantStatus
|
response.applicantStatus | string |
applicantStatus |
|
applicantActionStatus
|
response.applicantActionStatus | string |
applicantActionStatus |
|
Fecha de modificación
|
response.result.Modified Date | integer |
Fecha de modificación |
|
Fecha de creación
|
response.result.Created Date | integer |
Fecha de creación |
|
Autor
|
response.result.Created By | string |
Autor |
|
reviewAnswer
|
response.result.reviewAnswer | string |
reviewAnswer |
|
solicitante
|
response.result.applicant | string |
solicitante |
|
commentClient
|
response.result.commentClient | string |
commentClient |
|
empresa
|
response.result.company | string |
empresa |
|
commentModeration
|
response.result.commentModeration | string |
commentModeration |
|
rejectLabels
|
response.result.rejectLabels | array of string |
rejectLabels |
|
reviewRejectType
|
response.result.reviewRejectType | string |
reviewRejectType |
|
verificación
|
response.result.verification | string |
verificación |
|
_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 |
Solicitud de comprobación del solicitante
Confirme que todos los documentos se cargan e inicie la comprobación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de solicitante
|
applicantId | string |
applicantId |