Delphi DLL 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

Delphi DLL

var
success: Boolean;
http: HCkHttp;
json: HCkJsonObject;
bd: HCkBinData;
gzip: HCkGzip;
url: PWideChar;
resp: HCkHttpResponse;
jsonResp: HCkJsonObject;

begin
success := False;

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

http := CkHttp_Create();

CkHttp_putBasicAuth(http,True);
CkHttp_putLogin(http,'API_USERNAME');
CkHttp_putPassword(http,'API_PASSWORD');

//  Build and send the following JSON:

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

json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'merchid','MERCHANT_ID');
CkJsonObject_UpdateString(json,'retref','106631225001');

//  Load the .bmp containing a 200px x 100px signature.
bd := CkBinData_Create();
success := CkBinData_LoadFile(bd,'qa_data/bmp/signature.bmp');
//  Gzip compress.
gzip := CkGzip_Create();
success := CkGzip_CompressBd(gzip,bd);
//  Add to the JSON in base64 format
CkJsonObject_UpdateString(json,'signature',CkBinData__getEncoded(bd,'base64'));

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

resp := CkHttpResponse_Create();
success := CkHttp_HttpStr(http,'PUT',url,CkJsonObject__emit(json),'utf-8','application/json',resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  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.
Memo1.Lines.Add('response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));

jsonResp := CkJsonObject_Create();
CkJsonObject_Load(jsonResp,CkHttpResponse__bodyStr(resp));
CkJsonObject_putEmitCompact(jsonResp,False);

Memo1.Lines.Add('response JSON:');
Memo1.Lines.Add(CkJsonObject__emit(jsonResp));

//  A successful response looks like this:

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

CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
CkBinData_Dispose(bd);
CkGzip_Dispose(gzip);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(jsonResp);