(Node.js) 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.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

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

    var crypt = new chilkat.Crypt2();
    var prng = new chilkat.Prng();
    var success;

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

    // The nonce is a random number (bytes), something like "6057786719490086000"
    var nonce = prng.GenRandom(8,"decimal");
    console.log("nonce = " + nonce);

    var dtNow = new chilkat.CkDateTime();
    dtNow.SetFromCurrentSystemTime();
    var 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).
    var timestamp = sbTimestamp.GetAsString();
    console.log("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"
    //   }
    // }

    var 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;
    console.log(json.Emit());

    // string hashData = apiKey + nonce + timestamp + token + jsonString;
    var 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";
    var hexHash = crypt.MacStringENC(sbHmacData.GetAsString());
    console.log("hexHash = " + hexHash);

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

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

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

    var 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";

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

    console.log("response status code = " + resp.StatusCode);
    json.Load(resp.BodyStr);
    console.log(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"
    // }
    // 

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

}

chilkatExample();