Troubleshoot Moneris 'Referral Required' error on Checkout API. Verify network, EMV chip reader, and cabling. Follow expert steps for resolution and prevention.
Document the IP scheme, Gateway, Subnet, DNS.
Locate and document the full numerical error code from the API.
Document frequency and any patterns of error occurrence.
The 'Referral Required' error indicates that the Moneris system requires manual authorization for the transaction. This can be triggered by various factors including transaction amount limits, suspected fraudulent activity, or communication errors between the terminal, the Moneris network, and the card issuer. The terminal's communication module (Ethernet or wireless) and EMV chip reader's integrity are critical for correct operation. Signal attenuation on network lines, or intermittent power fluctuations can cause data corruption.
The Moneris Checkout API displays a 'Referral Required' error during transaction processing. The transaction is flagged for manual review by the payment processor.
Regularly clean the EMV chip reader with a dry, lint-free cloth to prevent debris buildup.,Ensure stable network connectivity for the terminal.,Implement cable strain relief measures to prevent damage to power and data cables.,Periodically review and update terminal configuration settings.,Monitor transaction logs for any recurring errors or anomalies.
If the terminal uses a wired Ethernet connection, try swapping the Ethernet cable with a known good cable. Also, inspect the RJ45 port on both the terminal and the network switch/router for bent or damaged pins. A faulty Ethernet cable or port can cause intermittent connectivity issues leading to 'Referral Required' errors.