Documentation – Merchant Payment Processing Services

The HighIsk API is organized around SOAP. Our API accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Integration with the HighIsk webservices services requires generating a hashed signature.

The SHA256 hash function is used to validate the integrity of the data, for more information on SHA256 see: http://en.wikipedia.org/wiki/SHA256

Your Personal Hash Key is managed in the Merchant Control Panel under Global Settings.

Steps to create the signature.

Concatenate the required parameters values, the list of required parameters is explained in the signature field on the API of the service you wish to use.
Add your Personal Hash Key to the end of the concatenated string.
Apply SHA256 hash to the string.
Convert the hash result to Base64.
URL encode the Base64 result if using GET mode.
Now that you have a signature, Include the result as a value of the signature field in the request.

Example with the following values:

CompanyNum = 1234567
TransType = 1
TypeCredit = 1
Amount = 5.4
Currency = 1
CardNum = 4580000000000000
RefTransID = 1234
PersonalHashKey = AU7E468HNF

CompanyNum + TransType + TypeCredit + Amount + Currency + CardNum + RefTransID + PersonalHashKey

1234567 + 1 + 1 + 5.4 + 1 + 4580000000000000 + 1234 + AU7E468HNF

Base64(SHA256(“1234567115.4145800000000000001234AU7E468HNF”))

Result: “PTpzX9OACBC+V3Fd9+TNCehnwIfqMaXmnUtsZMSRyVo=

Code Example

The following examples show how the signature should be built in various languages.

All examples are using the string “1234567ABCDEFGHIJ” as input.

The correct output with URLEncoded is “yZo3as0hwZMOO%2bVO0sTXSg%3d%3d”.
The correct output without URLEncoded is “yZo3as0hwZMOO+VO0sTXSg==”.

Visual Basic

				
					
Public Class Signature
        Public Shared Function GenerateSHA256(ByVal value As String) As String
        Dim sh As System.Security.Cryptography.SHA256 = System.Security.Cryptography.SHA256.Create()
        Dim hashValue As Byte() = sh.ComputeHash(System.Text.Encoding.UTF8.GetBytes(value))
        Return System.Convert.ToBase64String(hashValue)
        End Function
        End Class
        'Usage Example
        Dim sSignature As String = Signature.GenerateSHA256("1234567ABCDEFGHIJ")

C#

				
					
public class Signature
        {
        public static string GenerateSHA256(string value)
        {
        System.Security.Cryptography.SHA256 sh = System.Security.Cryptography.SHA256.Create();
        byte[] hashValue = sh.ComputeHash(System.Text.Encoding.UTF8.GetBytes(value));
        return System.Convert.ToBase64String(hashValue);
        }
        }
        //Usage Example
        string sSignature = Signature.GenerateSHA256("1234567ABCDEFGHIJ");

PHP

				
					$val=base64_encode(hash("sha256", "1234567ABCDEFGHIJ", true));

Steps to create the signature.

Code Example

Visual Basic

C#

PHP

Get Started

Important Links

Contact Us

© HighISK