Runbook
Runbook
Use this runbook when the app cannot connect, commands timeout, the terminal NAKs frames, or a transaction result is uncertain.
Connectivity
- Confirm the mobile device and terminal are on the same LAN.
- Confirm the terminal IP and ECR port.
- Run
status()before a financial command. - Check whether the terminal closes the socket between transactions.
- Reconnect before the next command if the connection state is stale.
Protocol failures
NAK
ACK timeout
Response timeout
Check lrcMode, fixed-width field lengths, terminal firmware expectations, and command availability.
Check LAN reachability, terminal busy state, and ECR port configuration.
Check host-side acquirer delay, cardholder action, and whether the configured responseTimeoutMs is too short.
Uncertain payment
Recovery path
Do not run the original payment again. Reconnect and call sendLastResult(). If the result remains unavailable, reconcile with terminal totals, acquirer portal, or operator procedure before charging again.
Last updated:
Edit this page
Recent commits
