Ejemplos de uso

Aquí encontrarás ejemplos prácticos de cómo utilizar el plugin oficial de Facephi en tus aplicaciones React Native, compatibles con Android e iOS.

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

GitHub - facephi/sdk-mobile-react-native-samplesGitHub

---

✅ Ejemplo 1: Inicialización del SDK

Recomendamos inicializar el SDK al iniciar la aplicación, por ejemplo, dentro de tu componente principal:

import { Facephi } from '@facephi/react-native-sdk';

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

Notas importantes:

• El parámetro apiKey se obtiene desde el Portal de Administración.

• Durante las pruebas, usa siempre el entorno "sandbox".

---

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

Puedes lanzar 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 activar parámetros opcionales para personalizar el flujo:

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 de integración

✅ Realiza siempre las pruebas iniciales en entorno sandbox. ✅ Configura los permisos de cámara e internet para Android e iOS correctamente. ✅ 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.