> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilitación y soporte

> Información que el comercio, el integrador y Alignet deben intercambiar para pruebas y producción.

Completa esta información antes de ejecutar las pruebas conjuntas. Evita incluir credenciales o datos sensibles en documentos de coordinación sin protección.

## 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](/procesamiento-fisico/alignet-transit/parametros-de-envio), de 1–64 caracteres sin espacios;
* regla que garantiza unicidad por operación real;
* montos y referencias de prueba;
* datos estructurados del peaje en `tollData` y claves complementarias en `additionalFields`, si aplica;
* decisión de negocio según `result.state` en autorización, `transaction.state` en consulta a pasarela y `status` en 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 `additionalFields` definidas por el comercio y su finalidad;
* contactos, horarios y procedimiento de soporte.

El registro completo, incluida la semántica pendiente de extornos y referencias reutilizadas, está en [Datos por validar](/procesamiento-fisico/alignet-transit/datos-por-validar).

## Ficha por terminal

| Campo | Valor |
| - | - |
| Ambiente | Por completar |
| Punto de atención | Por completar |
| Identificador del Wiseasy P5L | Por completar |
| Versión de Pay-me PinPAD | Por completar |
| IP | Por completar |
| Puerto | `8080` por defecto; confirmar |
| Sistema central autorizado | Por completar |
| Fecha de `GET /health` exitoso | Por completar |
| Timeout del sistema central | Por completar |
| Política de consulta | Por completar |
| Contacto de soporte | Por completar |

## Evidencia mínima por caso

* identificador y descripción del caso;
* fecha, hora y ambiente;
* terminal y sistema central utilizados;
* `operationNumber` y 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-store` y `Retry-After: 2` en HTTP `202`;
* campos del contrato correspondiente a cada endpoint; en extorno `502 UNKNOWN`, solo `operationNumber`, `status` y `message`;
* tiempos de inicio, respuesta y consultas;
* resultado esperado, resultado observado y conformidad.

No incluyas PAN completo, CVV, PIN, PIN Block, pistas ni datos EMV sensibles.

## Entregables de habilitación

<CardGroup cols={2}>
  <Card title="Ficha de terminal" icon="sliders">
    Asociación entre sistema central, punto de atención y Wiseasy P5L, IP, puerto, versión y timeouts.
  </Card>

  <Card title="Matriz de decisiones" icon="table-list">
    Acción del sistema central para cada código HTTP y estado transaccional.
  </Card>

  <Card title="Evidencias de certificación" icon="flask-vial">
    Casos normales, errores, concurrencia, timeout y recuperación.
  </Card>

  <Card title="Procedimiento de soporte" icon="headset">
    Contactos, severidades, datos de diagnóstico y escalamiento.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.