Cómo usar Persona

Aprenda a conectar y configurar Persona como proveedor de KYC en B2CORE, incluida la configuración del panel de Persona, los ajustes de conexión, los niveles de verificación y el webhook

Este artículo explica cómo configurar B2CORE para usar el proveedor de KYC Persona. Con Persona, los clientes verifican su identidad mediante un proceso que se abre en la interfaz de B2CORE o en la aplicación móvil: capturan una imagen de un documento de identidad oficial y una selfie, y Persona los comprueba. B2CORE recibe el resultado, descarga las fotos del documento al perfil del cliente, actualiza sus datos y aprueba o rechaza la solicitud de verificación.

Antes de seguir estas instrucciones, debe haberse registrado en Persona y tener una cuenta activa. Solo puede existir una conexión a Persona en B2CORE.

Cómo funciona la verificación

Un cliente inicia la verificación de un nivel que usa Persona. B2CORE crea una solicitud de Persona con la plantilla de solicitud asignada a ese nivel y completa previamente el nombre, el correo electrónico y el número de teléfono del cliente.
El proceso de Persona se abre en la interfaz de B2CORE o en la aplicación móvil. El cliente carga los documentos y se toma una selfie directamente en Persona; los archivos no pasan por B2CORE.
Cuando el cliente termina, B2CORE crea una solicitud de verificación para el nivel.
Persona toma una decisión sobre la solicitud (automáticamente mediante un Persona Workflow o manualmente por su equipo de cumplimiento) y envía un webhook a B2CORE.
B2CORE descarga las fotos del documento, actualiza el perfil del cliente y aprueba o rechaza la solicitud. Si se aprueba, el cliente obtiene el nivel de verificación.

Si el cliente cierra el navegador o la aplicación antes de que el proceso regrese a B2CORE, el webhook finaliza la solicitud de todos modos, por lo que no se pierde ningún dato.

Configurar Persona

Complete los siguientes pasos en el panel de Persona. Necesitará los valores que obtenga aquí para configurar la conexión en B2CORE.

Crear plantillas de solicitud

Cree una plantilla de solicitud por cada nivel de verificación de B2CORE que deba usar Persona. Añada los pasos de verificación necesarios para el nivel, como un documento de identidad oficial y una selfie. Si lo desea, cree una plantilla aparte para clientes corporativos.

Copie el ID de cada plantilla (comienza por itmpl_). Puede encontrarlo en la configuración de la plantilla, en el panel de Persona.

Configurar la toma de decisiones

Cree un Persona Workflow que apruebe las solicitudes que superen todas las comprobaciones y rechace las que no las superen. Sin él, las solicitudes permanecen en el estado completed o failed en Persona y nunca se aprueban ni se rechazan.

Si no usa Persona Workflows, active la opción Aprobar verificaciones completadas sin una decisión de Persona en la conexión de B2CORE. Antes de hacerlo, lea la advertencia en Ajustes de conexión.

Obtener la clave de API

En el panel de Persona, cree una clave de API. Las claves de sandbox comienzan por persona_sandbox_ y las de producción, por persona_production_. La URL de la API es la misma para ambos entornos; la clave determina qué entorno se utiliza.

Obtener el ID del entorno

Copie el ID del entorno de Persona que utiliza (comienza por env_). Para encontrarlo, en el panel de Persona, vaya a Organización > Información.

Crear un webhook

En el panel de Persona, cree un webhook con los siguientes ajustes:

URL: https://{your-B2CORE-back-office-domain}/api/v2/my/verification-persona/webhook
Eventos:
- inquiry.created
- inquiry.completed
- inquiry.failed
- inquiry.approved
- inquiry.declined
- inquiry.marked-for-review

Después de crear el webhook, copie su secreto (comienza por wbhsec_).

Asegúrese de sustituir {your-B2CORE-back-office-domain} por el dominio de su B2CORE Back Office, no el de la interfaz de B2CORE, y sin una barra al final.

Cómo configurar una conexión a Persona

Solo los administradores que tengan asignados los permisos para gestionar conexiones externas pueden configurar una conexión a Persona.

Para configurar una conexión:

En B2CORE Back Office, vaya a Sistema > Conexiones externas.

Haga clic en +Crear en la esquina superior derecha de la página.

En la página Crear conexión, complete los siguientes campos:

En el campo Nombre, introduzca el nombre que desea usar para la conexión.
En el campo Etiqueta, introduzca la etiqueta que se aplicará a la conexión en Back Office.
En el menú desplegable Proveedor, seleccione Persona.

Haga clic en Guardar para crear la conexión.

En la lista de conexiones, busque la conexión a Persona que ha creado y haga clic en Editar para introducir los detalles de la conexión.

En la página Editar conexión, especifique los ajustes de conexión.

En el menú desplegable Habilitado, seleccione Yes.

