Network Merchants Inc Payment Gateway Setup and Credential Guide

Quick summary. This runbook shows where to create Network Merchants Inc (NMI) Security Key, Tokenization / Checkout public keys, and a webhook signing key. It is for merchants already boarded on NMI—not Intuit / QuickBooks Payments.

Requirements

An active Network Merchants Inc merchant account (not a QuickBooks Payments / Intuit merchant account).
Admin access to the NMI virtual terminal to create API and public keys.
The matching PatSaTECH plugin for your cart. WooCommerce webhook example below is /wc-api/woocommerce_nmipay. Other carts use the callback URL from that package.

A.) Network Merchants Inc Credentials

In order to accept payments through Network Merchants Inc. on your website, you must first register for a Network Merchants Inc. account here and get your account activated.

To process payment with your Network Merchants Inc (NMI) merchant account, you need the following things.

Security Key
Tokenization Public key
Checkout Public key
Webhooks Sign key

B.) Getting Credentials from an NMI Account

You need to log into your NMI account. Follow the steps below.

To get a Security Key, you need to navigate to “Options” => “Settings.”
On this page, click on “Security Keys.”
On the security keys page, you can see the button named “Add a New Private Key.” Clicking this will show a dialog box.
In this dialog box, name the key as you wish. Select the username you want to associate it with. Then, under key permission, select “API” and click create.
This will create a key under “Private Security Keys.”

Next, on the same page, you can generate the Tokenization Public key and Checkout Public key.
For these, you need to click the Add a New Public Key button under the Public Security Keys.
Once you click, you will see a dialog box again. Similar to above, you can use the keys for anything, but to generate a Tokenization Public key, you need to select key permission as Tokenization, whereas to generate Checkout Public Key, you need to select key permission as Checkout.

Checkout-and-Tokenization-Key — Get Checkout and Tokenization Key

Next you would need to setup WebHook Url to generate Webhooks Sign key
For need to go back to Settings Page here under Transaction Options you should see Webhooks click on it.
On webhooks page under Endpoints you need to create a new endpoints by clicking Create.
Once you click Create it will show you the available events you need subscribe to all events.
And in URL section you need to enter the url as https://www.yoursite.com/wc-api/woocommerce_nmipay and save the changes.
Once you have saved the changes you should see the Signing Key

Install

Install the matching plugin on staging first. For WooCommerce that is Network Merchants Inc (Collect.js) for WooCommerce. Do not paste live keys on production until sandbox charges succeed.

Config

In WooCommerce → Settings → Payments, open the NMI / Collect.js gateway. Paste the Security Key and the public keys that match Tokenization and Checkout. Save. Leave the gateway in test/sandbox mode until the section below passes.

Sandbox

Place a test order with NMI test cards from your NMI account docs.
Confirm the order note shows an NMI transaction ID and that a webhook arrived (Signing Key must match).
Refund or void the test from the WooCommerce order screen if your NMI package allows it.

Going live

Switch the plugin from sandbox to live keys from the same NMI account. Repeat one low-value live charge, then refund it. Confirm the live webhook URL still points at this site (including https) and is not blocked by a WAF.

Common problems

Checkout shows no NMI method — currency, country, or Blocks availability; see no payment methods available.
Order stuck Pending — webhook URL or Signing Key wrong, or the host blocked /wc-api/woocommerce_nmipay. See payment timeout.
Keys from QuickBooks Payments / Intuit will not work here. Use the QuickBooks (Intuit) guide for that processor.

Product

WooCommerce: Network Merchants Inc (Collect.js) for WooCommerce. Other carts: Gravity Forms, Magento, PrestaShop, and AbanteCart NMI SKUs in the shop. Headless or fields this plugin does not document: custom integration.