====== Billetera ======
La opción **Billetera** te permite guardar de forma segura una tarjeta bancaria para agilizar futuros pagos dentro de la plataforma. Estos pagos pueden ser pagos en línea o pagos recurrentes, según lo que tu colegio tenga habilitado.

**Nota:** La pestaña **Billetera** solo aparece si tu colegio tiene habilitado el servicio de pagos en línea o de pagos recurrentes.

===== Consultar tus tarjetas =====
  - En el menú de la izquierda, selecciona **Datos personales**.
  - Selecciona la pestaña **Billetera**.
  - Verás una tarjeta por cada método de pago que hayas registrado, con su alias, el ícono del banco emisor, **Número de tarjeta** (enmascarado), **Nombre** del tarjetahabiente y su fecha de vencimiento; si está por vencer o ya venció, en vez de la fecha verás "Expira pronto" o "Expirada" en rojo.
  - Si no has registrado ninguna tarjeta, verás el aviso "No se han agregado tarjetas".
  - Cada tarjeta puede mostrar una o varias de estas etiquetas, según su estado:
    * "Actualización requerida": la plataforma necesita que vuelvas a capturar los datos de esa tarjeta (ver "Actualizar los datos de una tarjeta").
    * "Preferida": es la tarjeta que la plataforma usa por defecto para tus pagos en línea.
    * "En línea": la tarjeta está registrada para pagos en línea no recurrentes.
    * "Recurrentes": la tarjeta está activa para pagos automáticos recurrentes.
    * "Recurrentes revisando contrato": el contrato de pagos recurrentes que firmaste está en espera de activación.
    * "Recurrentes contrato pendiente": todavía falta firmar y cargar el contrato de pagos recurrentes.
    * "Recurrentes sin asignar": tu colegio desactivó los pagos recurrentes de esa tarjeta y no tiene estudiantes asociados.
  - Si alguna tarjeta con pagos recurrentes tiene el contrato pendiente de firma, verás además el aviso "Es necesario subir el contrato firmado de la tarjeta: [alias de la tarjeta]"; da clic en el aviso para ir al detalle de esa tarjeta y completar la firma.
  - Si acabas de registrar una tarjeta, es posible que veas el aviso "El registro de la tarjeta puede tardar hasta que el banco confirme la operación".
  - Da clic en **Detalles** para ver la información completa de una tarjeta.
  - Da clic en el ícono {{icon>fas fa-ellipsis-vertical}} para ver más acciones sobre la tarjeta:
    * **Modificar:** te lleva a la pantalla para modificar el alias y los datos del tarjetahabiente de esa tarjeta (ver "Modificar los datos de una tarjeta").
    * **Preferir:** solo aparece si la tarjeta tiene pagos en línea activos y todavía no es tu tarjeta preferida; la convierte en tu tarjeta preferida para pagos en línea.
    * **Eliminar:** solo aparece si la tarjeta no tiene pagos recurrentes activos, o si tiene la etiqueta "Actualización requerida"; te pide confirmar con el aviso "¿ Está seguro que desea eliminar la tarjeta ?" y, al aceptar, elimina la tarjeta de tu **Billetera**.
  - Si una tarjeta tiene la etiqueta "Actualización requerida", en vez del menú de acciones verás directamente el botón **Actualizar datos** (ver "Actualizar los datos de una tarjeta").

===== Ver el detalle de una tarjeta =====
  - En tu **Billetera**, da clic en **Detalles** de la tarjeta que quieras consultar.
  - Se abre un panel con las pestañas **Detalles** (activa) y **Modificar**, con el alias de la tarjeta y, si es tu tarjeta preferida, la etiqueta "Preferida".
  - Debajo verás los datos del tarjetahabiente: **Nombre del tarjetahabiente**, **Apellido(s) del tarjetahabiente** (solo si tu tarjeta ya lo tenía registrado), **Correo electrónico del tarjetahabiente**, **Número de tarjeta** (enmascarado) y su fecha de vencimiento, con "Expira pronto" o "Expirada" en rojo cuando corresponda.
  - Si el registro de la tarjeta sigue en proceso, verás el aviso "Encender una tarjeta puede tardar hasta que el banco confirme la operación".

<notes>FALTA_CAPTURA — pantalla: Profesor → Datos personales → Billetera → Detalles; mostrar: el panel completo con los datos del tarjetahabiente y la sección Opciones; archivo sugerido: :t:personal_data:billetera_detalle.png</notes>

