...

width	50%

Table of Contents

Warning

Firefox user notice:

Please use another web browser to view this document.

Sorry for the inconvenience.

...

Image Modified

Magento 2 NMI implements the Network Merchants, Inc. (NMI) eCommerce payment method within a Magento 2 store. The extension allows processing payments securely and fast as a result of the PCI compliance and the SOAP API connection. All the credit card data, inserted in the fields at checkout, are kept solely on the NMI servers and are available for re-use only upon customer permission via the Magento 2 Vault functionality.

Compatibility: Magento Open Source 2.3.X - 2.4.X, Magento Commerce 2.3.X - 2.4.X

Warning
For more information follow the product user manual on our website

Product Page

Thank you for choosing Aheadworks!

Installing Magento 2 NMI

...

Panel

borderWidth	2px
borderStyle	solid

1. Backup your web directory and store database

Panel

borderWidth	2px
borderStyle	solid

2. Download the NMI installation package

Panel

borderWidth	2px
borderStyle	solid

3. Upload contents of the NMI installation package to your store root directory

...

borderWidth	2px
borderStyle	solid

4. In SSH console of your server navigate to your store root folder:

No Format
cd path_to_the_store_root_folder

run:

No Format
php -f bin/magento module:enable Aheadworks_Nmi

then:

No Format
php -f bin/magento setup:upgrade

after:

No Format
php -f bin/magento setup:static-content:deploy

Panel

borderWidth	2px
borderStyle	solid

5. Flush store cache; log out from the backend and log in again

Note
Make sure the installation is done from the FTP administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed.

...

width	50%

...

borderWidth	2px
borderStyle	solid

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

Panel

borderWidth	2px
borderStyle	solid

1. Login to your ssh console and navigate to your store folder:

Panel

borderWidth	2px
borderStyle	solid

cd path_to_the_store_root_folder

Run the following command:

Panel

borderWidth	2px
borderStyle	solid

composer config repositories.aheadworks composer https://dist.aheadworks.com/

On successful execution of the command you will be able to use the composer to install the extensions.

...

borderWidth	2px
borderStyle	solid

To install the extension:

2. Login to your ssh console and navigate to your store folder:

Panel

borderWidth	2px
borderStyle	solid

cd path_to_the_store_root_folder

...

borderWidth	2px
borderStyle	solid

3. Run the following command to install the latest version of the extension:

Panel

borderWidth	2px
borderStyle	solid

composer require aheadworks/module-nmi

if you need to install a specific version, run this command:

Panel

borderWidth	2px
borderStyle	solid

composer require aheadworks/module-nmi:<version>

Tip
Specify the version of the extension in <version>

Panel

borderWidth	2px
borderStyle	solid

When prompted, enter Public Key (Username) and Private Key (Password):
Image Removed

Note

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

Image Removed

Panel

borderWidth	2px
borderStyle	solid

4. Enable the extension:

Panel

borderWidth	2px
borderStyle	solid

php -f bin/magento module:enable Aheadworks_Nmi

Next, register the extension:

Panel

borderWidth	2px
borderStyle	solid

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

Panel

borderWidth	2px
borderStyle	solid

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

Panel

borderWidth	2px
borderStyle	solid

bin/magento module:status

Clean store cache, by running the following command:

Panel

borderWidth	2px
borderStyle	solid

bin/magento cache:clean

Log out and Log in the backend again.

...

borderWidth	2px
borderStyle	solid

To upgrade the extension:

5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Code Block

title	Update per module name:

composer update aheadworks/module-nmi

Code Block

title	Updater per version:

composer require aheadworks/module-nmi:<version>

Run the following commands to upgrade, deploy, and clean the cache.

Panel

borderWidth	2px
borderStyle	solid

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Introducing the Magento 2 NMI extension

Section

NMI for Magento 2 is a module to enhance the Magento 2 checkout with the NMI payment method, high-level security and increased user-friendliness of the interface provided.

Features and Highlights:

Full PCI Standard compliance;
SOAP API request processing via NMI WSDL;
Magento 2 Vault support;
Admin orders support;
Alternative NMI API endpoint URL support;
Multi-address shipment support.

Business value

NMI extension for Magento 2 allows arranging for secure and fast payments, multiple settings enabled, with the NMI payment gateway. Enabling various alternative payment methods helps reach broader customer audience, and employing the extension from Aheadworks - do that in a most customer-centered way. With multi-address shipping support, country specification and other settings the present extension saves a great amount of time both for admin and shoppers, and thereby ensures the very customer-focused eCommerce approach.

Configuring Magento 2 NMI

...

To configure the extension follow Stores > Configuration > Sales > Payment Methods > Aheadworks NMI.

Note

To make use of Aheadworks Magento 2 NMI, it is important you have an account with Network Merchants LLC and consequently access to the gateway.

If you do not have one, please contact NMI or your payment facilitator.

Access

When on the Aheadworks NMI section of the Payments page address yourself to the following fields:

