EMVKeyMgr Control

Properties   Methods   Events   Configuration Settings   Errors  

The EMVKeyMgr component simplifies the process of downloading EMV public keys for FDMS Rapid Connect and Paymentech.

Syntax

EMVKeyMgr

Remarks

This control connects with either FDMS Rapid Connect or Paymentech to check the status of, and download EMV public key information.

To begin set Platform to specify FDMS Rapid Connect or Paymentech. Next set the appropriate merchant properties for the selected platform.

FDMS Rapid Connect

After calling GetKeyInfo the KeyFileCRC, KeyFileSize, and KeyFileDate should all be saved for use when calling CheckForUpdate at a later time.

To check whether an update is available set KeyFileCRC, KeyFileSize, and KeyFileDate to the values from the current key. If no values are known simply leave these empty. Call CheckForUpdate to determine if an update is applicable. The UpdateAvailable property will be populated and can be queried to determine if an update is available. If an update is available simply call GetKeyInfo to obtain the new public key information.

After calling GetKeyInfo the KeyDetail* properties will hold details about each of the keys returned.

The applicable properties and methods for FDMS Rapid Connect are:

Properties:

• ApplicationId
• DatawireId
• GroupId
• KeyDetails
• KeyFileCRC
• KeyFileDate
• KeyFileSize
• MerchantId
• MerchantTerminalNumber
• Platform
• STAN
• TPPID
• TransactionNumber
• UpdateAvailable
• URL

Methods:

• CheckForUpdate
• GetKeyInfo

EMVKeyMgr for FDMS Rapid Connect Code Example

emvkeymgr.TPPID = "AAA000";
emvkeymgr.MerchantTerminalNumber = "00000001";
emvkeymgr.MerchantId = "1234";
emvkeymgr.GroupId = "20001";
emvkeymgr.DatawireId = "00011122233344455566";
emvkeymgr.ApplicationId = "RAPIDCONNECTVXN";
emvkeymgr.URL = "https://stg.dw.us.fdcnet.biz/rc";

emvkeymgr.STAN = "112";
emvkeymgr.TransactionNumber = "120013";

emvkeymgr.KeyFileDate = "03262014120000";
emvkeymgr.KeyFileSize = 123; 
emvkeymgr.KeyFileCRC = "0000";

//Check if an update is available
emvkeymgr.CheckForUpdate();

if (emvkeymgr.UpdateAvailable)
{
  emvkeymgr.GetKeyInfo();

  //Save these values to provide in the next CheckForUpdate call
  string origKeyCRC = emvkeymgr.KeyFileCRC;
  int origKeySize = emvkeymgr.KeyFileSize;
  string origKeyDate = emvkeymgr.KeyFileDate;

  //Iterate over the key details
  for (int i = 0; i < emvkeymgr.KeyDetails.Count; i++)
  {
    Console.WriteLine("RID: " + emvkeymgr.KeyDetails[i].RID);
    Console.WriteLine("ExpDate: " + emvkeymgr.KeyDetails[i].ExpDate);
    Console.WriteLine("Index: " + emvkeymgr.KeyDetails[i].Index);
    Console.WriteLine("Checksum: " + emvkeymgr.KeyDetails[i].CheckSum);
    Console.WriteLine("Modulus: " + emvkeymgr.KeyDetails[i].Modulus);
    Console.WriteLine("Exponent: " + emvkeymgr.KeyDetails[i].Exponent);
    Console.WriteLine("********************************");
  }
}

Paymentech

Call the GetKeyInfo method to retrieve available public key information. After calling GetKeyInfo the KeyDetail* properties will hold details about each of the keys returned.

The applicable properties and methods for Paymentech are:

Properties:

• ClientNumber
• KeyDetails
• MerchantId
• MerchantTerminalNumber
• Password
• Platform
• SequenceNumber
• URL
• UserId

Methods:

• GetKeyInfo

• DataPacketIn
• DataPacketOut

emvkeymgr.Platform = EmvkeymgrPlatforms.kpPaymentech;
emvkeymgr.URL = "https://netconnectvar.paymentech.net/NetConnect/controller";
emvkeymgr.UserId = "userid";
emvkeymgr.Password = "password";
emvkeymgr.MerchantId = "700000000125";
emvkeymgr.MerchantTerminalNumber = "001";
emvkeymgr.ClientNumber = "0002";    

emvkeymgr.GetKeyInfo();

//Iterate over the key details
for (int i = 0; i < emvkeymgr.KeyDetails.Count; i++)
{
  Console.WriteLine("RID: " + emvkeymgr.KeyDetails[i].RID);
  Console.WriteLine("Index: " + emvkeymgr.KeyDetails[i].Index);
  Console.WriteLine("Checksum: " + emvkeymgr.KeyDetails[i].CheckSum);
  Console.WriteLine("Modulus: " + emvkeymgr.KeyDetails[i].Modulus);
  Console.WriteLine("Exponent: " + emvkeymgr.KeyDetails[i].Exponent);
  Console.WriteLine("Fallback Allowed: " + emvkeymgr.KeyDetails[i].FallbackAllowed);
  Console.WriteLine("********************************");
}