Requisitos y responsabilidades

​

Matriz de responsabilidades

​

Requisitos del sistema central

​

Cliente HTTP

• Implementa GET /health, POST /authorize, GET /payments/{operationNumber}, POST /reversals y GET /reversals/{operationNumber}.
• Envía Content-Type: application/json en la autorización y en la cancelación o extorno.
• Configura al menos 100 a 110 segundos de timeout para POST /authorize y POST /reversals con la espera de desarrollo actual.
• Lee el código HTTP, el cuerpo JSON y Retry-After cuando esté disponible.
• Maneja 200, 202, 400, 404, 409, 502 y 503 según la operación.
• Mantén una cola o bloqueo por terminal para no enviar cobros concurrentes.

​

Estado transaccional

• Persiste la referencia y los datos del cobro antes del envío.
• Confirma solo status: "APPROVED" junto con resultCode: "00".
• Conserva como abiertas las operaciones PENDING, PROCESSING o UNKNOWN.
• Recupera las operaciones abiertas después de un reinicio del sistema central.
• No conviertas un timeout o 404 de consulta en rechazo financiero.

​

Decisión de negocio

• Define la acción que ejecutará el comercio después de una aprobación —por ejemplo, confirmar una venta o abrir una barrera— y cómo informará un rechazo o una cancelación.
• Define el límite de espera y el escalamiento de una operación no resuelta.
• Crea un nuevo operationNumber para un nuevo intento después de un resultado final DENIED o CANCELLED.
• Conserva authorizationCode y operationNumber para el comprobante y la conciliación.

​

Preparación del Wiseasy P5L

Alignet y el operador deben:

• instalar la versión de Pay-me PinPAD correspondiente al package com.alignet.pinpad.ecr;
• conectar el terminal a la red local y asignarle una IP estable;
• configurar la IP y el puerto de escucha, cuyo valor predeterminado es 8080;
• confirmar la llamada real de GET /health desde el sistema central;
• completar la verificación de inyección de llaves;
• dejar la aplicación en Listo para el siguiente vehículo;
• confirmar que el terminal dispone de la conectividad necesaria para procesar el pago.

​

Lista de verificación inicial