Registro de cambios de la API
2026-11-08 · PINRUT: el PIN ya no se bloquea por intentos fallidos
Sección titulada «2026-11-08 · PINRUT: el PIN ya no se bloquea por intentos fallidos»Qué deja de producirse
Sección titulada «Qué deja de producirse»- Los motivos de falla
max_attempts_reachedyrate_limit_exceeded. Siguen en el catálogo sólo porque hay transacciones históricas que los traen: ya no se producen en transacciones nuevas. - El campo
remaining_attemptsy el aviso de «N intentos restantes» en la respuesta de un PIN incorrecto. Esa respuesta tampoco trae yablocked. - El bloqueo automático del PIN por intentos fallidos: ni por los intentos de una transacción ni por el tope de fallos por RUT por hora.
- El paso de la transacción a
failed, y el webhookpin.transaction.failed, por un PIN o un código incorrectos. La transacción quedapendingy la persona puede seguir intentando.
Por qué
Sección titulada «Por qué»Con el bloqueo automático, un tercero que conociera el RUT de otra persona podía fallar a propósito su PIN hasta bloquear el PIN de otra persona, sin tener ningún acceso a su cuenta. Un bloqueo que cualquiera puede provocar es una forma de negar el servicio a la persona legítima. Ahora los fallos no bloquean a nadie: piden una prueba extra.
Qué pasa ahora
Sección titulada «Qué pasa ahora»- Tras 3 fallos del PIN en un mismo canal (o 10 sumando canales), la plataforma pide un código propio que
envía a los contactos verificados de la persona. Quien se equivoca recibe la respuesta
codigo_requerido, la misma para cualquier RUT: no revela si el RUT tiene PIN ni si el envío salió. - La persona entrega el código en
POST /p/pin/authorize/:idPublico/codigo(es la pantalla pública de autorización la que lo hace; tu integración no llama ese endpoint). - Si un integrador acumula más de 100 fallos en una hora, el umbral del código se adelanta a 1 fallo para sus transacciones. No se bloquea la creación de transacciones ni se hace esperar a quien escribe bien su PIN.
pin_blockedsólo aparece cuando el titular o REDCUMBRE bloqueó el PIN. Es el mensaje que verás.- Si el PIN es correcto pero la persona no tiene ningún correo ni celular verificado, la respuesta es
contacto_requerido(«Agrega un contacto verificado en pinrut.cl para usar tu PIN»). La transacción siguepending, no se autoriza ni emite webhook, y la persona puede autorizarla cuando agregue un contacto. Un PIN incorrecto sigue respondiendoinvalid_pin, igual para todo RUT.
Qué tienes que hacer
Sección titulada «Qué tienes que hacer»- No esperes
pin.transaction.failedpor un PIN incorrecto. Una transacción con fallos siguependinghasta que se autoriza, vence (pin.transaction.expired) o la cancelas. Si tu sistema cerraba la operación al recibir ese evento por intentos agotados, ahora cierra por vencimiento o por cancelación. - Maneja
codigo_requeridosi construyes tu propia pantalla de autorización: indica a la persona que le llegará un código y que, si no le llega, intente de nuevo en unos minutos. Maneja tambiéncontacto_requerido: indica a la persona que agregue un contacto verificado en pinrut.cl y que después vuelva a autorizar; no le muestres «PIN incorrecto». - Deja de leer
remaining_attempts,max_attempts_reachedyrate_limit_exceeded. Puedes seguir aceptándolos para leer transacciones antiguas. - Trata
pin_blockedcomo una decisión del titular o de REDCUMBRE, no como el resultado de fallos: ofrece la modalidadface, que no usa el PIN. Más detalle en PINRUT.
face_not_verified y rut_mismatch no cambian.