(C) 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.

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkBinData.h>
#include <C_CkGzip.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttp http;
    HCkJsonObject json;
    HCkBinData bd;
    HCkGzip gzip;
    const char *url;
    HCkHttpResponse resp;
    HCkJsonObject jsonResp;

    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) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        CkBinData_Dispose(bd);
        CkGzip_Dispose(gzip);
        CkHttpResponse_Dispose(resp);
        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.
    printf("response status code = %d\n",CkHttpResponse_getStatusCode(resp));

    jsonResp = CkJsonObject_Create();
    CkJsonObject_Load(jsonResp,CkHttpResponse_bodyStr(resp));
    CkJsonObject_putEmitCompact(jsonResp,FALSE);

    printf("response JSON:\n");
    printf("%s\n",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);

    }