Ejemplos de uso

A continuación, te mostramos ejemplos prácticos de cómo utilizar el plugin oficial de Facephi en tus aplicaciones basadas en Capacitor, compatibles con Android e iOS.

Las aplicaciones de ejemplo se pueden encontrar en el repositorio de GitHub:

GitHub - facephi/sdk-mobile-capacitor-samplesGitHub

---

✅ Ejemplo 1: Inicialización del SDK

Se recomienda inicializar el SDK al iniciar tu aplicación:

import { Facephi } from '@facephi/capacitor-plugin';

Facephi.initialize({
  apiKey: '<tu_api_key>',
  environment: 'sandbox', // o 'production'
});

Notas importantes:

• Obtén tu apiKey desde el Portal de Administración.

• Usa "sandbox" durante las pruebas, cambia a "production" para entorno real.

---

✅ Ejemplo 2: Proceso básico de verificación de identidad

Lanza un proceso de verificación desde cualquier parte de tu aplicación:

jsCopyEditFacephi.verifyIdentity({
  documentType: 'ID',
  country: 'ES',
})
  .then(result => {
    console.log('✅ Verificación exitosa:', result.verificationId);
  })
  .catch(error => {
    console.error('❌ Error en la verificación:', error.message);
  });

Parámetros:

Parámetro	Descripción	Obligatorio
documentType	Tipo de documento (ej. "ID", "PASSPORT", etc.)	✅ Sí
country	Código ISO del país (ej. "ES" para España)	✅ Sí

---

✅ Ejemplo 3: Personalización con opciones adicionales

Puedes personalizar el flujo activando opciones avanzadas:

jsCopyEditFacephi.verifyIdentity({
  documentType: 'PASSPORT',
  country: 'FR',
  showTutorial: true,
  enableLivenessDetection: true,
})
  .then(result => {
    console.log('✅ Verificación completada:', result.verificationId);
  })
  .catch(error => {
    console.error('❌ Error detectado:', error.message);
  });

Opciones adicionales:

Parámetro	Descripción	Valor por defecto
showTutorial	Muestra un tutorial previo al proceso.	false
enableLivenessDetection	Activa la detección de prueba de vida.	false

---

🎯 Recomendaciones clave

✅ Realiza siempre las pruebas iniciales en entorno sandbox. ✅ Asegúrate de que los permisos de cámara e internet estén configurados en cada plataforma. ✅ Valida los resultados de verificación siempre en backend. ✅ Consulta el Changelog tras cada actualización.

Para dudas adicionales, contacta con el Soporte Técnico.