Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Network Merchants Incorporated (NMI)

This feature is a Private Beta Release. Contact Chargebee support to enable NMI for your Test and Live site.

NMI (Network Merchants, Inc.) is a versatile payment gateway that enables businesses to accept payments securely. It supports omnichannel commerce by integrating in-store, online, and mobile payment solutions. With customizable APIs and strong security features, NMI powers scalable and seamless payment experiences. NMI is most popular in North America, particularly in the United States and Canada. It partners with many Independent Sales Organisations (ISOs) and payment processors in the region, serving a wide range of merchants through white-labeled and integrated payment solutions.customized payment experiences.

Note

3D Secure is not supported for this integration.

Integration Options

You can integrate NMI using the following:

Integration MethodDescriptionPCI Requirements
Chargebee Hosted PagesIn this method, customers' card information is collected by Chargebee's checkout and directly passed on to NMI.Low
(Your PCI compliance is significantly reduced by using Chargebee’s Checkout)
Chargebee JSIn this method, you can use Chargebee Components and Hosted Fields to collect the customer's card details.Low
Chargebee JSVia Raw Card details
You will collect raw card details via your custom checkout and pass them to Chargebee.js.
High
Chargebee APIIn this method, you collect card information and pass it on to Chargebee, which routes it to NMI. Since you will be collecting card information directly, you will have to take care of PCI Compliance requirements.High
Chargebee API using TokensUsing Permanent Token – a token that represents a customer's card details stored in the NMI vault to process payments.

Format:
payment_method_token
When using a direct gateway token, PCI requirements are minimal to None.

Choosing NMI

Consider the following factors before choosing NMI as a payment solution:

  • Countries Supported: NMI partners with acquiring banks across six continents, enabling merchants to operate in numerous countries, including but not limited to:
    • Asia: India, Japan, Singapore, UAE, Thailand, Malaysia, South Korea, Israel, Saudi Arabia, etc.
    • Europe: UK, Germany, France, Italy, Spain, Netherlands, Belgium, Sweden, Switzerland, and many more.
    • North America: United States, Canada, Mexico, Central American and Caribbean nations.
    • South America: Brazil, Argentina, Chile, Colombia, Peru, Uruguay, Venezuela, etc.
    • Oceania: Australia, New Zealand.
    • Africa: South Africa, Egypt.
  • Currencies Supported: NMI supports over 100 currencies. This includes major globally traded currencies like:
    • USD, CAD, EUR, GBP, AUD, JPY, INR
    • Regional currencies like SGD, HKD, KRW
    • Other worldwide currencies that cover virtually every national currency.

Supported Payment Methods

Note

Chargebee currently supports only Card payments made via NMI Direct Integration, and only non-3DS workflows are supported.

NMI supports a comprehensive array of major card brands, which makes NMI well-equipped to handle payments from virtually all widely used global card networks.

  • Visa and MasterCard
  • American Express and Discover

Limitations

The following limitations apply to the NMI gateway integration with Chargebee:

  • NMI does not directly manage disputes/chargebacks; they are handled by the acquirer, which could limit visibility or control.

Retrieve keys from your NMI account

Chargebee requires your NMI Security Key for connecting with the gateway and for subsequent API interaction with NMI. Follow the steps below to fetch the information that you will be required to enter in your Chargebee site:

  1. Log in to your NMI Gateway Portal.
  2. In your NMI account, go to Settings from the left navigation pane.
  3. Go to Security Keys under the Security Options section.
  4. Create a new security key by following these steps (move directly to the next step if you have a key already):
  • Click Add a New Security Key.
  • Enter a name (e.g., Chargebee API Access).
  • Set IP restrictions or permissions if needed.
  • Click Create Key.
  1. Copy the newly generated Security Key and keep it safe for use in the Chargebee app in the next section.

Configuring NMI Direct in your Chargebee site

Follow the steps below to configure Nuvei in your Chargebee site:

  1. Login to your Chargebee site.
  2. Go to Settings > Configure Chargebee > Payment Gateways.
  3. Click +Add Gateway and select NMI.
  4. Enter the API Security Key from your NMI account.
  5. Click Connect.

Configuring Card settings

Follow the steps below to configure Card settings for your NMI account in Chargebee:

  1. On the Configure NMI page, click Settings > Configure Chargebee > Payment Gateways > NMI. Cards are enabled by default.
  2. Click Manage in the Cards section.
  3. Configure the following settings based on your business requirements:
    • Card Verification: Chargebee verifies the customer's card before adding them. In this process, a small amount will be debited from the customer's card and will be refunded instantly. In case this authorization fails, the customer cannot add their card.
    • Always retain card information in NMI when the customer updates it: If you have configured multiple payment gateways in Chargebee, enabling this option stores the updated card information in NMI rather than the default gateway.
  4. Click Save > Apply.

Additional Configuration (Required)

Follow these additional steps to complete the configuration of the NMI gateway in Chargebee:

  • Go to Settings > Configure Chargebee > Currencies. Review your Currency settings and add the required currency.
  • Review your Smart Routing settings to update gateway preferences to payment methods.

Was this article helpful?