(C#) Payeezy Place Temp Authorization Hold on Buyer’s Credit Card

Demonstrates how to place a temporary authorization hold for the desired amount on the buyer’s credit card. You can Capture the authorized amount on completion of service or Void/Refund the transaction as required.

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

Chilkat.Crypt2 crypt = new Chilkat.Crypt2();
Chilkat.Prng prng = new Chilkat.Prng();
bool success;

// An API key such as y6pWAJNyJyjGv66IsVuWnklkKUPFbb0a
string apiKey = "my_api_key";
// An API secret such as 86fbae7030253af3cd15faef2a1f4b67353e41fb6799f576b5093ae52901e6f7
string apiSecret = "my_api_secret";
// A token such as fdoa-a480ce8951daa73262734cf102641994c1e55e7cdf4c02b6
string token = "my_merchant_token";

// The nonce is a random number (bytes), something like "6057786719490086000"
string nonce = prng.GenRandom(8,"decimal");
Debug.WriteLine("nonce = " + nonce);

Chilkat.CkDateTime dtNow = new Chilkat.CkDateTime();
dtNow.SetFromCurrentSystemTime();
Chilkat.StringBuilder sbTimestamp = new Chilkat.StringBuilder();
// Get the epoch timestamp in seconds
sbTimestamp.Append(dtNow.GetAsUnixTimeStr(false));
// Change it to milliseconds
sbTimestamp.Append("000");
// The timestamp is a number similar to this: 1546011905000 (which is a timestamp taken on 28-Dec-2018).
string timestamp = sbTimestamp.GetAsString();
Debug.WriteLine("timestamp = " + timestamp);

// Generate the following JSON request body:
// {
//   "merchant_ref": "Astonishing-Sale",
//   "transaction_type": "authorize",
//   "method": "credit_card",
//   "amount": "1299",
//   "currency_code": "USD",
//   "credit_card": {
//     "type": "visa",
//     "cardholder_name": "John Smith",
//     "card_number": "4788250000028291",
//     "exp_date": "1020",
//     "cvv": "123"
//   }
// }

Chilkat.JsonObject json = new Chilkat.JsonObject();
json.UpdateString("merchant_ref","Astonishing-Sale");
json.UpdateString("transaction_type","authorize");
json.UpdateString("method","credit_card");
json.UpdateString("amount","1299");
json.UpdateString("currency_code","USD");
json.UpdateString("credit_card.type","visa");
json.UpdateString("credit_card.cardholder_name","John Smith");
json.UpdateString("credit_card.card_number","4788250000028291");
json.UpdateString("credit_card.exp_date","1020");
json.UpdateString("credit_card.cvv","123");
json.EmitCompact = false;
Debug.WriteLine(json.Emit());

// string hashData = apiKey + nonce + timestamp + token + jsonString;
Chilkat.StringBuilder sbHmacData = new Chilkat.StringBuilder();
sbHmacData.Append(apiKey);
sbHmacData.Append(nonce);
sbHmacData.Append(timestamp);
sbHmacData.Append(token);
sbHmacData.Append(json.Emit());

// HMAC the data to produce a hex string.
crypt.EncodingMode = "hexlower";
crypt.MacAlgorithm = "hmac";
crypt.SetMacKeyString(apiSecret);
crypt.HashAlgorithm = "sha256";
crypt.Charset = "utf-8";
string hexHash = crypt.MacStringENC(sbHmacData.GetAsString());
Debug.WriteLine("hexHash = " + hexHash);

// Now base64 encode the hex string:
Chilkat.StringBuilder sbBase64Hash = new Chilkat.StringBuilder();
sbBase64Hash.Append(hexHash);
sbBase64Hash.Encode("base64","utf-8");

Debug.WriteLine("This is the Authorization header to be sent with the payeezy request:");
Debug.WriteLine("Authorization: " + sbBase64Hash.GetAsString());

// -----------------------------------------------------------
// Now that we have the value for the Authorization header, send the POST containing the JSON.

Chilkat.Http http = new Chilkat.Http();

http.Accept = "*/*";
http.UserAgent = "";
http.SetRequestHeader("Authorization",sbBase64Hash.GetAsString());
http.SetRequestHeader("apikey",apiKey);
http.SetRequestHeader("nonce",nonce);
http.SetRequestHeader("timestamp",timestamp);
http.SetRequestHeader("token",token);

http.SessionLogFilename = "qa_output/payeezy.txt";

string url = "https://api-cert.payeezy.com/v1/transactions";
Chilkat.HttpResponse resp = http.PostJson2(url,"application/json",json.Emit());
if (http.LastMethodSuccess != true) {
    Debug.WriteLine(http.LastErrorText);
    return;
}

Debug.WriteLine("response status code = " + Convert.ToString(resp.StatusCode));
json.Load(resp.BodyStr);
Debug.WriteLine(json.Emit());

// Sample JSON response:

// {
//   "correlation_id": "228.4604632998994",
//   "transaction_status": "approved",
//   "validation_status": "success",
//   "transaction_type": "authorize",
//   "transaction_id": "ET175628",
//   "transaction_tag": "2313721985",
//   "method": "credit_card",
//   "amount": "1299",
//   "currency": "USD",
//   "cvv2": "M",
//   "token": {
//     "token_type": "FDToken",
//     "token_data": {
//       "value": "9732261336638291"
//     }
//   },
//   "card": {
//     "type": "visa",
//     "cardholder_name": "John Smith",
//     "card_number": "8291",
//     "exp_date": "1020"
//   },
//   "bank_resp_code": "100",
//   "bank_message": "Approved",
//   "gateway_resp_code": "00",
//   "gateway_message": "Transaction Normal"
// }
// 

Debug.WriteLine(json.StringOf("correlation_id"));
Debug.WriteLine(json.StringOf("transaction_status"));
Debug.WriteLine(json.StringOf("validation_status"));
Debug.WriteLine(json.StringOf("transaction_type"));
Debug.WriteLine(json.StringOf("transaction_id"));
Debug.WriteLine(json.StringOf("transaction_tag"));
Debug.WriteLine(json.StringOf("method"));
Debug.WriteLine(json.StringOf("amount"));
Debug.WriteLine(json.StringOf("currency"));
Debug.WriteLine(json.StringOf("cvv2"));
Debug.WriteLine(json.StringOf("token.token_type"));
Debug.WriteLine(json.StringOf("token.token_data.value"));
Debug.WriteLine(json.StringOf("card.type"));
Debug.WriteLine(json.StringOf("card.cardholder_name"));
Debug.WriteLine(json.StringOf("card.card_number"));
Debug.WriteLine(json.StringOf("card.exp_date"));
Debug.WriteLine(json.StringOf("bank_resp_code"));
Debug.WriteLine(json.StringOf("bank_message"));
Debug.WriteLine(json.StringOf("gateway_resp_code"));
Debug.WriteLine(json.StringOf("gateway_message"));