Delphi DLL

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

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, BinData, Gzip, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
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);

end;