Guía del SDK web

Integra nuestros flujos web de KYC y verificación de identidad optimizados para UX con el SDK web de ComplyCube.

Resumen

El ComplyCube Web SDK es una biblioteca JavaScript ligera que te permite integrar flujos de verificación de identidad y KYC directamente en tus aplicaciones web. Proporciona un widget listo para usar y fácil de usar para capturar documentos, selfies y comprobante de domicilio, mientras gestiona la detección de calidad y las señales de fraude en segundo plano.

Demo interactiva

Unexpected error with integration arcade: Integration is not installed on this space

Pasos de integración

El Web SDK puede integrarse de dos maneras: mediante flujos de trabajo para recorridos de verificación completos, o con integración basada en comprobaciones para un control detallado.

Los pasos siguientes muestran cómo añadir el Web SDK a tu aplicación web.

Crear un cliente

Todo flujo de verificación comienza con un cliente (es decir, cliente). Usa la API para crear el cliente.

Ejemplo de solicitud

curl -X POST https://api.complycube.com/v1/clients \\
     -H 'Authorization: <YOUR_API_KEY>' \\
     -H 'Content-Type: application/json' \\
     -d '{
          "type": "person",
          "email": "john.doe@example.com",
          "personDetails":{
               "firstName": "John",
               "lastName" :"Doe"
          }
        }'

const { ComplyCube } = require("@complycube/api");

const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });

const client = await complycube.client.create({
  type: "person",
  email: "john.doe@example.com",
  personDetails: {
    firstName: "John",
    lastName: "Doe"
  }
});

from complycube import ComplyCubeClient
cc_api = ComplyCubeClient(api_key='<YOUR_API_KEY>')

new_client = {
    'type':'person',
    'email':'john.doe@example.com',
    'personDetails': {
        'firstName':'John',
        'lastName':'Doe'
    }
}

client = cc_api.clients.create(**new_client)

use ComplyCube\ComplyCubeClient;

$ccapi = new ComplyCubeClient('<YOUR_API_KEY>');

$result = $ccapi->clients()->create([
    'type' => 'person',
    'email' => 'john@doe.com',
    'personDetails' => [
        'firstName' => 'John',
        'lastName' => 'Doe'
    ]
]);

using ComplyCube.Net;
using ComplyCube.Net.Resources.Clients;

var clientApi = new ClientApi(new ComplyCubeClient("<YOUR_API_KEY>"));
var newClient = new ClientRequest {
  type = "person",
  email = "john@doe.com",
  personDetails = new PersonDetails {
    firstName = "John",
    lastName = "Doe"
  }
};

var client = await clientApi.CreateAsync(newClient);

La respuesta contendrá un id (el ID del cliente). Es necesario para el siguiente paso.

Generar un token de SDK

Los tokens permiten a los clientes enviar datos personales a ComplyCube de forma segura a través de nuestros SDK. Usa el punto de conexión para generar tokens para obtener un token de SDK e inicializar después el Web SDK.

curl -X POST https://api.complycube.com/v1/tokens \\
     -H 'Authorization: <YOUR_API_KEY>' \\
     -H 'Content-Type: application/json' \\
     -d '{
          "clientId":"CLIENT_ID",
          "referrer": "*://*/*"
        }'

const { ComplyCube } = require("@complycube/api");

const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });

const token = await complycube.token.generate("CLIENT_ID", {
    referrer: "*://*/*"
});

using ComplyCube.Net;
using ComplyCube.Net.Resources.SDKTokens;

var sdkTokenApi = new SDKTokenApi(new ComplyCubeClient("<YOUR_API_KEY>"));

var sdkTokenRequest  =  { clientId = "CLIENT_ID" , 
                        referrer = "*://*/*" }

var sdkToken = await sdkTokenApi.GenerateToken(sdkTokenRequest);

Montar el SDK

Para montar nuestro Web SDK, necesitas incluirlo en tu página de destino, como se muestra a continuación.

<!DOCTYPE html>
<html>

  <head>
    <!-- Importando la biblioteca JavaScript -->
    <script src="complycube.min.js"></script>
    
    <!-- Importando el CSS predeterminado -->
    <link rel="stylesheet" href="style.css" />
  </head>
  
  <script>
    var complycube = {};
    function startVerification() {
      complycube = ComplyCube.mount({
        token: "<YOUR_WEB_SDK_TOKEN>",
        onComplete: function(data) {
          console.log("Captura completada", data)
        },
      });
    }
  </script>
  
  <body>
    <!-- Aquí es donde se montará el Web SDK -->
    <div id="complycube-mount"></div>

    <!-- Al hacer clic en el botón se iniciará la interfaz de verificación de ComplyCube -->
    <button onClick="startVerification()">Iniciar verificación</button>
  </body>
  
</html>

Los enlaces a complycube.min.js y style.css se pueden encontrar en tu portal para desarrolladores.

Siguientes pasos

Sigue la guía completa de integración del Web SDK para explorar sus funciones y personalización opciones.