Página alojada de IDV y toolkit
Genere una página de verificación de identidad o incorpore un flujo de IDV en su página web.
La página alojada de IDV (verificación de identidad, por sus siglas en inglés) es una página segura generada para que los usuarios envíen una solicitud para verificar la identidad de un contacto personal para una Billetera Rapyd. Puede incorporar la página alojada de IDV en su página web con la integración del toolkit de IDV para tener más control sobre la experiencia del usuario y el flujo de incorporación.
La integración de la página alojada IDV y el toolkit de IDV lo ayudarán a recopilar información personal para verificar un contacto para una billetera Rapyd. Las billeteras Rapyd se crean por medio de la API y con el Client Portal.
Casos de uso comunes
Sus usuarios se registran en su plataforma para crear su billetera y deben verificar su identidad antes de depositar fondos.
Sus contratistas verifican su identidad para recibir fondos directamente en su billetera y desembolsar cuando deseen.
Seleccione su país de residencia.
Haga clic en Iniciar verificación.

Suba una imagen de su rostro.
Suba imágenes de su ID.
Haga clic en Confirmar.

Rediríjase a la página verificación de identidad exitosa.


Usted solicita Crear una billetera para un contacto personal y recopila su información.
Rapyd crea una billetera para el contacto y envía una notificación.
Usted solicita crear una página alojada de IDV y envía la URL al contacto.
El contacto completa la página alojada y Rapyd le envía una notificación.

