> 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/landing/metodos-de-integracion/formulario-embebido.md).

# Formulario embebido

### Método sin información extra (formulario)

Si necesitas que nuestra pasarela procese información extra de tus clientes o reciba información que solo tú manejas, debes usar el método POST. Es muy sencillo llamar a nuestra página de destino a través de una llamada POST introduciendo en el cuerpo los siguientes campos:

| CAMPO            | DESCRIPCIÓN                                                                                                                                                                                  |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`         | Este es el parámetro con el que procesamos la seguridad de entrada de la pasarela y el manejo de datos dentro de la pasarela. Este parámetro será proporcionado por nosotros.                |
| `customerId`     | Este identificador te permitirá asociar la operación biométrica generada en nuestros procesos con tu cliente; puede ser tu correo electrónico o un identificador que tengas de tus usuarios. |
| `documentNumber` | Este parámetro es opcional, puedes enviar el número de identificación de tu cliente si lo tienes para que podamos compararlo con los datos biométricos obtenidos por nuestro proceso.        |
| `callbackPath`   | Define los parámetros que se agregarán a la llamada de la URL de Callback que ejecutaremos para enviar los datos capturados por el proceso biométrico.                                       |

{% hint style="warning" %}
**Nota**: En caso de utilizar un **iframe** es necesario **mantener el foco dentro del contenedor** que integra los componentes del formulario.

```javascript
// Ejemplo: Activar foco en el componente iframe de manera programática
const iframe = document.getElementById('my-iframe');
iframe.addEventListener('load', () => {
    iframe.focus();
});
```

{% endhint %}

Así es como se envían estos parámetros y se llama a nuestra pasarela en html:

**Ejemplo en HTML**

```html
<form action="https://url-example-landing" method="POST">
    <label for="apiKey">Clave API:</label>
    <input type="text" name="apiKey" id="apiKey"><br>
    
    <label for="customerId">ID de Cliente:</label>
    <input type="text" name="customerId" id="customerId"><br>
    
    <label for="documentNumber">Número de Documento:</label>
    <input type="text" name="documentNumber" id="documentNumber"><br>
    
    <label for="callback Path">Ruta de Callback:</label>
    <input type="text" name="callbackPath" id="callbackUrl"><br>
    
    <input type="submit" value="Enviar">
</form>
```