Haga clic en Guardar para aplicar los ajustes.

Ajustes de conexión

Campo	Descripción	Dónde obtenerlo
Clave de API	La clave que B2CORE usa para llamar a la API de Persona. Comienza por `persona_sandbox_` o `persona_production_`.	Panel de Persona, claves de API. Consulte Obtener la clave de API
Secreto del webhook	El secreto que se usa para verificar que los webhooks proceden de Persona. Comienza por `wbhsec_`.	Panel de Persona, el webhook que ha creado. Consulte Crear un webhook
ID del entorno	El ID del entorno de Persona. Comienza por `env_`. Obligatorio.	Panel de Persona. Consulte Obtener el ID del entorno
URL de la API	La dirección de la API de Persona. Obligatoria. El valor predeterminado es `https://api.withpersona.com`. Consérvelo tanto para sandbox como para producción.	—
Aprobar verificaciones completadas sin una decisión de Persona	Define qué ocurre cuando Persona no toma una decisión. Consulte los detalles a continuación.	—
Prefijo del ID de referencia	Un prefijo que se añade antes del ID del cliente que B2CORE envía a Persona. Consulte los detalles a continuación.	—
Sincronizar selfies	Define si la selfie del cliente se guarda en B2CORE. Consulte los detalles a continuación.	—

Cuando edite la conexión más adelante, deje vacíos los campos Clave de API y Secreto del webhook para conservar los valores guardados.

Aprobar verificaciones completadas sin una decisión de Persona

No (recomendado): B2CORE espera hasta que Persona apruebe o rechace la solicitud.
Yes: una solicitud que el cliente haya completado se aprueba y una solicitud que haya fallado se rechaza, sin esperar una decisión de Persona.

Seleccione Yes solo si su panel de Persona no tiene ningún Workflow que apruebe o rechace solicitudes. De lo contrario, las solicitudes permanecerán pendientes indefinidamente. Tenga en cuenta que, con Yes, se aprueba a cualquier persona que complete la comprobación, incluso si presenta un documento falso.

Prefijo del ID de referencia

Persona trata cada ID de referencia como una persona. B2CORE envía el ID del cliente como ID de referencia. Por ejemplo, con el prefijo brand-, el cliente con ID 454 se envía como brand-454.

Si varias instalaciones de B2CORE usan la misma organización de Persona (por ejemplo, producción y un entorno de pruebas, o dos marcas), asigne un prefijo único a cada instalación. De lo contrario, clientes distintos con el mismo ID se fusionarán en una sola persona en Persona.
Si solo esta instalación de B2CORE usa su organización de Persona, deje el campo vacío. B2CORE enviará entonces el ID del cliente sin prefijo.
El prefijo puede tener hasta 32 caracteres y puede contener letras latinas, dígitos y los símbolos _, ., :, -.

No cambie el prefijo después de que los clientes hayan iniciado la verificación. Se crearían nuevas personas para esos clientes en Persona.

Sincronizar selfies

Yes (predeterminado): la selfie que el cliente se tomó en Persona se guarda entre sus documentos, junto a las fotos del documento de identidad.
No: solo se guardan las fotos del documento de identidad. La selfie permanece en Persona.

Cómo crear niveles de verificación para Persona

Puede crear niveles de verificación o modificar los existentes para usar Persona en la verificación.

Para crear un nivel de verificación:

En B2CORE Back Office, vaya a Verificación > Niveles.

Haga clic en +Crear en la esquina superior derecha de la página.

En la página Crear nivel de verificación, complete los siguientes campos:

En el campo Índice, especifique un valor entero distinto de cero.

El índice cero (0) siempre se asigna al nivel de verificación predeterminado. Para los demás niveles de verificación, el índice debe ser mayor que cero, como 1 para el nivel 1, 2 para el nivel 2, y así sucesivamente.
En el menú desplegable Asistente, seleccione PersonaSDK.
En el campo Etiqueta, especifique un nombre para el nivel que se mostrará en la interfaz de B2CORE y en la aplicación móvil, como Level 1. Si es necesario, especifique las propiedades de localización de este campo haciendo clic en el botón situado a su derecha.
En el campo Descripción para escritorio, especifique una descripción del nivel que se mostrará en la interfaz de B2CORE. Esta descripción puede incluir los permisos concedidos a los clientes cuando obtengan este nivel.

La descripción para la interfaz de B2CORE puede especificarse en formato HTML. Si es necesario, especifique las propiedades de localización de este campo.
En el campo Descripción para móvil, especifique una descripción del nivel que se mostrará en la aplicación móvil.

