Obtener el link de verificación de identidad (KYC) del suscriptor
GET/certificate-request/:id/kyc-link
Devuelve el link del portal de verificación biométrica (MetaMap) que el suscriptor debe abrir para acreditar su identidad. Si el link ya fue capturado (se captura automáticamente cuando Viafirma pasa la solicitud a 'accreditation' y queda guardado), se devuelve siempre, sin importar el estado remoto actual. Si aún no fue capturado, solo se obtiene de Viafirma cuando el estado remoto es exactamente 'accreditation'; en ese caso se guarda para las siguientes consultas. Cuando el callback está habilitado, el link incluye los parámetros redirect (apunta a GET /viafirma/kyc-callback/{publicId}) y target. El mismo link se expone en GET /certificate-request/{id}/issuance (dataRecords.data.kyc_accreditation_link). Si la solicitud tiene varios trámites Viafirma (p. ej. un reintento), se usa el trámite vigente, el mismo que informa GET /certificate-request/{id}/issuance (prioridad: con certificado emitido > con KYC completado > en curso > fallido > cancelado > sin estado; a igual prioridad, el más reciente).
Request
Responses
- 200
- 401
- 404
- 422
- 429
- 500
Link KYC disponible. El link viene en data.link (no en dataRecords).
No autenticado (token ausente, inválido o expirado).
La solicitud no existe o pertenece a otra empresa (el administrador accede a todas): mensaje Solicitud de certificado no encontrada.. La solicitud existe pero no tiene trámite Viafirma (su emisión con Viafirma aún no se ha iniciado o se emite con otro proveedor): mensaje Recurso no encontrado.; si la emisión con Viafirma está por iniciarse, reintente más tarde.
El link aún no está disponible o Viafirma RA no pudo entregarlo. Casos: no fue capturado y el estado remoto no es 'accreditation' (el mensaje indica el estado actual); el trámite aún no tiene código de solicitud en Viafirma; o Viafirma RA respondió con error o con una respuesta inválida. En este último caso el mensaje es un texto fijo, sin el detalle técnico remoto: Error de comunicación con Viafirma RA. Intente nuevamente. (fallo de comunicación o error transitorio; reintente), Viafirma no admite la operación en el estado actual de la solicitud., Viafirma no encuentra la solicitud asociada. o El servicio de Viafirma rechazó la operación. Revisa los datos e intenta de nuevo. (puede terminar en Código: <código de error de Viafirma>.).
Límite general de 60 peticiones por minuto excedido.
Error interno. Nota: un {id} no numérico también responde 500, pero con el cuerpo genérico del framework ({"message":"Server Error"}, sin success; página HTML si la petición no envía Accept: application/json).