Información del comercio o integrador
Sistema central y despliegue
- nombre y versión del componente que realizará las llamadas HTTP;
- sistema operativo, runtime y biblioteca HTTP;
- relación entre instancias del sistema central, puntos de atención y terminales;
- estrategia de persistencia de operaciones abiertas;
- mecanismo de serialización de cobros por terminal;
- procedimiento de recuperación después de un reinicio.
Red
- subred y dirección IP del sistema central;
- reglas de firewall aplicables;
- confirmación de que AP/Client Isolation está desactivado;
- reserva DHCP o mecanismo de IP estática del Wiseasy P5L;
- contacto responsable de red durante las pruebas.
Operación
- formato utilizado para
operationNumber, según Parámetros, de 1–64 caracteres sin espacios; - regla que garantiza unicidad por operación real;
- montos y referencias de prueba;
- datos estructurados del peaje en
tollDatay claves complementarias enadditionalFields, si aplica; - decisión de negocio según
result.stateen autorización,transaction.stateen consulta a pasarela ystatusen cancelación/extorno; - formato de comprobante y datos de conciliación.
Observabilidad y soporte
- evidencia técnica disponible en el sistema central;
- retención y protección de logs;
- responsables de desarrollo, QA, redes y operación;
- procedimiento para inmovilizar una operación incierta y escalarla.
Información de Alignet
Alignet debe confirmar antes de la salida a producción:- Wiseasy P5L y versión de Pay-me PinPAD asignados;
- IP y puerto configurados para cada terminal;
- espera interna definitiva de Pay-me PinPAD;
- recomendación definitiva de timeout del sistema central;
- intervalo, backoff y límite de consulta;
- catálogo aplicable de códigos por método y operación;
- versión instalada conforme al mapeo de códigos de cobro, cancelación y extorno;
- HTTP, código y cuerpo del error cuando la cancelación no se ejecutó o corresponde a otra operación;
- evidencia y revisión de discrepancias cuando QR sigue aprobado tras solicitar cancelación, sin refund ni reversa;
- presentación de tarjeta en el extorno explícito CARD;
- monedas y medios de pago habilitados;
- claves de
additionalFieldsdefinidas por el comercio y su finalidad; - contactos, horarios y procedimiento de soporte.
Ficha por terminal
Evidencia mínima por caso
- identificador y descripción del caso;
- fecha, hora y ambiente;
- terminal y sistema central utilizados;
operationNumbery método CARD o QR;- evidencia de recepción de
/cancel, fallo de conexión o fallo interno, y cierre visual observado; - resultado de
/cancel, consultas del cobro ante fallo o incertidumbre y resultado del extorno CARD independiente, si se solicitó; - mensaje Cancelación no confirmada ante timeout, desconexión o fallo del backend;
- solicitud y respuesta sanitizadas;
- código HTTP,
Connection: close,Cache-Control: no-storeyRetry-After: 2en HTTP202; - campos del contrato correspondiente a cada endpoint; en extorno
502 UNKNOWN, solooperationNumber,statusymessage; - tiempos de inicio, respuesta y consultas;
- resultado esperado, resultado observado y conformidad.
Entregables de habilitación
Ficha de terminal
Asociación entre sistema central, punto de atención y Wiseasy P5L, IP, puerto, versión y timeouts.
Matriz de decisiones
Acción del sistema central para cada código HTTP y estado transaccional.
Evidencias de certificación
Casos normales, errores, concurrencia, timeout y recuperación.
Procedimiento de soporte
Contactos, severidades, datos de diagnóstico y escalamiento.

