====== 3. VISA ====== **Propuesta funcional inicial; pendiente de revisión del profesorado.** VISA es la pasarela de pago de prueba que construirá el profesorado. En el proyecto recibe solicitudes de la tienda, consulta al banco de pruebas y devuelve el resultado. Esta página propone actores, reglas y pantallas para entender su papel; no sustituye al contrato oficial ni presupone cómo se implementará. ===== Actores ===== ^ Actor ^ Qué necesita hacer ^ | Tienda online | Enviar una solicitud de pago asociada a un pedido y recibir el resultado de la operación. | | Banco de pruebas | Comprobar la operación con sus datos ficticios y comunicar si puede autorizarse. | | Responsable del entorno docente | Si se incluye una interfaz de supervisión, revisar las operaciones de prueba y su resultado. | El cliente interactúa con la tienda; no necesita acceder directamente a VISA para completar una compra. ===== Entidades iniciales ===== * **Solicitud de pago**: petición que recibe VISA desde la tienda, con una referencia e importe de prueba y los datos requeridos por el contrato docente. * **Operación de pago**: proceso de comprobación asociado a una solicitud y a su resultado. * **Resultado del banco**: respuesta funcional del banco de pruebas sobre la operación solicitada. * **Resultado para la tienda**: información que permite a la tienda mostrar si el pago se ha autorizado, denegado o no se ha podido completar. Los campos definitivos y el tratamiento de los datos se determinarán exclusivamente en el contrato publicado por el profesorado. No se guardarán datos reales de tarjetas ni el CVV. ===== Tienda: procesos y reglas ===== ==== Solicitar un pago ==== La tienda solicita el pago cuando el cliente confirma un pedido. VISA recibe la solicitud y la relaciona con la referencia de compra. * La solicitud debe corresponder a una operación del entorno educativo y usar datos ficticios. * La referencia permite relacionar el resultado con el pedido correcto. * Los datos obligatorios, su formato y su validación quedan pendientes del contrato docente. ==== Recibir el resultado ==== VISA comunica a la tienda el resultado obtenido tras consultar al banco. * La tienda solo debe considerar pagado el pedido cuando reciba una autorización válida según el contrato. * Una denegación no equivale a un pago realizado. * Si no se puede completar la comprobación, el resultado no debe presentarse como una autorización. ===== Banco: procesos y reglas ===== VISA remite la operación al banco de pruebas para comprobar si puede autorizarse con los datos ficticios disponibles. * El banco es responsable de comprobar la cuenta de prueba y reflejar un cargo únicamente cuando la operación quede autorizada. * VISA devuelve a la tienda el resultado recibido del banco, de acuerdo con el contrato que publique el profesorado. * Si el banco deniega la operación, VISA no debe comunicarla como autorizada. * Si el banco no está disponible o no se obtiene una respuesta concluyente, VISA informa de que no se ha podido completar la comprobación; no debe convertir esa situación en una autorización. ===== Reglas generales de la operación ===== * El flujo es exclusivamente educativo: no se realizan cargos reales ni se conectan tarjetas o cuentas reales. * Las operaciones deben poder relacionarse con su solicitud y pedido mediante las referencias que establezca el contrato. * Repetir una solicitud o notificación no debe generar cargos duplicados. El mecanismo concreto queda pendiente del contrato. * Solo se utilizarán los datos de prueba proporcionados o aprobados por el profesorado. * No se guardará el CVV. El almacenamiento y la transmisión de cualquier otro dato se ajustarán a las instrucciones del proyecto. * Los nombres de estados de este borrador son funcionales; no definen códigos, mensajes ni respuestas técnicas. ===== Ciclo de vida provisional de un pago ===== El diagrama resume el comportamiento esperado entre las aplicaciones. Las respuestas y los estados técnicos definitivos dependerán del contrato del profesorado. @startuml title Flujo funcional de un pago de prueba left to right direction skinparam backgroundColor #FFFFFF skinparam shadowing false skinparam defaultFontName Arial skinparam defaultFontSize 14 skinparam state { BackgroundColor #EAF2F8 BorderColor #49647B FontColor #25384B FontSize 14 } skinparam ArrowColor #49647B skinparam ArrowFontColor #526273 skinparam ArrowFontSize 12 state "Solicitud recibida" as Recibida state "Consultando al banco" as Consulta state "Pago autorizado" as Autorizado state "Pago denegado" as Denegado state "Comprobación no completada" as NoCompletada [*] --> Recibida : tienda solicita el pago Recibida --> Consulta : enviar operación al banco Consulta --> Autorizado : banco confirma la operación Consulta --> Denegado : banco deniega la operación Consulta --> NoCompletada : error o respuesta no concluyente Autorizado --> [*] : comunicar resultado a la tienda Denegado --> [*] : comunicar resultado a la tienda NoCompletada --> [*] : informar que no se autorizó scale max 850 width @enduml ===== Pantallas ===== Estas composiciones son **wireframes de baja fidelidad** de una posible interfaz de supervisión: muestran la estructura, el contenido, los controles y la navegación, no el diseño visual final, los colores, la tipografía ni la maquetación adaptable. La existencia y el alcance de esta interfaz quedan pendientes de decisión del profesorado. Los textos entre corchetes y los datos son ejemplos ficticios; las pantallas ilustran distintos resultados funcionales y no muestran datos personales ni de tarjeta reales. * **Panel y listado de operaciones** {{:clase:daw:proyecto-1daw:aplicaciones:visa-wf-operaciones.svg?800|Wireframe del panel y listado de operaciones de prueba}} * **Detalle y seguimiento de una operación** {{:clase:daw:proyecto-1daw:aplicaciones:visa-wf-detalle.svg?800|Wireframe de detalle y seguimiento de una operación de pago}} ===== Contrato técnico pendiente ===== El profesorado definirá el contrato necesario para implementar y probar la integración: campos, formatos, rutas, autenticación, resultados, errores y reglas de comunicación. Hasta que se publique, esta página no especifica API, códigos de estado, credenciales ni mecanismos de seguridad concretos. La implementación deberá ajustarse a ese contrato y al entorno de pruebas indicado.