(JavaScript) CardConnect Signature Capture

Demonstrates how to upload a BMP image of a handwritten signature.

This signature capture service augments an existing authorization record with the provided signature data. ...

See https://developer.cardconnect.com/cardconnect-api?lang=json#signature-capture

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:

// {
//   "merchid": "MERCHANT_ID",
//   "retref": "112989260941",
//   "signature": "BASE64_GZIPPED_BMP_DATA"
// }

var json = new CkJsonObject();
json.UpdateString("merchid","MERCHANT_ID");
json.UpdateString("retref","106631225001");

// Load the .bmp containing a 200px x 100px signature.
var bd = new CkBinData();
success = bd.LoadFile("qa_data/bmp/signature.bmp");
// Gzip compress.
var gzip = new CkGzip();
success = gzip.CompressBd(bd);
// Add to the JSON in base64 format
json.UpdateString("signature",bd.GetEncoded("base64"));

var url = "https://<site>.cardconnect.com:<port>/cardconnect/rest/sigcap";

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

// A successful response looks like this:

// {
//   "resptext": "signature stored",
//   "retref": "106631225001",
//   "respcode": "02",
//   "merchid": "MERCHANT_ID"
// }