Skip to main content

Setting Up NMI Payment Terminals

Setting Up NMI Payment Terminals

This guide walks you through connecting a physical card reader (payment terminal) to your CloudFFL POS system through NMI. Once set up, customers can tap, swipe, or insert their card at the terminal during checkout and the payment flows directly through your NMI account.

No pre-registration or separate terminal software is needed — CloudFFL connects directly to NMI, which communicates with your terminal.

What You Need

  • A physical card reader (terminal) that is compatible with NMI
  • Your Security Key (API Key) from NMI — the same key you used when connecting your NMI account
  • Your Device ID — a unique identifier for your specific terminal hardware
  • The terminal must be powered on and connected to your network (Wi-Fi or Ethernet)

Finding your Device ID. Your Device ID is a unique identifier for your physical card reader. To find it, log in to your NMI dashboard at 

secure.nmi.com
, then go to Terminals → Device List. Your terminal and its Device ID will be listed there. If you do not see your terminal, contact your NMI representative to have it added.

Step-by-Step Setup

  1. In CloudFFL, go to POS → Configuration → Settings
  2. Scroll to the Payment Terminals section and make sure NMI is enabled
  3. Go to POS → Configuration → Payment Methods
  4. Click New to create a new payment method
  5. Enter a name, such as Credit Card (Terminal)
  6. Under Journal, select a Bank journal (not Cash — credit card deposits go to your bank account)
  7. Under Use a Payment Terminal, select NMI Reader
  8. In the API Key field, enter your Security Key from your NMI account
  9. In the Device ID field, enter the Device ID for your terminal (found in the NMI dashboard under Terminals → Device List)
  10. Click Save

After saving, add this payment method to your POS by going to POS → Configuration → Point of Sale, selecting your POS, and adding the new payment method under Payment Methods.

Troubleshooting

Terminal Not Connecting

  • Double-check that the API Key (Security Key) you entered in CloudFFL matches the one in your NMI dashboard under Settings → Security Keys
  • Make sure the terminal is powered on and connected to your network. If it is a Wi-Fi terminal, verify it is on the same network as your computer.
  • Try unplugging the terminal, waiting 10 seconds, and plugging it back in

Transaction Fails

  • Check whether CloudFFL and NMI are both in the same mode. If CloudFFL is set to Test Mode, your NMI account must also be in test mode, and vice versa. Mismatched modes will cause transactions to fail.
  • To check your mode in CloudFFL, go to Accounting → Configuration → Payment Providers → NMI and look at the State field

"Device Not Found" Error

  • Verify the Device ID you entered matches exactly what is shown in the NMI dashboard under Terminals → Device List (no extra spaces or missing characters)
  • Make sure the terminal has been registered in your NMI account. If it is a new terminal, your NMI representative may need to add it to your account first.

Terminal Prompts but No Response in Odoo

  • If the terminal shows a prompt (such as "Insert Card") but CloudFFL does not update, the POS session may have gone stale
  • Fix: Close your current POS session completely and reopen it, then try the transaction again
  • If the problem continues, open your browser's developer console (press F12) and check for error messages — this information can help support diagnose the issue

Test before going live. Always run a few test transactions with Test Mode enabled before switching to live payments. This confirms that your terminal, Device ID, and API Key are all configured correctly without risking real charges.

No comments to display

Back to top