==== Opciones de pagos en línea y pagos recurrentes ====
  - En el detalle de la tarjeta, la sección **Opciones** muestra el estado de **Pagos en línea** y de **Pagos recurrentes**, con un ícono verde si están "Activos" y rojo si están "Inactivos"; los pagos recurrentes también pueden mostrar "Contrato en revisión" (ya firmaste el contrato y está en espera de activación) o "Contrato pendiente" (todavía falta firmar o cargar el contrato).
  - Si la tarjeta no tiene pagos en línea y tu colegio tiene disponible un servicio de pagos por internet para el mismo proveedor con el que registraste la tarjeta, verás el botón **Encender**: da clic, revisa tus datos del tarjetahabiente en el aviso "Encender pagos en línea" junto con el mensaje "Validaremos su tarjeta con un cargo de $5.00 MXN." y da clic en **Aceptar**.
  - Si los pagos en línea de la tarjeta ya están activos, verás el botón **Apagar**; se te pide confirmar con "¿ Está seguro que desea apagar los pagos en línea para esta tarjeta ?".
  - Si los pagos en línea están apagados y tu colegio sigue teniendo disponible el servicio, verás el botón **Encender** para reactivarlos, confirmando con "¿ Está seguro que desea encender los pagos en línea para esta tarjeta ?".
  - De la misma forma, si la tarjeta no tiene pagos recurrentes y tu colegio tiene disponible un servicio de pagos recurrentes para el mismo proveedor de la tarjeta, verás el botón **Encender**: se abre el aviso "Encender pagos recurrentes", donde eliges el o los **Servicios de pagos recurrentes** y, para cada uno, el o los estudiantes asociados a ti, capturas el **CVV** de la tarjeta y confirmas los mensajes "Validaremos su tarjeta con un cargo de $5.00 MXN." y, si hay servicios disponibles, "Firme el contrato tras encender."
  - Si los pagos recurrentes de la tarjeta ya están activos, verás el botón **Apagar**, que pide confirmar con "¿ Está seguro que desea apagar los pagos recurrentes para esta tarjeta ?".
  - Si los pagos recurrentes están apagados y tu colegio sigue teniendo servicios disponibles para el proveedor de la tarjeta, verás el botón **Encender** para reactivarlos, seleccionando de nuevo servicios y estudiantes con el mismo aviso "Encender pagos recurrentes" (solo con el mensaje "Firme el contrato tras encender.").
  - **Nota:** solo se ofrecen para encender los servicios de pagos en línea o recurrentes del mismo proveedor de pago con el que ya registraste la tarjeta; si tu colegio no tiene disponible ningún servicio de ese proveedor, no verás el botón **Encender**.

==== Asociaciones y contrato de pagos recurrentes ====
  - Si la tarjeta tiene pagos recurrentes activos, verás además la sección **Asociaciones**, con cada servicio y, debajo, el o los estudiantes vinculados a ese servicio con esa tarjeta.
  - Si todavía no has asociado ningún estudiante a un servicio de pagos recurrentes activo, verás el aviso "Es necesario seleccionar al menos un servicio y un estudiante".
  - Si tu tarjeta tiene pagos recurrentes y ya cuenta con un contrato firmado, verás el panel **Contrato firmado** con el botón **Descargar contrato**; si los pagos recurrentes de la tarjeta todavía no están activos, también verás el botón **Eliminar contrato**, que pide confirmar con "¿ Está seguro que desea eliminar el contrato firmado ?".
  - Si ya firmaste el contrato y tu firma se está procesando, verás el panel **Contrato para pagos recurrentes** con el aviso "Tu firma se está procesando; la tarjeta se podrá activar cuando se reciba el contrato firmado".
  - Si todavía no firmas el contrato y tu colegio tiene habilitada la firma electrónica, verás el panel **Contrato para pagos recurrentes** con el texto "Da clic para firmar el contrato de esta tarjeta" y el botón **Firmar contrato**, que te lleva a firmarlo electrónicamente.
  - Si tu colegio no tiene habilitada la firma electrónica y ya asociaste al menos un estudiante a la tarjeta, verás el panel **Contrato para pagos recurrentes** con tres pasos: **Descargue el contrato** (con el botón **Descargar contrato**), "Lea y firme el contrato descargado" con el aviso "Importante": "Para que el administrador del colegio active su tarjeta para pagos recurrentes, es necesario que adjunte el contrato firmado." y **Adjunte el contrato firmado**, adjuntando el archivo firmado y dando clic en **Aceptar**.
  - **IMPORTANTE:** una vez que subes el contrato firmado, es el administrador de tu colegio quien activa la tarjeta para pagos recurrentes; tú no puedes activarla ni desactivarla desde tu **Billetera**.