Enabled - the Yes/No selector to en/disable the payment gateway;
API Endpoint URL - the text-field to contain API Endpoint URL, to switch from the default URL;
Title - the text-field to tell the name of the payment method name as it will be displayed on the checkout page (Credit Card (Aheadworks Nmi) by default);
Environment - the Sandbox/Production selector to define the environment for operation of the present module;
Tokenization Key - the text-field to contain the token that represents the payment account number (provided by NMI as part of the sign-up process);
Live API Username - the text-field to contain your API Username, the part of your access data to enable integration of the NMI service and third-party applications (Please contact NMI or your payment facilitator for this information);
Live API Password - the text-field to contain your API Password, the part of your access data to enable integration of the NMI service and third-party applications (Please contact NMI or your payment facilitator for this information);
Sandbox API Username - the text-field to contain a Sandbox API Username, to access integration of the NMI test mode and the present extension (Please contact NMI or your payment facilitator for this information);
Sandbox API Password - the text-field to contain a Sandbox API Password, to access integration of the NMI test mode and the present extension (Please contact NMI or your payment facilitator for this information).

Image Removed

Note

Use Sandbox API Username and Password for the Sandbox environment, use Live API Username and Password for the Production environment.

Authentication via security keys is available now.

Magento 2 Vault

Magento 2 Vault and Partial Invoices can be enabled on the same page, below the NMI account credentials. It enables saving customer credit card data on the NMI server, and retrieving it later at checkout, if need be.

There are two boxes to operate Vault:

Enable Customer Vault and Partial Invoices - select Yes or No;
Vault Title - enter the title for stored for NMI credit cards (as it will appear on the backend).

Image Removed

Note
Orders can be partially invoiced offline any time, and it doesn’t depend on the vault status. To make online partial invoices multiple times, the “Enable Customer Vault And Partial Invoices“ option should be enabled. Otherwise, the merchant can make only one partial invoice, as vault token existance is required.

Note
If vault is disabled, NMI payment isn’t shown on Multishipping Addresses Checkout.

Payments

The following options are available just below the Vault fields to further tweak NMI payments:

Debug - enable to include some transaction information into the logs files;
Payment Action - select action: authorize' or 'authorize and capture';
Payment from Applicable or Specific Countries - specify the geography of NMI users: only customers from chosen countries will see the NMI option at checkout;
Sort Order - position the method on the checkout page.

Image Removed

Using Magento 2 NMI

Section

Checkout View

NMI for Magento 2 is integrated into the native Magento 2 checkout functionality and represents a design that all the Magento 2 users are familiar with.

Regular Checkout

Save for later use - is a checkbox provided by the Magento 2 Vault. It allows using the same credit card data without re-entering it.

A 'VISA' credit card payment method (see the top of the image above) is an actual representation of Magento 2 Vault functionality.

Image Removed

Multi-address Checkout

Checkout with multiple addresses follows the native Magento 2 functionality as well. Go to cart and click the Check Out with Multiple Addresses active link.

Image Removed

The link will redirect you to the page where addresses are to be specified. You may also alter the quantity of the products in cart or remove the items from the list.

Clicking the Go to Shipping Information blue button on the left will take you further into the process.

Image Removed

You will soon see the Billing information page, where all available for multi-address payment methods will be shortlisted. Click the corresponding radio-button to select Aheadworks NMI, and proceed with the Go to Review Your Order button.

Image Removed

Admin Orders Support

The NMI for Magento 2 extension enhances the native Magento 2 functionality on the backend too. It allows selecting the NMI payment method for orders created by the admin on the backend. Follow the official Magento 2 guide to learn how to create orders from backend.

The Create New Order page will feature the NMI payment gateway in the list of payment methods in the appropriate block. You will be able to choose either a stored card (Stored Cards (Aheadworks NMI) or whatever name you gave to the bank of stored NMI cards) or enter a new one (Credit Card (Aheadworks NMI)).

Image Removed

Uninstalling NMI

...

width	50%

Manual Removal

...

1. Disable the module by executing the following commands:

No Format
php bin/magento module:disable Aheadworks_nmi php bin/magento setup:upgrade

...

2. Remove the extension files from the following folder:

No Format
app/code/Aheadworks/nmi

...

width	50%

Automatic Removal (via Composer)

...

1. Disable the module by executing the following commands:

No Format
php bin/magento module:uninstall Aheadworks_nmi

...

Need Customization?

You can always find the latest version of the software, full documentation, demos, screenshots, and reviews on http://aheadworks.com
License agreement: https://aheadworks.com/end-user-license-agreement
Contact Us: https://aheadworks.com/contact
Copyright © 2021 Aheadworks Co. http://www.aheadworks.com

Versions Compared

Old Version 21

New Version Current

Key

Installing Magento 2 NMI

Introducing the Magento 2 NMI extension

Features and Highlights:

Business value

Configuring Magento 2 NMI

Access

Magento 2 Vault

Payments

Using Magento 2 NMI

Checkout View

Regular Checkout

Multi-address Checkout

Admin Orders Support

Uninstalling NMI

Need Customization?

Page Comparison

Versions Compared

Old Version 21

New Version Current

Key

Installing Magento 2 NMI

Introducing the Magento 2 NMI extension

Features and Highlights:

Business value

Configuring Magento 2 NMI

Access

Magento 2 Vault

Payments

Using Magento 2 NMI

Checkout View

Regular Checkout

Multi-address Checkout

Admin Orders Support

Uninstalling NMI

Need Customization?