Swift

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

Swift

func chilkatTest() {
    var success: Bool = false

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

    let http = CkoHttp()!

    http.basicAuth = true
    http.login = "API_USERNAME"
    http.password = "API_PASSWORD"

    // Build and send the following JSON:

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

    let json = CkoJsonObject()!
    json.updateString(jsonPath: "merchid", value: "MERCHANT_ID")
    json.updateString(jsonPath: "retref", value: "106631225001")

    // Load the .bmp containing a 200px x 100px signature.
    let bd = CkoBinData()!
    success = bd.loadFile(path: "qa_data/bmp/signature.bmp")
    // Gzip compress.
    let gzip = CkoGzip()!
    success = gzip.compressBd(binDat: bd)
    // Add to the JSON in base64 format
    json.updateString(jsonPath: "signature", value: bd.getEncoded(encoding: "base64"))

    var url: String? = "https://<site>.cardconnect.com:<port>/cardconnect/rest/sigcap"

    let resp = CkoHttpResponse()!
    success = http.httpStr(verb: "PUT", url: url, bodyStr: json.emit(), charset: "utf-8", contentType: "application/json", response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        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.
    print("response status code = \(resp.statusCode.intValue)")

    let jsonResp = CkoJsonObject()!
    jsonResp.load(json: resp.bodyStr)
    jsonResp.emitCompact = false

    print("response JSON:")
    print("\(jsonResp.emit()!)")

    // A successful response looks like this:

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

}