La descripción para la aplicación móvil puede especificarse en formato JSON. Si es necesario, especifique las propiedades de localización de este campo.
En el menú desplegable Visible, seleccione Yes.
En el menú desplegable Predeterminado, seleccione No. (Level 0 siempre es el nivel de verificación predeterminado).
En el menú desplegable Derecho de cliente asignado, seleccione un nivel de permisos que defina los permisos que desea conceder a sus clientes después de que obtengan este nivel de verificación (para obtener más información, consulte Derechos de cliente).
En el menú desplegable Pruebas de cliente, seleccione opcionalmente una o varias pruebas de acreditación si desea exigir a sus clientes que las superen antes de iniciar la verificación. La lista de pruebas disponibles incluye todas las pruebas cuya visibilidad esté establecida en Yes y que se muestran en la página Pruebas de cliente.

Haga clic en Guardar para crear el nivel.

Una vez que se vuelva a cargar la página, complete los campos de las plantillas de Persona:

En el campo Plantilla de solicitud de Persona, seleccione la plantilla de solicitud para este nivel.
En el campo Plantilla de solicitud de Persona (clientes corporativos; vacío = igual que arriba), seleccione opcionalmente una plantilla para clientes corporativos. Si lo deja vacío, los clientes corporativos usarán la plantilla del campo anterior.

Los campos se muestran como menús desplegables con las plantillas de su cuenta de Persona. Si la lista no está disponible (por ejemplo, cuando usa una clave de API de sandbox), introduzca manualmente el ID de la plantilla. Debe comenzar por itmpl_.

Los campos de las plantillas de Persona solo aparecen cuando se cumplen ambas condiciones: Asistente está establecido en PersonaSDK y la conexión a Persona está habilitada. Seleccione el asistente, guarde el nivel y, después, complete la plantilla.

Haga clic en Guardar para aplicar los cambios.

Persona no requiere grupos ni tipos de documentos: los documentos que deben presentar los clientes se definen en la plantilla de solicitud de Persona.

Los niveles que usan otros asistentes conservan su proveedor actual.

Qué ocurre después de la verificación

Persona envía un webhook a B2CORE cuando cambia el estado de una solicitud. B2CORE procesa el webhook de la siguiente manera:

Evento de Persona	Resultado en B2CORE
`inquiry.created`	Solo se registra
`inquiry.approved`	Se guardan los documentos, se actualizan los datos del cliente, se aprueba la solicitud y el cliente obtiene el nivel
`inquiry.declined`	Se guardan los documentos y se rechaza la solicitud. El cliente puede volver a intentarlo
`inquiry.marked-for-review`	Se guardan los documentos y la solicitud queda pendiente de una decisión manual
`inquiry.completed`, `inquiry.failed`	Se guardan los documentos. La solicitud solo se aprueba o se rechaza si Aprobar verificaciones completadas sin una decisión de Persona está establecido en Yes

Notas:

B2CORE guarda las fotos del documento de identidad y, si Sincronizar selfies está establecido en Yes, también guarda la selfie entre los documentos del cliente.
Tras una aprobación, B2CORE actualiza el nombre, el segundo nombre y los apellidos del cliente, así como su fecha de nacimiento, país y dirección, con los datos que Persona extrajo de los documentos. El número de teléfono no se actualiza.
Si un responsable de cumplimiento toma una decisión manualmente en Back Office, esa decisión prevalece sobre la de Persona.
Los webhooks duplicados y recibidos fuera de orden no causan problemas: B2CORE siempre consulta el estado actual de la solicitud en Persona.
Si se pierde un webhook, B2CORE vuelve a procesar las solicitudes que llevan más de 6 horas esperando una decisión (la comprobación se ejecuta a diario).
Las solicitudes que el cliente inició pero no envió no generan solicitudes de verificación.

B2CORE almacena la fecha de caducidad del documento, pero no revoca el nivel ni notifica al cliente cuando caduca un documento.

Migrar desde SumSub

Configure y habilite la conexión a Persona.
Para cada nivel que deba usar Persona, seleccione la plantilla de solicitud y, después, cambie el Asistente del nivel a PersonaSDK.
Deshabilite la conexión a SumSub.

Los clientes conservan sus niveles de verificación actuales.

Persona no tiene un equivalente de SumSub KYT (supervisión de transacciones). La supervisión de transacciones mediante SumSub deja de funcionar después de deshabilitar la conexión a SumSub.

Solución de problemas

Las solicitudes permanecen pendientes después de que el cliente termina la verificación. Compruebe que un Persona Workflow apruebe o rechace las solicitudes, o active Aprobar verificaciones completadas sin una decisión de Persona. Compruebe también que el webhook se haya creado con todos los eventos necesarios.
Se rechazan los webhooks. Compruebe que el Secreto del webhook de la conexión coincida con el secreto del webhook en Persona.
El cliente ve un error al iniciar la verificación. Compruebe que el nivel tenga seleccionada una plantilla de solicitud (para los clientes corporativos, se usa la plantilla para clientes individuales si la plantilla corporativa está vacía).

Cómo usar Persona

En esta página