Cómo usar SumSub

Aprenda a conectar y configurar SumSub como proveedor de KYC y KYT en B2CORE, incluidos la configuración de documentos, los niveles de verificación, los flujos y la configuración de webhooks

Este artículo proporciona instrucciones sobre cómo configurar B2CORE para usar el proveedor de KYC y KYT, SumSub.

Antes de continuar con las instrucciones, debe haberse registrado en SumSub y tener una cuenta activa. Para las comprobaciones KYT, SumSub Fraud Prevention también debe estar habilitado y configurado correctamente.

Cómo configurar una conexión con SumSub

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

Para configurar una conexión:

En el Back Office de B2CORE, 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 un nombre que desee utilizar para la conexión.
  • En el campo Título, introduzca un título que se aplicará a la conexión en el Back Office.
  • En la lista desplegable Proveedor, seleccione SumSubstance.

Haga clic en Guardar para crear la conexión.

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

En la página Editar conexión, especifique la siguiente configuración:

  • En el campo Ubicación del servicio, especifique https://api.sumsub.com/.
  • En el campo ID de cliente, especifique el nombre de su cuenta de SumSub. Para ver el nombre de su cuenta, en la interfaz de SumSub, vaya a Configuración > Detalles de la cuenta.
  • En el campo Clave secreta del webhook, especifique un secreto de webhook. Debe generar el webhook en la interfaz de SumSub. Para ello, en la interfaz de SumSub, vaya a Dev space > Webhooks (para obtener la configuración de webhook necesaria, consulte Configuración del webhook de SumSub).
  • Deje vacíos los campos Inicio de sesión y Contraseña.
  • En los campos Token y Token Secret, especifique un token y un valor de clave secreta generados en la interfaz de SumSub. Para generarlos, en la interfaz de SumSub, vaya a Dev space > App Tokens.
  • Para aplicar diferentes flujos de verificación a clientes individuales y corporativos, seleccione Habilitado en la lista desplegable Modo de restablecimiento de cliente.

Cuando la opción Modo de restablecimiento de cliente está habilitada, significa que se requiere una verificación repetida para los clientes cuyo tipo ha cambiado de individual a corporativo, o viceversa. Después de cambiar un tipo, ocurre lo siguiente:

  • En el Back Office de B2CORE, el nivel de verificación de un cliente se restablece a Level 0, que es el nivel de verificación predeterminado.
  • Todas las solicitudes del cliente pendientes para obtener un nivel de verificación superior se rechazan automáticamente.
  • En el sistema SumSub, un solicitante vuelve al nivel inicial y todos los documentos que se habían cargado previamente para este solicitante se invalidan.

Todos los archivos y documentos que se habían cargado previamente para este cliente en el Back Office de B2CORE seguirán estando disponibles.

En la sección Monitoreo de transacciones, configure los ajustes para las comprobaciones KYT mediante SumSub Fraud Prevention. Actualmente, estas comprobaciones son compatibles con depósitos y retiros fiduciarios y de criptomonedas.

  • En la lista desplegable Habilitado, seleccione:

    • Sí — para habilitar el monitoreo de transacciones mediante SumSub y recibir resultados en B2CORE.
    • No — para deshabilitar el monitoreo de transacciones mediante SumSub.
  • En la lista desplegable Filtro de moneda:

    • Seleccione una o varias monedas para monitorear transacciones solo en las monedas seleccionadas.
    • Deje la lista vacía para monitorear transacciones en todas las monedas.

Haga clic en Guardar para aplicar la configuración.

Cómo crear grupos de documentos para la verificación de SumSub

Cree grupos de documentos para permitir que los clientes envíen diversos documentos compatibles con SumSub para la verificación. Para cada documento (como un documento de identidad, pasaporte, licencia de conducir y otros) que desee poner a disposición para la verificación, cree un grupo de documentos independiente con el nombre adecuado.

Para crear un grupo de documentos:

En el Back Office de B2CORE, vaya a Verificación > Grupos de documentos.

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

En la página Crear grupo de documentos, complete los siguientes campos:

  • En el campo Nombre, especifique el nombre de un grupo de documentos.

Asegúrese de especificar los nombres de los grupos de documentos exactamente como los nombres de los tipos de documentos compatibles con SumSub, como ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT, entre otros.

Por ejemplo, si desea que sus clientes envíen sus documentos de identidad para la verificación de documentos, cree un grupo de documentos con el nombre ID_CARD.

  • En el campo Título, especifique un título de grupo de documentos que se mostrará en la interfaz de B2CORE.
  • En la lista desplegable Tipo, seleccione Uno.
  • En el campo Descripción, especifique una descripción para el grupo de documentos que se utiliza en el Back Office.

Asegúrese de que esté seleccionado Sí en la lista desplegable Habilitado.

Haga clic en Guardar para crear el grupo de documentos.

Cómo crear tipos de documentos para la verificación de SumSub

Para cada grupo de documentos que haya creado, cree un tipo de documento.

Para crear un tipo de documento:

En el Back Office de B2CORE, vaya a Verificación > Tipos de documentos.

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

