Xbase++ Requires Chilkat v11.0.0+

CardConnect Signature Capture

See more CardConnect Examples

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

Xbase++

LOCAL nSuccess
LOCAL oHttp
LOCAL oJson
LOCAL oBd
LOCAL oGzip
LOCAL cUrl
LOCAL oResp
LOCAL oJsonResp

nSuccess := 0

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

oHttp := CreateObject("Chilkat.Http")

oHttp:BasicAuth := 1
oHttp:Login := "API_USERNAME"
oHttp:Password := "API_PASSWORD"

//  Build and send the following JSON:

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

oJson := CreateObject("Chilkat.JsonObject")
oJson:UpdateString("merchid", "MERCHANT_ID")
oJson:UpdateString("retref", "106631225001")

//  Load the .bmp containing a 200px x 100px signature.
oBd := CreateObject("Chilkat.BinData")
nSuccess := oBd:LoadFile("qa_data/bmp/signature.bmp")
//  Gzip compress.
oGzip := CreateObject("Chilkat.Gzip")
nSuccess := oGzip:CompressBd(oBd)
//  Add to the JSON in base64 format
oJson:UpdateString("signature", oBd:GetEncoded("base64"))

cUrl := "https://<site>.cardconnect.com:<port>/cardconnect/rest/sigcap"

oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpStr("PUT", cUrl, oJson:Emit(), "utf-8", "application/json", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oHttp:destroy()
    oJson:destroy()
    oBd:destroy()
    oGzip:destroy()
    oResp:destroy()
    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(oResp:StatusCode)

oJsonResp := CreateObject("Chilkat.JsonObject")
oJsonResp:Load(oResp:BodyStr)
oJsonResp:EmitCompact := 0

? "response JSON:"
? oJsonResp:Emit()

//  A successful response looks like this:

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

oHttp:destroy()
oJson:destroy()
oBd:destroy()
oGzip:destroy()
oResp:destroy()
oJsonResp:destroy()