<notes>FALTA_CAPTURA — pantalla: Profesor → Datos personales → Billetera → Detalles → Contrato para pagos recurrentes; mostrar: el panel del contrato con sus tres pasos (Descargue el contrato / Lea y firme / Adjunte el contrato firmado); archivo sugerido: :t:personal_data:billetera_contrato_recurrentes.png</notes>

===== Modificar los datos de una tarjeta =====
  - En tu **Billetera**, da clic en el ícono {{icon>fas fa-ellipsis-vertical}} de la tarjeta y selecciona **Modificar**.
  - Se abre un panel con las pestañas **Detalles** y **Modificar** (esta última activa) y el título **Modificar**.

<notes>FALTA_CAPTURA — pantalla: Profesor → Datos personales → Billetera → Modificar; mostrar: el panel completo con las pestañas Detalles/Modificar, los campos del tarjetahabiente y la sección Asociaciones; archivo sugerido: :t:personal_data:billetera_modificar.png</notes>

  - Se muestran los campos **Alias**, **Nombre del tarjetahabiente** y **Correo electrónico del tarjetahabiente**; el campo **Apellido(s) del tarjetahabiente** solo aparece si tu tarjeta ya tenía un apellido registrado.
  - Si la tarjeta ya tiene un contrato de pagos recurrentes firmado, los campos **Nombre del tarjetahabiente** y **Apellido(s) del tarjetahabiente** aparecen bloqueados y no se pueden modificar; solo puedes cambiar el **Alias** y el **Correo electrónico del tarjetahabiente**.
  - Si la tarjeta tiene pagos en línea activos, verás la opción **Preferida**; márcala para convertirla en tu tarjeta preferida para pagos en línea.
  - Si la tarjeta tiene pagos recurrentes activos, verás la sección **Asociaciones** con los servicios y, para cada uno, los estudiantes ya vinculados; puedes activar o desactivar servicios y cambiar los estudiantes asociados, salvo que la tarjeta ya tenga un contrato de pagos recurrentes firmado, en cuyo caso esta sección se muestra solo para consulta.
  - Da clic en **Aceptar** para guardar los cambios.
  - Se aplican las mismas validaciones que al registrar una tarjeta nueva cuando modificas sus servicios asociados (ver "Agregar tarjeta").

===== Agregar tarjeta =====
  - En el menú de la izquierda, selecciona **Datos personales**.
  - Selecciona la pestaña **Billetera**.
  - Da clic en el botón con el ícono {{icon>fas fa-plus}} para **Agregar tarjeta**.
  - Verás el aviso "Importante" con las condiciones del registro: "Validaremos su tarjeta con un cargo de $5.00 MXN." y, si tu colegio tiene pagos recurrentes habilitados, también "Para pagos recurrentes, firme el contrato tras el registro."
  - Selecciona el o los servicios para los que quieres registrar la tarjeta:
    * Bajo **Servicios de pagos por internet**, marca el servicio de pago en línea que quieras usar.
    * Bajo **Servicios de pagos recurrentes**, marca el servicio y a continuación selecciona a qué estudiante(s) asociados a ti se vinculará la tarjeta.
  - **IMPORTANTE:** todos los servicios que marques deben ser del mismo proveedor de pago; al marcar el primero, la plataforma deshabilita los servicios de los demás proveedores. Si no marcas ningún servicio, o si a un servicio de pagos recurrentes no le asocias al menos un estudiante, la plataforma te avisa "Es necesario seleccionar al menos un servicio" o "Es necesario seleccionar al menos un servicio y un estudiante" y no continúa. Tampoco puedes asociar al mismo estudiante a más de un servicio de pagos recurrentes a la vez: si lo intentas, el aviso es "Un estudiante no puede estar asociado a múltiples servicios".
  - Completa los datos que te pida el formulario (**Datos del tarjetahabiente**, **Número de tarjeta** y **Fecha de expiración**) y da clic en **Aceptar**.
  - Dependiendo del servicio que elegiste, la plataforma te pedirá los datos de la tarjeta de una de estas dos formas:
    * En la misma pantalla, en un formulario con los campos **Nombre del tarjetahabiente**, **Apellido(s) del tarjetahabiente**, **Correo electrónico del tarjetahabiente**, **Número de tarjeta**, **Fecha de expiración** (**Mes** y **Año**) y **CVV**.
    * En un formulario incrustado que abre la plataforma de pagos del servicio elegido, dentro de un panel titulado **Agregar tarjeta**. Complétalo con los datos que te pida (nombre, correo y datos de la tarjeta) y confirma ahí mismo.\\