En la página Crear tipo de documento, complete los siguientes campos:

  • En el campo Nombre, especifique el nombre de un tipo de documento.

Los nombres de los tipos de documentos deben ser los mismos que los nombres de los grupos de documentos creados previamente. Por ejemplo, ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT, entre otros.

  • En el campo Título, especifique un título de tipo de documento que se mostrará en la interfaz de B2CORE.
  • En el campo Descripción, especifique una descripción para el tipo de documento que se mostrará en la interfaz de B2CORE.
  • En la lista desplegable Grupo, seleccione un grupo de documentos con el que debe asociarse este tipo de documento.
  • En el campo Máx. archivos, especifique el número máximo de archivos que los clientes pueden cargar para este tipo de documento.

En la lista desplegable Estado, seleccione Habilitado.

Haga clic en Guardar para crear el tipo de documento.

Cómo crear niveles de verificación para SumSub en el Back Office de B2CORE

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

Para crear un nivel de verificación:

En el Back Office de B2CORE, 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 otros 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 la lista desplegable Asistente, seleccione SnsWizardSDK.

  • En el campo Título, especifique un nombre de nivel que se mostrará en la interfaz de B2CORE y la aplicación móvil, como Level 1. Si es necesario, especifique las propiedades de localización para este campo haciendo clic en el botón situado a la derecha del campo.

  • En el campo Descripción de escritorio, especifique una descripción del nivel que se mostrará en la interfaz de B2CORE. Esta descripción puede incluir los permisos otorgados a los clientes una vez que 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 para este campo.

  • En el campo Descripción 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 para este campo.

  • En la lista desplegable Visible, seleccione Sí.

  • En la lista desplegable Predeterminado, seleccione No. (Level 0 siempre es el nivel de verificación predeterminado).

  • En la lista desplegable Derecho de cliente asignado, seleccione un nivel de permiso que defina el conjunto de permisos que desea otorgar a sus clientes después de obtener este nivel de verificación (para obtener más información, consulte Derechos de cliente).

  • En la lista desplegable Grupos de documentos, seleccione uno o más grupos de documentos requeridos. Por ejemplo, puede seleccionar ID_CARD y RESIDENCE_PERMIT si desea que sus clientes envíen sus documentos de identidad y permisos de residencia para la verificación a fin de recibir este nivel.

  • En la lista desplegable Pruebas de cliente, opcionalmente seleccione una o más pruebas de acreditación si desea obligar a sus clientes a aprobar estas pruebas antes de que puedan enviar sus documentos para la verificación. La lista de pruebas disponibles incluye todas las pruebas cuya visibilidad está establecida en Sí, que se muestran en la página Pruebas de cliente.

Haga clic en Guardar para crear el nivel.

Cómo crear niveles y flujos en la interfaz de SumSub

El Back Office de B2CORE admite dos tipos de clientes: individuales y corporativos. El sistema SumSub permite configurar un flujo de verificación independiente para cada tipo. Para utilizar esta opción, asegúrese de haber habilitado el Modo de restablecimiento de cliente al configurar una conexión con SumSub.

Para añadir un nuevo nivel:

En la interfaz de SumSub, vaya a Integrations > Applicant Levels.

Haga clic en Add new level.

Seleccione los pasos necesarios.

Los nombres de los niveles deben especificarse en los siguientes formatos:

  • Para clientes individuales: level1, level2, y así sucesivamente.
  • Para clientes corporativos: level3corporate, level4corporate, y así sucesivamente.

Estos formatos garantizan una asignación correcta entre los niveles de SumSub y B2CORE. La asignación se basa en el Índice asignado a cada nivel de verificación en B2CORE. Puede encontrar los índices en la columna correspondiente de la página Verificación > Niveles del Back Office de B2CORE y utilizarlos en los nombres de nivel para SumSub. Por ejemplo:

  • level1 en SumSub se asigna al nivel con Índice = 1 en B2CORE
  • level2 en SumSub se asigna al nivel con Índice = 2 en B2CORE
  • level3corporate en SumSub se asigna al nivel con Índice = 3 en B2CORE
  • level4corporate en SumSub se asigna al nivel con Índice = 4 en B2CORE, y así sucesivamente.

Para añadir un nuevo flujo:

En la interfaz de SumSub, vaya a Integrations > Verification Flow.

Haga clic en Add new.

Seleccione las opciones necesarias. Para cada flujo, seleccione un nivel compatible.

Configuración del webhook de SumSub

Revisado

  • Nombre: REVIEWED
  • Receptor: HTTP Endpoint
  • Destino: https://{your-Back-Office-URL}/api/v1/verification-sns/handle
  • Tipo: Applicant reviewed (applicantReviewed)
  • Clave secreta: la clave secreta generada en SumSub

Asegúrese de reemplazar {your-Back-Office-URL} por el dominio de su Back Office de B2CORE, no por la interfaz de B2CORE. Por ejemplo, el destino para los webhooks puede tener este aspecto: https://example.com/api/v1/verification-sns/handle.

Última actualización

En esta página