(Node.js) CardConnect Authorization

Demonstrates how to send an Authorization request.

Authorization is the initial step in accepting payment from a cardholder. This action "authorizes" or requests permission from the bank to transfer money from the cardholder to the merchant.

See https://developer.cardconnect.com/cardconnect-api#authorization

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 assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var http = new chilkat.Http();
    var success;

    http.BasicAuth = true;
    http.Login = "API_USERNAME";
    http.Password = "API_PASSWORD";

    // Build and send the following JSON:

    // Note: The CardConnect online documentation might use an expiry that is in the past, such as "1218".
    // This causes the request to fail.  Use a month/year that is in the future..
    // (Likewise, this example will have an invalid month/year after Dec 2021)

    // {
    //   "merchid": "MERCHANT_ID",
    //   "accttype": "VISA",
    //   "orderid": "AB-11-9876",
    //   "account": "4111111111111111",
    //   "expiry": "1221",
    //   "amount": "0",
    //   "currency": "USD",
    //   "name": "TOM JONES",
    //   "address": "123 MAIN STREET",
    //   "city": "anytown",
    //   "region": "NY",
    //   "country": "US",
    //   "postal": "55555",
    //   "profile": "Y",
    //   "ecomind": "E",
    //   "cvv2": "123",
    //   "track": null,
    //   "capture": "Y"
    // }

    // Use this online tool to generate the code from sample JSON: 
    // Generate Code to Create JSON
    var json = new chilkat.JsonObject();
    json.UpdateString("merchid","MERCHANT_ID");
    json.UpdateString("accttype","VISA");
    json.UpdateString("orderid","AB-11-9876");
    json.UpdateString("account","4111111111111111");
    json.UpdateString("expiry","1221");
    json.UpdateString("amount","20");
    json.UpdateString("currency","USD");
    json.UpdateString("name","TOM JONES");
    json.UpdateString("address","123 MAIN STREET");
    json.UpdateString("city","anytown");
    json.UpdateString("region","NY");
    json.UpdateString("country","US");
    json.UpdateString("postal","55555");
    json.UpdateString("profile","Y");
    json.UpdateString("ecomind","E");
    json.UpdateString("cvv2","123");
    json.UpdateNull("track");
    json.UpdateString("capture","Y");

    var url = "https://<site>.cardconnect.com:<port>/cardconnect/rest/auth";
    var responseStr = http.PutText(url,json.Emit(),"utf-8","application/json",false,false);

    if (http.LastMethodSuccess == false) {
        console.log(http.LastErrorText);
        return;
    }

    // A response status of 200 indicates potential success.  The JSON response body
    // must be examined to determine if it was truly successful or an error.
    console.log("response status code = " + http.LastStatus);

    var jsonResp = new chilkat.JsonObject();
    jsonResp.Load(responseStr);
    jsonResp.EmitCompact = false;

    console.log("response JSON:");
    console.log(jsonResp.Emit());

    // Sample error:

    // {
    //   "respproc": "PPS",
    //   "amount": "0.00",
    //   "resptext": "Invalid amount",
    //   "cardproc": "FNOR",
    //   "acctid": "1",
    //   "retref": "112804260418",
    //   "respstat": "C",
    //   "respcode": "43",
    //   "account": "41XXXXXXXXXX1111",
    //   "defaultacct": "Y",
    //   "merchid": "MERCHANT_ID",
    //   "token": "9418594164541111"
    // }

    // A successful response looks like this:

    // {
    //   "amount": "0.20",
    //   "resptext": "Approval",
    //   "acctid": "1",
    //   "commcard": " C ",
    //   "cvvresp": "M",
    //   "respcode": "00",
    //   "batchid": "1900942291",
    //   "avsresp": "Z",
    //   "entrymode": "ECommerce",
    //   "defaultacct": "Y",
    //   "merchid": "MERCHANT_ID",
    //   "token": "9418594164541111",
    //   "authcode": "PPS158",
    //   "respproc": "FNOR",
    //   "bintype": "",
    //   "profileid": "16618402968441604028",
    //   "retref": "112989260941",
    //   "respstat": "A",
    //   "account": "41XXXXXXXXXX1111"
    // }

    // Use this online tool to generate parsing code from sample JSON: 
    // Generate Parsing Code from JSON

    var amount = jsonResp.StringOf("amount");
    var resptext = jsonResp.StringOf("resptext");
    var acctid = jsonResp.StringOf("acctid");
    var commcard = jsonResp.StringOf("commcard");
    var cvvresp = jsonResp.StringOf("cvvresp");
    var respcode = jsonResp.StringOf("respcode");
    var batchid = jsonResp.StringOf("batchid");
    var avsresp = jsonResp.StringOf("avsresp");
    var entrymode = jsonResp.StringOf("entrymode");
    var defaultacct = jsonResp.StringOf("defaultacct");
    var merchid = jsonResp.StringOf("merchid");
    var token = jsonResp.StringOf("token");
    var authcode = jsonResp.StringOf("authcode");
    var respproc = jsonResp.StringOf("respproc");
    var bintype = jsonResp.StringOf("bintype");
    var profileid = jsonResp.StringOf("profileid");
    var retref = jsonResp.StringOf("retref");
    var respstat = jsonResp.StringOf("respstat");
    var account = jsonResp.StringOf("account");

}

chilkatExample();