Embedded form

Landing SDK integration via an 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.

Note: In case of using a iframe it is necessary to keep focus within the container that integrates the form components.

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

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

HTML example

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