Falta de papel y alertas de hardware

Esta página ofrece soluciones para problemas físicos del terminal, como errores de impresora y fallas de conectividad. El estado físico del terminal puede afectar el resultado de una transacción.

Error de impresora / falta de papel

Este error ocurre cuando la respuesta devuelve result="3" con resultDetails="PRINTER ERROR" o "PAPER OUT". Sucede cuando el terminal se queda sin papel térmico o cuando la tapa de la impresora está abierta.

Solución

1. Cambia el rollo de papel y verifica que la bandeja quede cerrada con un clic
2. Una vez resuelto, usa el deeplink getnet://payment/v1/last-transaction para entregar al cliente su comprobante
3. Ten en cuenta que la transacción suele quedar aprobada aunque falle la impresora. No vuelvas a ejecutar el pago hasta confirmar el estado de la transacción en los reportes

Error de comunicación

Este error ocurre cuando la respuesta devuelve result="3". Sucede cuando el terminal pierde la conexión de red durante el proceso de autorización.

Solución

1. Revisa la barra de estado del terminal Android para ver la intensidad de la señal
2. Confirma que la conexión de red se haya restablecido
3. Si la conexión es estable y los errores continúan, revisa la configuración del APN (para 4G) o del proxy (para Wi-Fi)

Fallo de lectura de la tarjeta (NFC/chip)

Este error ocurre cuando el terminal solicita “Use Magnetic Stripe” o devuelve un error de lectura. Suele deberse a un chip dañado o a un sensor NFC sucio.

Solución

1. Limpia el lector de chip con una tarjeta de limpieza seca
2. Si falla el NFC, verifica que el cliente acerque la tarjeta o el teléfono a la parte superior de la pantalla (en los modelos N910 Pro/A920)
3. Si fallan varias tarjetas, el hardware del terminal puede necesitar servicio técnico

Siguientes pasos

• Responsabilidad de impresión - delega la impresión de recibos en tu propia aplicación.
• Códigos de resultado y estructuras de datos - interpreta el código que se devuelve con una falla de hardware.