Ejemplos de uso

A continuación, te mostramos ejemplos prácticos de cómo utilizar el plugin oficial de Facephi en tus aplicaciones híbridas basadas en Cordova.

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

GitHub - facephi/sdk-mobile-cordova-samplesGitHub

✅ Ejemplo 1: Core - launchInitSession(Inicialización del SDK)

Recomendamos inicializar el SDK una vez que el dispositivo esté listo:

const lic       = window.cordova.platformId.toUpperCase() == "IOS" ? LICENSEIOS_NEW : LICENSEANDROID_NEW
const apiKey    = window.cordova.platformId.toUpperCase() == "IOS" ? LICENSE_APIKEY_IOS : LICENSE_APIKEY_ANDROID
facephi.plugins.sdkcore.launchInitSession({
    //"license": lic,
    "licenseUrl": LICENSE_URL,
    "licenseApiKey": apiKey,
    "enableTracking": true
})
.then(
    (result) =>
    {
        console.log(result);
    },
    (err) => console.log(err),
)
.finally (() =>
{
    console.log("callInitSession finished...");
});

Notas importantes:

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

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

---

✅ Ejemplo 2: launchInitOperation

Puedes lanzar un flujo de verificación de identidad de forma sencilla:

facephi.plugins.sdkcore.launchInitOperation({
    "customerId": "[email protected]",
    "type": SdkMobileOperationType.ONBOARDING,
    "steps": ""
})
.then(
    (result) => {
        console.log(result);
    },
    (err) => console.log(err),
)
.finally (() =>
{
    console.log("callInitOperation finished...");
});

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
}, function (result) {
    console.log("✅ Verificación completada: " + result.verificationId);
}, function (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 pruebas completas en entorno sandbox antes de ir a producción. ✅ Verifica que los permisos de cámara e internet estén correctamente configurados. ✅ Valida los resultados de verificación siempre en backend, nunca solo en cliente. ✅ Actualiza el plugin a la última versión disponible consultando el Changelog.

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