(Objective-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

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoBinData.h>
#import <CkoGzip.h>
#import <NSString.h>

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

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

http.BasicAuth = YES;
http.Login = @"API_USERNAME";
http.Password = @"API_PASSWORD";

// Build and send the following JSON:

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

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"merchid" value: @"MERCHANT_ID"];
[json UpdateString: @"retref" value: @"106631225001"];

// Load the .bmp containing a 200px x 100px signature.
CkoBinData *bd = [[CkoBinData alloc] init];
success = [bd LoadFile: @"qa_data/bmp/signature.bmp"];
// Gzip compress.
CkoGzip *gzip = [[CkoGzip alloc] init];
success = [gzip CompressBd: bd];
// Add to the JSON in base64 format
[json UpdateString: @"signature" value: [bd GetEncoded: @"base64"]];

NSString *url = @"https://<site>.cardconnect.com:<port>/cardconnect/rest/sigcap";
NSString *responseStr = [http PutText: url textData: [json Emit] charset: @"utf-8" contentType: @"application/json" md5: NO gzip: NO];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",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.
NSLog(@"%@%d",@"response status code = ",[http.LastStatus intValue]);

CkoJsonObject *jsonResp = [[CkoJsonObject alloc] init];
[jsonResp Load: responseStr];
jsonResp.EmitCompact = NO;

NSLog(@"%@",@"response JSON:");
NSLog(@"%@",[jsonResp Emit]);

// A successful response looks like this:

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