Purpose:

The purpose of this walkthrough is to help you set up the payment gateway of NMI so it can be used in our system.

Pre Requisites:

An Active NMI Gateway
API Keys
API Configuration

In the CRM go to "Settings" and click "Gateways"
Click on the blue plus sign or “add payment gateway”
Choose from the many options listed below and hit “configure”

A new screen will be shown were we will need to add a unique name for the new gateway and our credentials.

Fetching our credentials from NMI’s panel

Access to your NMI panel https://www.nmi.com/logins/
After log in we need to go options from the left menu and click on settings

From the settings screen we will click on the Security Keys option and two keys need to be generated, one is the Private Key and a Public Key, it is important that the Private Key has the API source checked and the Public Key the Tokenization source.

Now that we have our keys we can jump back to our Thiio instance and paste them in the corresponding input.

We can save this changes and the credentials will be saved.

API Response

This section is really important in order to process the transactions correctly.

Thiio uses API requests to communicate to NMI and process transactions it is really important that the API response from NMI includes the following two parameters:

Billing Address ID
Customer Vault ID

In order to make sure these values are included we should go back to the settings section on our NMI panel and click on the API Configuration option.

And from the API Configuration we will move the Billing Address ID and Customer Vault ID from the left column to the right column. After doing this it is important to save our changes.

How to verify if the gateway is working:

Perform a live transaction and a test transaction.
Follow this walkthrough to perform a test transaction: Creating a Test Order
After performing the transaction check your orders

To check a live order go to Orders and select the Order number as shown below

To check a Test order just go to Orders and click the Funnel icon on the top right corner

Once you have selected the Funnel icon the dropdown will appear, just select Test and Apply to view only the Test orders

Note:

For security reasons none of your card information reaches our server. Instead we use Collect.js which “tokenizes” the card and we send a token. This token is a representation of the credit card and that’s what it is used for charging the customer.

Due to the card information never reaching our server, we do not have the CVV and that is why the CVV validation for the first transaction must be disabled on NMI.

NMI customer support can help with this

Checklist:

An Active NMI Gateway
API Keys
API Configuration