NMI integration guide

NMINMI NMI is a gateway that allows you to collect card and eCheck payments. This guide is intended to help you implement NMI based on your preferred integration workflow.

Services and compatibility

Supported payment types
  • Card
  • eCheck
Supported transaction types
  • Sale ( API )
  • Auth Only ( API )
  • Capture (partial and greater than) ( API )
  • Void ( API )
  • Refund (partial and multiple) ( API )
Supported processing currenciesAUD, CAD, EUR, GBP, HKD, JPY, MYR, PLN, THB, TWD, USD
3D Secure 1.x supportedYes
3D Secure 2.x supportedYes
Installments supportedNo

Configuration

Work with Integrations Support to add NMI as a connection. You will need the following credentials from NMI:

  • username
  • password
  • processor ID

OR

  • security key
  • processor ID

Required fields

There are no additional required fields.

Testing data

If you do not have Advanced Testing Triggers enabled on your account, use the following test cards to test your NMI configuration.

BrandCard numberExp dateSecurity codeCardholder name3DSTransaction result
Visa4111111111111111Any future dateAnyAnyN/ASuccess
Mastercard5431111111111111Any future dateAnyAnyN/ASuccess
American Express341111111111111Any future dateAny (ex: 1234)AnyN/ASuccess
Discover6011601160116611Any future dateAnyAnyN/ASuccess

If you do have Advanced Testing Triggers enabled on your account, use the following test cards to test your NMI configuration.

BrandCard numberExp dateSecurity codeCardholder name3DSTransaction result
Visa4111110208009428Any future dateAnyAnyN/ASuccess
Mastercard5412750109056250Any future dateAnyAnyN/ASuccess
American Express375987004003245Any future dateAny (ex: 1234)AnyN/ASuccess
Discover6011000011020538Any future dateAnyAnyN/ASuccess

Status workflows

The status of a successful transaction with NMI varies, depending on the options you choose.

SaleWhen isAuthOnly is false, successful sale transactions will have the following statuses:
  • pending*
  • settled
Auth onlyWhen isAuthOnly is true, successful sale transactions will have the following status:
  • authOnly
CaptureSuccessful capture transactions will have the following statuses:
  • pending*
  • settled
VoidSuccessful void transactions will have the following status:
  • voided
RefundSuccessful refund transactions will have the following statuses:
  • pending*
  • settled

*Pending status displays as "authorized" or "AUTHORIZED" in the Nexio Dashboard; it displays as 10, meaning "authorized", in the response when querying transactions (for more information about transactionStatus, see the appropriate transactionStatus table).

If you have any additional questions or feedback, contact us.


Did this page help you?