Biometría

Con el servicio de verificación por biometría, los clientes serán redireccionados a una web en donde deberán tomar fotografías de su documento de identidad, así como de su rostro. De esta forma, sus transacciones estarán aún más seguras.

Crea una nueva biometría

Tu front-end será el encargado de recopilar los datos necesarios de tu cliente, mientras que tu back-end estará integrado con nuestra API, procesando la creación de la biometría.

De este modo, para crear una solicitud de nueva biometría, deberás usar este endpoint. La solicitud se envía con tu bearer token, así como con tu firma secreta. Además, debes incluir los datos necesarios del cliente, como: nombre y apellido, correo electrónico, teléfono, país, fecha de nacimiento, entre otros.

🚧

Firma de la transacción

Puedes ver el detalle de cómo firmar los parámetros de la transacción con tu secretKey en este artículo.

También deberás incluir la URL de retorno a la cual será redireccionado el cliente después de completar el proceso de la toma de fotografías.

📘

Notificación del estado de la transacción

Para configurar el webhook que irá en el campo confirmationURL y recibir notificaciones con el estado de tu transacción, revisa este artículo.

Body de la solicitud

A continuación puedes ver un ejemplo del body que se envía en la solicitud:

{
  "email": "[email protected]",
  "firstName": "Jhon",
  "lastName": "Doe",
  "documentNumber": "12345678912",
  "dateOfBirth": "1990-05-30",
  "phone": "999999999",
  "country": "CL",
  "reference": "Local",
  "redirectUrl": "example.com/successful",
  "confirmationUrl": "Webhook",
  "sign": "Signature of the parameters"
}

Respuesta

Como respuesta a una solicitud de biometría exitosa, recibirás un enlace para redirigir al usuario a la página en donde tomará las fotografías indicadas.

Ejemplo de respuesta exitosa:

{
  “status”: <Request status>, // Status table at the end of the document. 
  “verified”: <true | false>, 
  “verificationUrl”: <Biometrics link, the user should be redirected to this link to complete the process.>, 
  “reference”: <Biometrics reference>, // This reference is ours and unique, it is used to verify the biometrics in the ProntoPaga system.  
}  

Ejemplo de respuesta fallida:

{
  "error": {
    "documentNumber": "(string) documentNumber, cannot be null."
  }
}

Confirmación de una biometría

Una vez que el usuario haya completado el proceso de la toma de fotografías, ProntoPaga lo redireccionará a la URL de retorno. Al mismo tiempo, devolverá los datos de la transacción al webhook que hayas agregado.

De este modo, para confirmar si una biometría fue exitosa, debes verificar que en tu webhook el valor del campo status sea success.

Detalles de una biometría

También puedes consultar los detalles de una biometría creada de forma exitosa anteriormente. Para hacerlo, debes de consultar este endpoint, en donde deberás enviar el número referenceen el path.

Respuesta

Como respuesta a una solicitud de detalles de una biometría, recibirás la información con la que fue creada y registrada dicha biometría.

Ejemplo de respuesta exitosa:

{ 
  “status”: <Biometrics status>, 
  “note”: <Note/message on the status of biometrics>, 
  “reference”: <Biometrics reference>, 
  “documentNumber”: <Customer document number>, 
  “firstName”: <Customer name>, 
  “lastName”: <Customer lastname>, 
  “email”: <Customer email> 
} 

Ejemplo de respuesta fallida:

{
  "message": "Token could not be found."
}