> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk.md).

# Configuración del SDK

El SDK Loader está diseñado para configurarse fácilmente mediante los parámetros que se pasan a la función `loadSdk`. Esta función crea y configura automáticamente el elemento `<facephi-sdk-provider>`.

## Parámetros de configuración

{% content-ref url="/pages/2wP8n08Ap85CLYOyxHLX" %}
[Parámetros de configuración](/productos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk/parametros-de-configuracion.md)
{% endcontent-ref %}

## Control de eventos

{% content-ref url="/pages/4GXlpFJHR0R4jFMTqpxT" %}
[Control de eventos](/productos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk/control-de-eventos.md)
{% endcontent-ref %}

***

## Ejemplo de configuración completa

```typescript
import { loadSdk } from '@facephi/sdk-loader';

const sdkElement = await loadSdk({
  apiKey: 'YOUR_APIKEY',
  containerId: 'sdk-container',
  customerId: 'user-12345',
});

if (sdkElement) {
  // Escuchar eventos del SDK
  sdkElement.addEventListener('emitIDVIntegration', (event) => {
    console.log('Integration event:', event);
  });
}
```

***

## Problemas conocidos con una integración incorrecta de la APIKEY

A continuación se describen los problemas más comunes y cómo evitarlos.

{% stepper %}
{% step %}

### Error de configuración web (CORS)

Es un requisito obligatorio proporcionar a Facephi un dominio web válido donde se utilizará el SDK. Si el SDK se despliega en un dominio web distinto, aparecerá un error CORS (Cross-Origin Resource Sharing).

#### ¿Cómo evitar errores CORS?

* Asegúrate de configurar correctamente la URL de tu aplicación en el apartado "Conectar" al crear una integración en IDV Suite
* Despliega el SDK únicamente en el dominio autorizado.
  {% endstep %}

{% step %}

### Error de configuración del flujo de trabajo

La `apiKey` está vinculada a los productos que el cliente tiene contratados, que están preconfigurados por el equipo de soporte de Facephi. Si un producto concreto no está configurado, esos componentes no se renderizarán.

{% hint style="warning" %}
Si los problemas persisten, contacta con el equipo de soporte de Facephi
{% endhint %}
{% endstep %}
{% endstepper %}