Whitelisting functionality allows the ability to pass through clear text unencrypted data from the PIN pad to the integrator's Point of Sale (POS), dependent upon a pre-defined BIN range specified within a Whitelist File. The required Whitelist BIN Ranges must be submitted to NMI to compile a Whitelist File and submit it for approval to the hardware manufacturer. The hardware manufacturer will then review the contents and return a secure signed copy of the file for use on the terminal, which we send to the required terminals via our Terminal Management System through a TMS update.
Retrieving Whitelisted Card Data
Using our Payment Device SDK API, the whitelisted card data can be found inside the TRACK2_CLEAR_TEXT parameter within the cardDetailsEvent callback function which is invoked by calling ClientHelper.getCardDetails( ). Example:
Response response = ClientHelper.getCardDetails(null);
This will prompt the PIN pad for the card. Once the card is inserted and read, the cardDetailsEvent will be invoked.
Inside cardDetailsEvent(EventParameters eventParameters) call
eventParameters.getValue(ParameterKeys.Track2ClearText));
This will return the whitelisted card Track2 as a string.