Set up and configure an NMI gateway instance
Learn how to set up and configure an NMI gateway instance, including prerequisites, configuration procedures, and field descriptions.
Set up and configure an NMI gateway instance by using the information in this article, including prerequisites, configuration procedure, and descriptions of the configuration fields.
Prerequisites
Before setting up and configuring an NMI gateway instance, ensure that you have met the following requirements:
-
Receive an account gateway account from your merchant services provider.
-
Configure the payment gateway settings using the merchant account credentials. These credentials are used for the API calls in each payment operation.
-
Enable the NMI payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.
Configuration fields
Common configuration fields
There are some common fields you must complete for every gateway configuration. We recommend reviewing Setting Up Payment Gateways for information on these fields:
-
Name
-
Use Gateway Test Environment
For the NMI Gateway the Use Gateway Test Environment is unique in that it does not actually enable the testing environment for the gateway. In order to monitor their test transactions the customer will have to enter the merchant portal and enable Test Mode for their transactions (Settings > Test Mode > ‘Enable Test Mode’). It is best practice to check this setting if the test mode is enabled in the merchant portal.
-
Cards Accepted
-
Default Authorization Amount
The value for this field must be greater than or equal to 1.00 if the customer intends to on performing an authorization void. Otherwise, if the customer wants to do a validation without an authorization amount, then they would set this value to 0.
-
Verify new payment method (required)
-
Verify updated payment method (optional)
In addition to the common fields, you must provide the following field values that are specific to the NMI gateway. The following fields are required.
Username : The username for the customer’s merchant portal. The username is required for all API calls.
Password : The password associated the username for the merchant account. This is required to authenticate all API calls.
Related information
Overview of NMI gateway integration