Skip to main content
GET
/
api
/
kyc
/
validations
/
{id}
Obtener URL de Verificación KYC
curl --request GET \
  --url http://api.gu1.ai/api/kyc/validations/{id} \
  --header 'Authorization: Bearer <token>'

​
Resumen

Después de crear una validación KYC, puedes recuperar la URL de verificación en cualquier momento. Esta URL es la que compartirás con tu cliente para que complete el proceso de verificación de identidad.

​
Cuándo Usar Esto

  • Recuperar URL después: Si no guardaste la URL de la respuesta de creación
  • Reenviar al cliente: Cuando el cliente solicita un nuevo enlace
  • Verificar detalles: Ver estado actual y metadata
  • Integrar con otros sistemas: Pasar la URL a servicios de notificación

​
Solicitud

​
Endpoint

GET https://api.gu1.ai/api/kyc/validations/{id}

​
Parámetros de Ruta

​
id
string
required
El ID de validación devuelto al crear la validación KYC

​
Respuesta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "entityId": "123e4567-e89b-12d3-a456-426614174000",
  "providerSessionUrl": "https://verify.example.com/session_xyz789",
  "status": "pending",
  
  "isCurrent": true,
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z"
}

​
Valores posibles de status

El campo status puede ser: pending, in_progress, in_review, approved, rejected, expired, abandoned, cancelled. Consulta Verificar estado para la descripción de cada uno.

​
Ejemplo

const validationId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.gu1.ai/api/kyc/validations/${validationId}`,
  {
    headers: {
      'Authorization': 'Bearer TU_API_KEY'
    }
  }
);

const validation = await response.json();
const urlVerificacion = validation.providerSessionUrl;
console.log('Comparte esta URL con tu cliente:', urlVerificacion);

​
Alternativa: Obtener Validación Actual por Entidad

Si no tienes el ID de validación pero tienes el ID de entidad: 
GET https://api.gu1.ai/api/kyc/entities/{entityId}/current

​
Compartir la URL con Clientes

​
Ejemplo de Email

<p>Hola {{nombreCliente}},</p>
<p>Por favor completa tu verificación de identidad para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Tu Identidad</a></p>
<p>Este enlace expirará en 7 días.</p>

​
Ejemplo de SMS

Completa tu verificación de identidad aquí: {{providerSessionUrl}}

​
Integración en App

// Redirigir usuario a verificación
window.location.href = providerSessionUrl;

// O abrir en nueva ventana
window.open(providerSessionUrl, '_blank');

// O embeber en iframe
<iframe src={providerSessionUrl} width="100%" height="600px" />

​
Próximos Pasos

Integración Webhook

Recibir actualizaciones en tiempo real

Verificar Estado

Consultar resultados de validación