Saltar al contenido principal

Troubleshooting

Recepción de credenciales​

La wallet muestra "Formato de credencial no soportado"​

Síntoma: al escanear un QR o abrir un deep link de emisión, la wallet muestra un error indicando que el formato no es compatible.

Causa: el emisor está ofreciendo la credencial en un formato distinto de jwt_vc_json. Los formatos vc+sd-jwt y ldp_vc no están soportados.

Solución: contacta con el emisor para confirmar que la oferta usa el formato jwt_vc_json. Si el emisor está en el ecosistema ISBE, puede consultar la Referencia OID4VCI/VP para adaptar la configuración.

La wallet muestra "Código de transacción incorrecto"​

Síntoma: al introducir el PIN del tx_code la wallet rechaza el código.

Causas frecuentes:

  • El código ha expirado. Los códigos de transacción tienen un tiempo de validez corto definido por el emisor.
  • El código fue introducido con un carácter erróneo.
  • El código ya fue usado en un intento anterior fallido y el emisor lo ha invalidado.

Solución: solicita un nuevo código al emisor e inténtalo de nuevo.

La wallet muestra "Oferta de credencial expirada"​

Síntoma: el QR o el deep link ya no es válido.

Causa: el pre-authorized_code de la oferta tiene un tiempo de validez (definido por el emisor) que ha transcurrido.

Solución: solicita al emisor que genere una nueva oferta de credencial.

La credencial queda en estado "Pendiente" indefinidamente​

Síntoma: después de aceptar una oferta, la credencial aparece como pendiente y no llega.

Causa: el emisor usa emisión diferida (deferred issuance) y aún no ha procesado la solicitud.

Solución: la wallet reintenta la consulta al endpoint /deferred_credential de forma periódica. Si la credencial no llega en un tiempo razonable, contacta con el emisor para verificar el estado del proceso.

La wallet no puede escanear el QR​

Síntoma: la cámara no detecta el código QR.

Causas frecuentes:

  • El permiso de cámara no está concedido a la wallet.
  • La iluminación es insuficiente.
  • El QR está dañado o es demasiado pequeño en pantalla.

Solución: ve a los ajustes del sistema operativo y verifica que la wallet tiene permiso de cámara. Ajusta la iluminación o amplía el QR en la pantalla del emisor.

Presentación de credenciales​

La wallet no encuentra ninguna credencial que cumpla la solicitud​

Síntoma: después de escanear el QR de un verificador, la wallet indica que no tienes ninguna credencial que satisfaga los criterios.

Causas frecuentes:

  • No tienes la credencial del tipo solicitado. El verificador está pidiendo un tipo de credencial que no has recibido aún.
  • La credencial que tenías ha expirado.
  • El DCQL query del verificador requiere atributos específicos que tu credencial no incluye.

Solución: obtén la credencial del tipo solicitado del emisor correspondiente. Si la credencial ha expirado, solicita una renovación al emisor.

El verificador rechaza la presentación​

Síntoma: la wallet indica que la presentación fue enviada, pero el verificador devuelve un error de validación.

Causas frecuentes:

  • La credencial ha sido revocada por el emisor (la wallet no comprueba la revocación, pero el verificador sí puede hacerlo).
  • El DID del emisor no está acreditado en el TIR de ISBE para el tipo de credencial presentada.
  • El nonce en la VP no coincide con el que envió el verificador (posible problema de caché o de tiempo).

Solución: contacta con el verificador para obtener el código de error concreto. Si la credencial fue revocada, solicita una nueva al emisor.

La wallet muestra "Método de respuesta no soportado"​

Síntoma: al intentar responder a una solicitud de verificación, la wallet muestra un error de método.

Causa: el verificador está usando un response_mode distinto de direct_post. La wallet solo soporta direct_post.

Solución: el verificador debe configurar response_mode: direct_post en su authorization_request.

Identidad y cuenta​

La autenticación biométrica no funciona​

Síntoma: Face ID, Touch ID o la huella dactilar no desbloquean la wallet.

Causas frecuentes:

  • Se han añadido nuevas huellas o caras al sistema operativo después de activar la biometría en la wallet. Por seguridad, la wallet requiere reautenticación con PIN cuando cambian los datos biométricos del dispositivo.
  • La biometría del sistema operativo está desactivada.

Solución: usa tu PIN para desbloquear la wallet. Luego ve a Configuración → Seguridad para reconfigurar la autenticación biométrica.

La wallet muestra "DID no resolvible" al recibir una credencial​

Síntoma: la wallet no puede verificar la firma del emisor porque no puede resolver su DID.

Causas frecuentes:

  • El dispositivo no tiene conectividad a internet.
  • El DID del emisor no está registrado en la blockchain de ISBE del entorno correspondiente (producción, preproducción o desarrollo).

Solución: verifica la conectividad a internet. Si el problema persiste, el emisor debe comprobar que su DID está correctamente publicado en el TIR de ISBE.

Problemas generales​

La wallet se cierra inesperadamente (crash)​

Solución: cierra la aplicación por completo y vuelve a abrirla. Si el problema persiste, reinstala la wallet (las credenciales almacenadas en el dispositivo se perderán). Reporta el problema al equipo ISBE con los pasos para reproducirlo y la versión de la wallet y del sistema operativo.

¿Dónde encuentro la versión de la wallet?​

En iOS: Ajustes del sistema → ISBE Wallet → Versión.
En Android: Ajustes del sistema → Aplicaciones → ISBE Wallet → Información de la app.

También puedes consultar la versión dentro de la propia wallet en Configuración → Acerca de.