Usted solicita Crear una billetera para un contacto personal y recopila su información.
Rapyd crea una billetera para el contacto y envía una notificación.
Usted solicita crear una página alojada de IDV e inicializa el objeto de la página alojada de IDV y pasa el ID de la página empezando por hpidv.
El contacto completa el flujo de IDV en su página web y Rapyd le envía una notificación.
El siguiente diagrama de estados finitos resume los estados de la página alojada de verificación de identidad.
Descripción de los estados
Estado | Descripción |
|---|---|
NEW | Nuevo: Se creó la página alojada de verificación de identidad. |
DON | Hecho: La página alojada se completó. Se envió la información requerida. |
EXP | Caducada: La página alojada de verificación de identidad ha caducado. |
Crear una billetera Rapyd y el contacto personal de la billetera.
Consulte Crear página de verificación de identidad para ver una lista completa de los parámetros.
La solicitud de la página alojada de IDV.
JSON
{ "reference_id": "Test Verification Page 1", "ewallet": "ewallet_16cdeb38381a7ceb2adf2e8dafe7670d", "contact": "cont_762a36e4a1dcc83488e2aa73144699aa", "page_expiration": 1608621351 }
Veamos la respuesta.
JSON
{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "a74f452b-9d7f-4515-96b1-d35b7b057513" }, "data": { "id": "hp_idv_828956a2afc36116cccee49fe4cd671e", "status": "NEW", "reference_id": "Test Verification Page 1", "wallet": "ewallet_16cdeb38381a7ceb2adf2e8dafe7670d", "contact": "cont_762a36e4a1dcc83488e2aa73144699aa", "language": null, "country": null, "page_expiration": 1644454928, "request_type": "verify", "redirect_url": "https://sandboxhosted.rapyd.net/idv?token=hp_idv_828956a2afc36116cccee49fe4cd671e", "merchant_website": "http://rapyd.net", "merchant_color": "323fff", "merchant_logo": null, "cancel_url": null, "complete_url": null, "force_camera": false, "document_type": null } }
Con la página alojada de IDV, el cliente puede redirigir al usuario a la URL devuelta en el campo redirect_url o comparta esta URL con su usuario como enlaces independientes.
Con el kit de herramientas, el cliente puede incorporar la página IDV en su página web o aplicación.
Puede personalizar su página alojada de IDV siguiendo la guía Personalización de la página alojada para editar su página en el Client Portal.
Utilice el toolkit de IDV para incorporar el flujo de trabajo de IDV directamente en su página web.
Tras crear una página IDV alojada, complete los siguientes pasos.
Agregue el siguiente código a su página de IDV:
Agregue un tag <script> con la URL del toolkit de IDV de Rapyd:
<script src="https://toolkit.rapyd.net"></script>
Nota: Para ejecutar este método en el sandbox, use el siguiente código:
<script src="https://sandboxtoolkit.rapyd.net"></script>
Agregue una etiqueta con id="rapyd-toolkit»:
<div id="idv"></div>
Inicialice el objeto de página de IDV con los siguientes campos:
JavaScript
let toolkit = new RapydToolkit({ button_text: "Confirm", // Text that appears on the 'Confirm' button. // String. Maximum length is 16 characters. // Default is "Confirm". Optional. button_color: "blue", // Color of the ‘Confirm’ button. String. // Standard CSS color name or hexadecimal code such as #323fff. // Default is the color that is returned in the 'merchant_color' // field of the response to 'Create IDV Page'. Optional. id: "hp_idv_828956a2afc36116cccee49fe4cd671e", // ID of the 'Identity Verification' response. String. Required. close_on_complete: true, // Causes the embedded Rapyd IDV Toolkit window to close // when the submission is complete. Boolean. Default is 'true'. Optional. page_type: "idv" /* Mandatory for Identity Verification page Default is "collection". */ });
Llame a Display Toolkit () para mostrar la página de IDV.
toolkit.displayToolkit();
Paso opcional. Si close_on_complete se establece en falso, llame a Toolkit.closeToolkit () para cerrar la ventana de Rapyd IDV Toolkit
toolkit.closeToolkit();
Inserte el código que se ejecuta cuando se producen los siguientes eventos. Use su código para leer el campo del evento del objeto de la ventana.
JavaScript
window.addEventListener('onSubmitIdvSuccess', (event) => { console.log(event.detail) // Client code. }) window.addEventListener('onIdvFailure', (event) => { console.error(event.detail.error) // Returns an error message from the API. // Client code. }) window.addEventListener('onSubmitIdvFailure', (event) => { console.error(event.detail.error) // Triggered on failed identity verification request // Client code. }) window.addEventListener('onLoading', (event) => { console.log(event.detail.loading) // returns true or false depending on the loading state // Client code })
Este es un ejemplo de una página IDV de Rapyd creada con el kit de herramientas:
HTML
<!DOCTYPE html> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Rapyd Identity Verification</title> <script src="https://toolkit.rapyd.net"></script> <script> window.onload = function () { let toolkit = new RapydToolkit({ button_text: "Confirm", button_color: "blue", id: "hp_idv_828956a2afc36116cccee49fe4cd671e" }); toolkit.displayToolkit(); } window.addEventListener('onSubmitIdvSuccess', function (event) { console.log(event.detail) }); window.addEventListener('onIdvFailure', function (event) { console.log(event.detail.error) }); </script> </head> <body style="background-color: #f1f1f1; display: flex; align-items: center; flex-direction: column; margin: 0"> <h1>Rapyd Identity Verification Demo</h1> <div style="width: 500px" id="idv"></div> </body> </html>
Nota
A los clientes les aparece el evento onSubmitIdvSuccess con el objeto verificación de identidad, tras el envío exitoso.
Tome nota de los siguientes campos de objeto de la página alojada de verificación de identidad y de las tareas asociadas a cada uno de ellos.
Descripción de los campos
Campo | Descripción | Acción |
|---|---|---|
status | Estado de la identidad verificada. Una de las siguientes opciones:
Solo respuesta. | Puede usar este campo para comprobar el estado de la verificación, ya sea nueva o finalizada. |
ewallet_id | ID de la billetera Rapyd. Cadena que comienza por ewallet_. | Utilícelo cuando solicite verificar la identidad o webhooks transitorios. Además, el ID de la operación de verificación de identidad empezará por kycid_. |
verification_status | Indica si el individuo fue aprobado. Una de las siguientes opciones:
| Puede usar este campo para comprobar el estado de verificación detallado. |