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

# Embedded form

### Method without extra information (form)

If you need our gateway to process extra information from your customers or receive information that only you handle, you must use the POST method. It's very easy to call our landing page through a POST request by entering the following fields in the body:

| FIELD            | DESCRIPTION                                                                                                                                                                               |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`         | This is the parameter with which we process the gateway's input security and data handling within the gateway. This parameter will be provided by us.                                     |
| `customerId`     | This identifier will allow you to associate the biometric operation generated in our processes with your customer; it can be your email address or an identifier you have for your users. |
| `documentNumber` | This parameter is optional; you can send your customer's ID number if you have it so that we can compare it with the biometric data obtained by our process.                              |
| `callbackPath`   | Defines the parameters that will be added to the Callback URL call that we will execute to send the data captured by the biometric process.                                               |

{% hint style="warning" %}
**Note**: In case of using a **iframe** it is necessary **to keep focus within the container** that integrates the form components.

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

{% endhint %}

This is how these parameters are sent and our gateway is called in HTML:

**HTML example**

```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>
```