/
Setting Up NMI Gateway

Setting Up NMI Gateway

Owned by Diana Castillo Arroyo (Unlicensed)
Last updated: Apr 12, 2024 by Fernando Ordóñez
5 min read

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”

Gateway_2_.png

  • 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 Login to NMI Payment Gateway Platform | NMI

  • 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 Webforce 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.

 

Webforce 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

mceclip1.png

 

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

mceclip2.png

 

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

mceclip3.png

 

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

Multi Processor ID (Merchant ID)

If you need more help with this set up, please don’t reach out to customer service, we’ll be happy to help you.

In our CRM system, we've implemented a seamless integration with the NMI gateway processor, allowing users to process deals using multiple processor IDs. When dealing with transactions involving various processor IDs, it is imperative to accurately input the desired processor ID into the corresponding form. Once the processor ID is correctly added, NMI will initiate the transaction, directing funds to the specified processor. It is crucial for users to exercise precision in this operation, as an incorrectly provided processor ID may lead to rejected transactions by the payment processor. To obtain the necessary processor ID, users are encouraged to reach out to our dedicated customer support team, ensuring a smooth and error-free transaction experience.

Once we have the processor id, we need to add it in the correspondin text field and save the changes. After doing this, every transaction processed using the gateway will be executed by the processor provided.

 

Introducing Dynamic Billing Descriptors with NMI Gateways

 

We're thrilled to announce the rollout of Dynamic Billing Descriptors for NMI gateways! This exciting feature empowers merchants with the flexibility to tailor billing descriptors dynamically, enhancing clarity for their customers. However, before diving in, it's crucial to ensure compatibility with your processor.

  1. Verifying Processor Compatibility:

The first step is to confirm whether your assigned processor supports Dynamic Billing Descriptors for your merchant ID. This ensures seamless integration and optimal functionality. Don't worry, our Customer Support team is here to assist you in this process.

 

  1. Enabling Dynamic Billing Descriptors:

Once compatibility is confirmed, reaching out to our dedicated Customer Support team is the next step. They'll swiftly assist you in enabling Dynamic Billing Descriptors for your account.

  1. Activating Dynamic Billing Descriptors:

With the green light from our support team, it's time to take action! Navigate to the "Descriptor" tab within your setup gateway form. Here, you'll find the option to toggle on Dynamic Billing Descriptors. Once activated, you're all set to enjoy the benefits of this feature.

 

 

Related content