<notes>FALTA_CAPTURA — pantalla: Profesor → Datos personales → Billetera → Agregar tarjeta (formulario incrustado del proveedor de pago); mostrar: el panel "Agregar tarjeta" con el formulario embebido dentro del recuadro; archivo sugerido: :t:personal_data:billetera_agregar_iframe.png</notes>
  - Si el servicio elegido solo acepta tarjetas American Express, el formulario muestra el aviso "Esta forma de pago acepta únicamente tarjetas American Express." antes de pedirte los datos.
  - Al terminar de capturar los datos en el formulario incrustado del proveedor de pago, dentro del mismo recuadro se muestra una pantalla de confirmación con un ícono y uno de estos mensajes, según el resultado:
    * Con una marca verde, "Tarjeta agregada correctamente" (o "Tarjeta habilitada correctamente" si estabas encendiendo un servicio para una tarjeta ya registrada, o "Tarjeta actualizada correctamente" si estabas actualizando los datos de una tarjeta).
    * Con un reloj, "El registro de la tarjeta puede tardar hasta que el banco confirme la operación", si el banco todavía no confirma la operación.
    * Con una marca roja, "No se pudo registrar la tarjeta" (o "No se pudo encender la tarjeta" / "No se pudo actualizar la tarjeta", según el caso); el proveedor de pago puede mostrar ahí mismo un motivo más específico.
  - Da clic en **Finalizar** para cerrar esta pantalla y volver a tu **Billetera**.
  - Una vez completado el registro, la tarjeta aparecerá en tu **Billetera**.

**Nota:** solo puedes tener hasta 3 tarjetas activas para pagos recurrentes; si intentas registrar una más, la plataforma te avisa "Solo se pueden agregar hasta 3 tarjetas para pagos recurrentes por usuario" y no completa el registro. Si un mismo estudiante y servicio ya tienen una tarjeta asociada por otro usuario, la plataforma te lo dice antes de continuar. Además, si se acumulan varios intentos fallidos al registrar una tarjeta, la plataforma bloquea temporalmente el registro con el aviso "Por el momento no es posible agregar tarjetas a la billetera. Consulte al administrador."; en ese caso contacta a la administración de tu colegio.

**IMPORTANTE:** cuando ya tienes una tarjeta registrada y activas para ella un servicio que antes no tenía (por ejemplo, agregar pagos recurrentes a una tarjeta que solo tenía pagos en línea), la plataforma te pide los datos de la tarjeta de la misma manera —en la pantalla o en el formulario incrustado del proveedor— y el panel se titula **Encender tarjeta** en vez de **Agregar tarjeta**. Lo mismo ocurre si modificas los datos de una tarjeta y el proceso requiere validarla de nuevo con el proveedor de pago: el panel se titula **Actualizar datos de tarjeta**.

===== Actualizar los datos de una tarjeta =====
Cuando la plataforma necesita revalidar una tarjeta que ya registraste, en tu **Billetera** esa tarjeta muestra la etiqueta "Actualización requerida".
  - En tu **Billetera**, ubica la tarjeta con la etiqueta "Actualización requerida" y da clic en **Actualizar datos**.
  - Se abre un panel con el alias de tu tarjeta y el texto **Actualizar datos de tarjeta**, junto con el aviso "Importante": "Validaremos su tarjeta con un cargo de $5.00 MXN."\\
<notes>FALTA_CAPTURA — pantalla: Profesor → Datos personales → Billetera → Actualizar datos de tarjeta; mostrar: el panel completo con el alias de la tarjeta, el aviso Importante y el formulario de datos del tarjetahabiente; archivo sugerido: :t:personal_data:billetera_actualizar_datos.png</notes>
  - Completa los campos **Nombre del tarjetahabiente** y **Correo electrónico del tarjetahabiente**; el campo **Apellido(s) del tarjetahabiente** solo aparece si tu tarjeta ya tenía un apellido registrado.
  - Si tu proveedor de pago lo requiere, también deberás capturar **Número de tarjeta** y **Fecha de expiración** (**Mes** y **Año**) y **CVV**; con otros proveedores no se te piden estos datos porque ya quedaron guardados con el proveedor.
  - Si la tarjeta tiene servicios de pagos recurrentes activos, verás la sección **Asociaciones** con los servicios y estudiantes ya vinculados a ella, solo para consulta.
  - Da clic en **Aceptar**. Se aplican las mismas validaciones y los mismos límites que al registrar una tarjeta nueva (ver "Agregar tarjeta").

<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="t:personal_data:wallet" make -C pipeline revisar</notes>