Saltar a contenido

Solución de problemas — Developers

Errores frecuentes durante la integración y cómo resolverlos.

invalid_grant al canjear el código preautorizado
  • Causa probable: el código ya fue consumido o caducó (TTL típico: 5 minutos).
  • Solución: pide al Issuer una nueva oferta. El código preautorizado es de un solo uso.
El wallet rechaza la credencial tras emitirla
  • Causa probable: discrepancia en el vct (Verifiable Credential Type) o falta de claves de verificación públicas en /.well-known/jwt-issuer.
  • Solución: comprueba que el vct declarado en metadata coincide con el de la credencial emitida.
El verifier no recibe la presentación
  • Causa probable: el response_uri no es accesible públicamente o tiene certificado inválido.
  • Solución: el wallet hace direct_post desde el dispositivo del usuario; el endpoint debe ser HTTPS público con cert válido.
invalid_presentation_submission
  • Causa probable: la consulta DCQL pide claims que la credencial no contiene, o la firma del Key Binding JWT no valida.
  • Solución: revisa que la credencial presentada cumple la query y que el nonce del KB-JWT coincide con el de la solicitud.
invalid_dpop_proof
  • Causa probable: el htu o htm del DPoP no coincide con la URL/método real, o el iat está fuera de ventana.
  • Solución: verifica que regeneras el DPoP en cada request; no reutilices uno entre llamadas.
404 o tenant not found con dominio correcto
  • Causa probable: el subdominio no está aprovisionado o la sesión apunta a otro tenant.
  • Solución: confirma con soporte que el tenant está activo y que tu cliente OAuth está registrado en él.

¿Sigues sin resolverlo?

Contacta con soporte. Adjunta:

  • Endpoint y método exacto.
  • Request completa (sanitizando secretos).
  • Respuesta recibida.
  • trace-id si la respuesta lo incluye.