Moneris API Webhook SMS Failure Diagnostic Report -... | terminalfaults.org

Technical Background:

The API Webhook relies on network connectivity (TCP/IP) to transmit SMS requests to the Moneris gateway. SMS delivery is contingent on proper DNS resolution, HTTP/HTTPS connectivity, and the operational status of the SMS gateway. Signal attenuation due to physical obstructions or electromagnetic interference (EMI) could impact network connectivity. Voltage fluctuations or ESD events may also affect the embedded system's performance.

Symptoms:

Failure of the Moneris API Webhook to send purchase confirmation SMS messages following successful transactions.

Possible Causes:

Network Connectivity Issues: Loss of internet connection or intermittent connectivity affecting webhook transmission.
API Gateway Failure: The Moneris SMS API gateway might be experiencing downtime or reduced capacity.
DNS Resolution Failure: The device may be unable to resolve the SMS gateway's domain name.
Incorrect API Configuration: Incorrectly configured API keys or webhook settings within the Moneris system.
Firewall Restrictions: Firewall rules blocking outbound SMS traffic on the network.
Cable Strain or Damage: Physical damage to the Ethernet cable or power cable, causing intermittent connectivity or power loss.

Solution:

1

Verify Network Connectivity: Use a separate device to confirm internet access and network speed at the terminal location.
2

Check Moneris System Status: Consult the Moneris website or support channels for any reported API outages or maintenance.
3

Review API Configuration: Log into the Moneris merchant portal and verify the API key, webhook URL, and SMS settings.
4

Inspect Cables and Connections: Ensure all cables are securely connected and free from damage or excessive strain. Replace damaged cables.
5

Restart the Device: Perform a controlled power cycle of the Moneris API Webhook device. Unplug the device, wait 30 seconds, and plug it back in.
6

Test SMS Functionality: Initiate a small test transaction to trigger an SMS message and confirm delivery.
7

Contact Moneris Support: If the issue persists, contact Moneris technical support for further assistance and troubleshooting.

Safety Warning:

Safe Handling: Disconnect the device from the power source before inspecting cables or performing any maintenance. Ensure the device is placed on a dry, stable surface to prevent electrical hazards. Avoid operating the device in wet or humid environments. Do NOT attempt to open the device's casing or tamper with internal components, as this will void the warranty and potentially damage the device's anti-tamper mechanisms.

Prevention:

Implement regular maintenance checks, including cable inspection, cleaning, and network performance monitoring. Ensure the device is placed in a well-ventilated area, away from potential sources of EMI or physical damage. Employ cable management techniques to prevent strain on connections.

Expert Tip:

Check the device's internal logs (if accessible via the Moneris portal) for any error messages related to SMS delivery failures. A detailed examination of the logs may provide clues to the underlying cause of the problem. Examine Ethernet cable pins for corrosion. Consider using a network packet sniffer on a connected computer to monitor outbound SMS traffic, if permitted by the client network and privacy policy.

Frequently Asked Questions

•Have you checked the Moneris merchant portal for any reported SMS API outages?

This should be the first step in diagnosing the problem. Known outages will save considerable troubleshooting time.

•Is the device's network IP address static or dynamically assigned (DHCP)?

A static IP address can help ensure consistent network connectivity. Verify that the device's static IP is not conflicting with another device on the network.

•Are there any other devices experiencing network connectivity issues on the same network?

If so, the issue may be related to the local network infrastructure and not solely the Moneris device.

Technical Background:

Symptoms:

Possible Causes:

Solution:

Safety Warning:

Prevention:

Expert Tip:

Frequently Asked Questions

•Have you checked the Moneris merchant portal for any reported SMS API outages?

•Is the device's network IP address static or dynamically assigned (DHCP)?

•Are there any other devices experiencing network connectivity issues on the same network?

Related questions

Technical Background:

Symptoms:

Possible Causes:

Solution:

Safety Warning:

Prevention:

Expert Tip: