API Documentation Classic and REST Versions

PHP code:

									
<?php
// This sample code requires the mhash library for PHP versions older than
// 5.1.2
// The following lines generate fingerprint.
// PHP versions 5.1.2 and newer have the necessary hmac function built in.
// For older versions, it will try to use the mhash library.
if ( phpversion() <= '5.1.2' )
{ $fingerprint = hash_hmac("md5", $loginID . "^" . $sequence . "^" . $timeStamp, $transactionKey); }
else
{ $fingerprint = bin2hex(mhash(MHASH_MD5, $loginID . "^" . $sequence . "^" . $timeStamp, $transactionKey)); }
?>
								

Java Code:

package com.jcx.web.services.l2p.data;

import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.security.SecureRandom;

import javax.crypto.Mac;
import javax.crypto.SecretKey;
import javax.crypto.spec.SecretKeySpec;

public class FingerprintGenerator {
  private long sequence;
  private long timeStamp;
  private String fingerprintHash;
  /**
  * Get the sequence that was used in creating the fingerprint.
  * @return the sequence
  */
  public long getSequence() { return Math.abs(sequence); }
  /**
  * Get the timestamp that was used in creating the fingerprint.
  * @return the timeStamp
  */
  public long getTimeStamp() { return timeStamp; }
  /**
  * Get the fingerprint hash.
  * @return the fingerprintHash
  */
  public String getFingerprintHash() { return fingerprintHash; }
  /**
  * Creates a fingerprint with raw data fields.
  *
  * @param loginID
  * @param transactionKey
  * @param sequence : this number will be concatenated with a random value
  * @return A Fingerprint object.
  */
  public static FingerprintGenerator createFingerprint(String loginID, 
                                  String transactionKey, long sequence)
  {
    FingerprintGenerator fingerprint = new FingerprintGenerator();
    // a sequence number is randomly generated
    SecureRandom generator = new SecureRandom();

    // Sequence is generated. 
    fingerprint.sequence = Long.parseLong(sequence + "" 
	                                      + generator.nextInt(1000));

    // A timestamp is generated.
    fingerprint.timeStamp = System.currentTimeMillis() / 1000;

    // This section uses Java Cryptography functions to generate a fingerprint.
    try
    {
      // First, the Transaction key is converted to a "SecretKey" object.
      SecretKey key = new SecretKeySpec(transactionKey.getBytes(), "HmacMD5");

      //A MAC object is created to generate the hash
      //using the HmacMD5 algorithm.
      Mac mac = Mac.getInstance("HmacMD5");
      mac.init(key);

      String inputstring = null;

      inputstring = loginID + "^" + fingerprint.sequence + "^"
	  + fingerprint.timeStamp;
    
      byte[] result = mac.doFinal(inputstring.getBytes());

      // Convert the result from byte[] to hexadecimal format.
      StringBuilder strbuf = new StringBuilder(result.length * 2);
      for (byte aResult : result)
	  {
          if (((int) aResult & 0xff) < 0x10) {
               strbuf.append("0");
          }
          strbuf.append(Long.toString((int) aResult & 0xff, 16));
      }

          fingerprint.fingerprintHash = strbuf.toString();
    }
    catch (NoSuchAlgorithmException nsae) {
        System.out.println("Fingerprint creation failed. " + nsae.getMessage()); }
    catch (InvalidKeyException ike) {
        System.out.println("Fingerprint creation failed. " + ike.getMessage());}
    return fingerprint;
    }
}
								

C# Code:

namespace L2PPaymentApplication
{
  class FingerprintGenerator
  {
    public string GenerateFingerPrint(int SequenceNumber, string UTCDate, 
	                            string TransactionKey, string APILoginId)
    {
      string StringValue = APILoginId + "^" + SequenceNumber.ToString() + "^"
                                         	  + UTCDate.ToString();

      //The encoding type must be ASCII if reading from the web.config
      byte[] _Key = Encoding.ASCII.GetBytes(Convert.ToString(TransactionKey));

      byte[] _StringToHash = Encoding.ASCII.GetBytes(StringValue);
	  System.Security.Cryptography.HMACMD5 _HMAC_MD5 = 
	                        new System.Security.Cryptography.HMACMD5(_Key);

      byte[] _HashedString = _HMAC_MD5.ComputeHash(_StringToHash); 

      //Convert the byte array back into a string...
      string _return = System.BitConverter.ToString(_HashedString);
      //The bitconverter returns the string with "-" 
	  //between the byte elements.example: C9-85-92-44....
      return _return.Replace("-", "");
    }
    //Method Name:GetUTC()
    //Description:This is a simple function to get the UTC in seconds
    public int GetUTC()
    {
      TimeSpan _TimeSpan = (System.DateTime.Now.ToUniversalTime()
                         	  - System.DateTime.Parse("1/1/1970"));
      return Convert.ToInt32(_TimeSpan.TotalSeconds);
    }
    //Method Name:GetSuquenceNumber()
    //Description:This method generate random sequence number
    public int GetSuquenceNumber()
    {
      Random RndSequenceNumber = new Random();
      return RndSequenceNumber.Next(1, 1000000);
    }
  }
}