WP Two-Factor Bridge

El problema

Una tienda de juegos digitales completa pedidos sobre cuentas de consola protegidas con verificación en dos pasos. Cada pedido necesitaba por tanto un código de un solo uso justo en el momento en que un operador trabajaba en él, y los códigos rotan cada treinta segundos. Los operadores los leían de una app del móvil, los pegaban en el chat y perdían pedidos cada vez que un código caducaba a mitad del traspaso.

Los clientes también lo sufrían. Quien vinculaba su propia cuenta no tenía forma de ver su código actual sin instalar un autenticador y repetir todo el ritual de emparejamiento. Y nada comprobaba, en el momento del pago, si realmente se podía producir un código para ese pedido: el fallo aparecía después, en la entrega, con el cobro ya hecho.

Antes → Después

Cómo funciona

1. Se vincula una cuenta. El cliente abre la página de vinculación y apunta la cámara al código QR de emparejamiento, o sube una captura. La imagen se decodifica en el navegador y se envía al plugin, que registra la cuenta en el servicio de códigos y devuelve su identidad y su código actual.
2. Los datos de la cuenta viven en el perfil. La dirección de la cuenta de consola se guarda como campo de WooCommerce, se muestra en el perfil del admin, en el área de cliente, en el pago y en la ficha del pedido, y se rellena sola en la siguiente compra.
3. El código se pide cuando hace falta. Dos endpoints sirven códigos: uno por dirección de cuenta y otro por identificador interno, de modo que la página del cliente y las herramientas internas leen de la misma fuente en vez de guardar copias propias.
4. Los formularios públicos están protegidos. El formulario de solicitud se renderiza tras una verificación anti-bot, para que el endpoint no sea un servicio de consulta gratuito para quien adivine una dirección.
5. Los pedidos pagados se verifican. Cuando un pedido pasa a proceso, el plugin comprueba que realmente se pueda producir un código para su cuenta: salvo que el comprador haya pedido a la tienda una cuenta nueva. Si no se puede, el fallo se registra y se escribe como nota del pedido, así el problema es visible antes de que un operador lo tome.
6. Todo pasa por un único servicio. Endpoint y token se configuran una vez en el admin; el plugin no contiene lógica propia de generación de códigos, de modo que cambiar el servicio es un cambio de ajustes.

Funciones clave

• Dos shortcodes: vincular una cuenta y obtener el código actual
• Emparejamiento por QR con cámara o subida de imagen, decodificado en el cliente
• Endpoints REST: código por dirección, código por identificador y acceso por QR
• Campos de cuenta de consola en perfil, área de cliente, pago y ficha de pedido
• Endpoints propios de WooCommerce: las páginas viven dentro de Mi cuenta
• Observador de pedidos que marca los pagados sin código alcanzable
• Verificación anti-bot delante de los formularios públicos
• Una sola pantalla de ajustes para endpoint y token del servicio

Instalación

1. Suba la carpeta del plugin a /wp-content/plugins/ y actívelo
2. Abra Two Fa en la barra lateral del admin e indique el endpoint y el token del servicio de códigos
3. Añada allí mismo la clave y el secreto de la verificación anti-bot
4. Refresque los enlaces permanentes una vez para que resuelvan los endpoints link-2fa y get-2fa
5. Opcionalmente coloque [2fa_link] y [2fa_get_code] en páginas independientes