To generate the signature, combine parameter values of the request in alphabetical order, by parameter name, along with the merchant authkey (provided to the merchant by Snap* Hosted Payments); then, hash the string using an MD5 hash.

Example:

Assuming the parameters for the Snap* Hosted Payments request are as follows:

• • - code = merchant
  • - action = get_order
  • - return = json
  • - merchant_order_id = 808

And assuming the merchant’s authkey is “12345678”, a signature can be generated using the following PHP code:

?php
// private key known only to merchant and Snap* Hosted Payment
$authkey = "12345678";

// parameters and values
$code = “merchant”;
$action = “get_order”;
$return = “json”;
$merchant_order_id = “808”;

// concatenate the parameter values in alphabetical order by parameter name
$plain = $action.$code.$merchant_order_id.$return;

// then add the private authkey
$plain.= $authkey;

// now generate the signature using the md5() function
$signature = md5($plain);
?

Another example of PHP code for generating a MAC signature:

?php
// private key known only to merchant and Snap* Hosted Payment
$authkey = "12345678";

// parameters and values
$code = “merchant”;
$email = “carissa@pycroft.com”;
$merchant_order_id = “100000546”;
$order_total_subtotal = “19.99”;
$order_total = “21.99”;

// concatenate the parameter values in alphabetical order by parameter name
$plain = $code.$email.$merchant_order_id.$order_total.$order_total_subtotal;

// then add the private authkey
$plain.= $authkey;

// now generate the signature using the md5() function
$signature = md5($plain);
?

For each of the API actions the Merchant code, Merchant authkey, API action and all required action-specific parameters should be used to generate the MAC signature. The Merchant authkey is expected as the last parameter of every MAC signature prior to encoding.

There should be no spaces between the parameters when they are concatenated into a string.

Use the following parameters in the sequences listed to generate the MAC signature: