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

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

loHttp = createobject("CkHttp")

loHttp.BasicAuth = .T.
loHttp.Login = "API_USERNAME"
loHttp.Password = "API_PASSWORD"

// Build and send the following JSON:

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

loJson = createobject("CkJsonObject")
loJson.UpdateString("merchid","MERCHANT_ID")
loJson.UpdateString("retref","106631225001")

// Load the .bmp containing a 200px x 100px signature.
loBd = createobject("CkBinData")
llSuccess = loBd.LoadFile("qa_data/bmp/signature.bmp")
// Gzip compress.
loGzip = createobject("CkGzip")
llSuccess = loGzip.CompressBd(loBd)
// Add to the JSON in base64 format
loJson.UpdateString("signature",loBd.GetEncoded("base64"))

lcUrl = "https://<site>.cardconnect.com:<port>/cardconnect/rest/sigcap"
lcResponseStr = loHttp.PutText(lcUrl,loJson.Emit(),"utf-8","application/json",.F.,.F.)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loJson
    release loBd
    release loGzip
    return
endif

// 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.
? "response status code = " + str(loHttp.LastStatus)

loJsonResp = createobject("CkJsonObject")
loJsonResp.Load(lcResponseStr)
loJsonResp.EmitCompact = .F.

? "response JSON:"
? loJsonResp.Emit()

// A successful response looks like this:

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


release loHttp
release loJson
release loBd
release loGzip
release loJsonResp