Objective-C

CardConnect Capture

See more CardConnect Examples

Demonstrates how to send a CardConnect Capture request.

The capture service queues the transaction amount for settlement. Capture can occur within the authorization request or subsequently. ...

See https://developer.cardconnect.com/cardconnect-api#capture

Objective-C

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <NSString.h>
#import <CkoHttpResponse.h>

BOOL success = NO;

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

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

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

// Build and send the following JSON:

// The "retref" is the value returned in the JSON response for the Authorization request.

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

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

NSString *url = @"https://<site>.cardconnect.com:<port>/cardconnect/rest/capture";

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpStr: @"PUT" url: url bodyStr: [json Emit] charset: @"utf-8" contentType: @"application/json" response: resp];
if (success == 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 = ",[resp.StatusCode intValue]);

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

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

// A successful response looks like this:

// {
//   "amount": "0.20",
//   "resptext": "Approval",
//   "setlstat": "Queued for Capture",
//   "commcard": " C ",
//   "respcode": "00",
//   "batchid": "1900942291",
//   "merchid": "MERCHANT_ID",
//   "token": "9418594164541111",
//   "authcode": "PPS158",
//   "respproc": "FNOR",
//   "retref": "112989260941",
//   "respstat": "A",
//   "account": "9418594164541111"
// }

// Use this online tool to generate parsing code from sample JSON: 
// Generate Parsing Code from JSON

NSString *amount = [jsonResp StringOf: @"amount"];
NSString *resptext = [jsonResp StringOf: @"resptext"];
NSString *setlstat = [jsonResp StringOf: @"setlstat"];
NSString *commcard = [jsonResp StringOf: @"commcard"];
NSString *respcode = [jsonResp StringOf: @"respcode"];
NSString *batchid = [jsonResp StringOf: @"batchid"];
NSString *merchid = [jsonResp StringOf: @"merchid"];
NSString *token = [jsonResp StringOf: @"token"];
NSString *authcode = [jsonResp StringOf: @"authcode"];
NSString *respproc = [jsonResp StringOf: @"respproc"];
NSString *retref = [jsonResp StringOf: @"retref"];
NSString *respstat = [jsonResp StringOf: @"respstat"];
NSString *account = [jsonResp StringOf: @"account"];