Ir al contenido

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»
  • Los motivos de falla max_attempts_reached y rate_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_attempts y el aviso de «N intentos restantes» en la respuesta de un PIN incorrecto. Esa respuesta tampoco trae ya blocked.
  • 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 webhook pin.transaction.failed, por un PIN o un código incorrectos. La transacción queda pending y la persona puede seguir intentando.

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.

  • 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_blocked só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 sigue pending, no se autoriza ni emite webhook, y la persona puede autorizarla cuando agregue un contacto. Un PIN incorrecto sigue respondiendo invalid_pin, igual para todo RUT.
  1. No esperes pin.transaction.failed por un PIN incorrecto. Una transacción con fallos sigue pending hasta 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.
  2. Maneja codigo_requerido si 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én contacto_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».
  3. Deja de leer remaining_attempts, max_attempts_reached y rate_limit_exceeded. Puedes seguir aceptándolos para leer transacciones antiguas.
  4. Trata pin_blocked como una decisión del titular o de REDCUMBRE, no como el resultado de fallos: ofrece la modalidad face, que no usa el PIN. Más detalle en PINRUT.

face_not_verified y rut_mismatch no cambian.