Primeros pasos

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-verisoul`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/verisoul/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Instalar

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego usa el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-verisoul` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue las instrucciones específicas para cada plataforma a continuación:

bun add @capgo/capacitor-verisoul
bunx cap sync

Inicio rápido

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'dev',
  projectId: 'project-id-123',
});

Ejemplo: getSessionId

import { Verisoul } from '@capgo/capacitor-verisoul';

const result = await Verisoul.getSessionId();
console.log(result);

Ejemplo: reinitialize

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.reinitialize();

Errores comunes

Inicialización única: run setup during app bootstrap.
Sync nativo: ejecutar bunx cap sync tras actualizar los plugins.
Fuente de verdad: confiar src/definitions.ts en el repo de GitHub.

Configurar Verisoul

Llama configure() una sola vez al iniciar tu app. Usa sandbox para pruebas y prod para tráfico de producción.

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'prod',
  projectId: 'YOUR_PROJECT_ID',
});

Obtén un session ID

Una vez que Verisoul haya recopilado suficientes señales nativas, solicita el session ID y envíalo a tu backend. Tu backend debe llamar al API server-side de Verisoul para la evaluación de riesgo.

const { sessionId } = await Verisoul.getSessionId();

await fetch('/api/risk/verisoul', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sessionId }),
});

Reiniciar ante cambios de cuenta

Llama reinitialize() cuando el contexto del usuario cambia, como al cerrar sesión y entrar con otra cuenta.

await Verisoul.reinitialize();

Señales táctiles de Android

En Android, reenvía los eventos táctiles cuando tu app necesite la recolección de patrones de Verisoul.

await Verisoul.recordTouchEvent({
  x: 120,
  y: 240,
  action: 'down',
});

Configuración de la plataforma

iOS setup incluye notas sobre el entitlement de App Attest.
Configuración de Android incluye el repositorio Maven de Verisoul y los permisos.

Continúa desde Primeros pasos

Si estás usando Primeros pasos para integrar sesiones de Verisoul, conéctalo con @capgo/capacitor-verisoul para una visión general de API, iOS setup para notas sobre App Attest, Configuración de Android para la configuración de Gradle, y Usando @capgo/capacitor-verisoul para el tutorial del plugin.