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 estos comandos y sigue las instrucciones de cada plataforma:

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

Inicializa una vez: ejecuta setup durante el bootstrap de la app.
Sync nativo: ejecuta bunx cap sync tras actualizar los plugins.
Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.

Configurar Verisoul

Llama a configure() una sola vez, al inicio de 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',
});

Obtener un ID de sesión

Una vez que Verisoul haya recolectado suficientes señales nativas, solicita el session ID y envíalo a tu backend. Tu backend debe llamar al API del lado del servidor de Verisoul para la evaluación de riesgos.

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

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

Restablecer al cambiar de cuenta

Llama a 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 recopilación de patrones táctiles de Verisoul.

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

Configuración de la plataforma

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

Continúa desde Getting Started

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