Volver a documentación
Guía10 min
Inicio rápido
Configura tu primera verificación de identidad con JAAK en menos de 10 minutos.
1
Obtén tus credenciales de API
Primero, necesitas crear una cuenta en JAAK y obtener tus credenciales de API.
- Regístrate en platform.jaak.ai
- Ve a Configuración → API Keys
- Genera un nuevo API Key para tu ambiente (sandbox o producción)
- Guarda tu
API_KEYyAPI_SECRET
Importante: Nunca expongas tu API_SECRET en código del lado del cliente. Úsalo solo en tu backend.
2
Instala el SDK
Instala el SDK de JAAK en tu proyecto:
npm
npm install @jaak/sdkyarn
yarn add @jaak/sdk3
Configura el cliente
Inicializa el cliente de JAAK con tus credenciales:
JavaScript / TypeScript
import { JaakClient } from '@jaak/sdk';
const jaak = new JaakClient({
apiKey: process.env.JAAK_API_KEY,
apiSecret: process.env.JAAK_API_SECRET,
environment: 'sandbox' // o 'production'
});4
Crea tu primera verificación
Crea una sesión de verificación y obtén el enlace para el usuario:
JavaScript / TypeScript
// Crear una sesión de verificación
const session = await jaak.verification.create({
type: 'identity',
config: {
documentTypes: ['ine', 'passport'],
livenessCheck: true,
faceMatch: true
},
metadata: {
userId: 'user_123',
orderId: 'order_456'
},
redirectUrl: 'https://tuapp.com/verificacion-completada'
});
console.log(session.verificationUrl);
// https://verify.jaak.ai/session/abc123
// Redirige al usuario a session.verificationUrl5
Recibe el resultado
Configura un webhook para recibir el resultado de la verificación:
Express.js ejemplo
app.post('/webhooks/jaak', async (req, res) => {
const { event, data } = req.body;
// Verifica la firma del webhook
const isValid = jaak.webhooks.verify(
req.headers['x-jaak-signature'],
req.body
);
if (!isValid) {
return res.status(401).send('Invalid signature');
}
if (event === 'verification.completed') {
const { sessionId, status, result } = data;
if (status === 'approved') {
// Usuario verificado exitosamente
console.log('Verificación aprobada:', result);
} else {
// Verificación rechazada
console.log('Verificación rechazada:', result.reason);
}
}
res.status(200).send('OK');
});¡Listo!
Ya tienes una integración básica funcionando. El usuario será redirigido a JAAK para completar su verificación, y recibirás el resultado vía webhook.