(JavaScript) 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

Note: This example requires Chilkat v11.0.0 or greater.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var http = new CkHttp();

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 CkJsonObject();
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 resp = new CkHttpResponse();
success = http.HttpStr("PUT",url,json.Emit(),"utf-8","application/json",resp);
if (success == 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 = " + resp.StatusCode);

var jsonResp = new CkJsonObject();
jsonResp.Load(resp.BodyStr);
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");