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.
cardDetailsEvent(EventParameters eventParameters) call
This will return the whitelisted card Track2 as a string.