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

# Formulário incorporado

### Método sem informação extra (formulário)

Se você precisar que nosso gateway processe informações extras de seus clientes ou receba informações que só você gerencia, deve usar o método POST. É muito simples chamar nossa página de destino por meio de uma chamada POST, inserindo no corpo os seguintes campos:

| CAMPO            | DESCRIÇÃO                                                                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `apiKey`         | Este é o parâmetro com o qual processamos a segurança de entrada da gateway e o tratamento de dados dentro da gateway. Este parâmetro será fornecido por nós.                        |
| `customerId`     | Este identificador permitirá associar a operação biométrica gerada em nossos processos ao seu cliente; pode ser seu e-mail ou um identificador que você tenha de seus usuários.      |
| `documentNumber` | Este parâmetro é opcional, você pode enviar o número de identificação do seu cliente, se o tiver, para que possamos compará-lo com os dados biométricos obtidos pelo nosso processo. |
| `callbackPath`   | Define os parâmetros que serão adicionados à chamada da URL de Callback que executaremos para enviar os dados capturados pelo processo biométrico.                                   |

{% hint style="warning" %}
**Nota**: No caso de utilizar um **iframe** é necessário **manter o foco dentro do contêiner** que integra os componentes do formulário.

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

{% endhint %}

É assim que esses parâmetros são enviados e nossa gateway é chamada em html:

**Exemplo em HTML**

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