Registration

Registration with the EMV Sandbox environment is possible following commercial relationship with NMI.

Once a commercial agreement is in place, to begin use of the EMV Sandbox Environment you must first create a Merchant Account via the NMI Partner Portal, set the account to Test Mode, and enable Encrypted Devices in the NMI Marketplace.

All of this can be accomplished manually as documented below, or can be achieved via API.

Click here to learn more about creating Merchant accounts via API.

Step 1: Create a Merchant Account

You can manually create a new Merchant Account in your NMI Partner Portal by following the simple onboarding process contained there.

Step 2: Enable Test Mode

Test Mode allows you to submit test transactions to the Payment Gateway. You can submit transactions to any merchant account that is in Test Mode. While in Test Mode no actual charges will be processed, and nothing will be sent to the credit card or ACH processor.

To place your account in Test Mode, log into your Merchant Portal and go to Settings > Test Mode > Enable Test Mode. To switch your account back to live transactions, click Disable Test Mode.

Step 3: Enable Encrypted Devices

In order to perform in-person payments with NMI, you must enable Encrypted Devices within the NMI Marketplace, both in the Partner Portal and the Merchant Portal.

First, enable this feature by navigating to the Marketplace in the NMI Partner Portal.

After enabling this in the Partner Portal, it will be visible within the Merchant Portal under Marketplace Apps.

Step 4: Perform a Transaction

Perform a test transaction to the following URL:

URL: https://test.cardeasexml.com/gwdirect.cex

After performing a transaction, contact our support team for access to the EMV Sandbox environment. You will require your TransactionID for us to identify you and update your access.

Example Postman Collection

To allow for easy experimentation with the EMV Sandbox, a Postman collection has been created and has been provided along with this document. This has example requests for some of the test cases available as well as some example bad requests, which can be used to experiment with validation output from the testing platform.

To import this collection into Postman follow the instructions on the official Postman website, which can be found here. Once this collection has been imported, you API key can be entered into the collection variables so that the requests are processed correctly. See herefor help on setting collection variables. Specifically the following variables must be configured: ApiKey.