Objective-C

CardConnect Authorization

See more CardConnect Examples

Demonstrates how to send an Authorization request.

Authorization is the initial step in accepting payment from a cardholder. This action "authorizes" or requests permission from the bank to transfer money from the cardholder to the merchant.

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

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:

// Note: The CardConnect online documentation might use an expiry that is in the past, such as "1218".
// This causes the request to fail.  Use a month/year that is in the future..
// (Likewise, this example will have an invalid month/year after Dec 2021)

// {
//   "merchid": "MERCHANT_ID",
//   "accttype": "VISA",
//   "orderid": "AB-11-9876",
//   "account": "4111111111111111",
//   "expiry": "1221",
//   "amount": "0",
//   "currency": "USD",
//   "name": "TOM JONES",
//   "address": "123 MAIN STREET",
//   "city": "anytown",
//   "region": "NY",
//   "country": "US",
//   "postal": "55555",
//   "profile": "Y",
//   "ecomind": "E",
//   "cvv2": "123",
//   "track": null,
//   "capture": "Y"
// }

// Use this online tool to generate the code from sample JSON: 
// Generate Code to Create JSON
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"merchid" value: @"MERCHANT_ID"];
[json UpdateString: @"accttype" value: @"VISA"];
[json UpdateString: @"orderid" value: @"AB-11-9876"];
[json UpdateString: @"account" value: @"4111111111111111"];
[json UpdateString: @"expiry" value: @"1221"];
[json UpdateString: @"amount" value: @"20"];
[json UpdateString: @"currency" value: @"USD"];
[json UpdateString: @"name" value: @"TOM JONES"];
[json UpdateString: @"address" value: @"123 MAIN STREET"];
[json UpdateString: @"city" value: @"anytown"];
[json UpdateString: @"region" value: @"NY"];
[json UpdateString: @"country" value: @"US"];
[json UpdateString: @"postal" value: @"55555"];
[json UpdateString: @"profile" value: @"Y"];
[json UpdateString: @"ecomind" value: @"E"];
[json UpdateString: @"cvv2" value: @"123"];
[json UpdateNull: @"track"];
[json UpdateString: @"capture" value: @"Y"];

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

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]);

// Sample error:

// {
//   "respproc": "PPS",
//   "amount": "0.00",
//   "resptext": "Invalid amount",
//   "cardproc": "FNOR",
//   "acctid": "1",
//   "retref": "112804260418",
//   "respstat": "C",
//   "respcode": "43",
//   "account": "41XXXXXXXXXX1111",
//   "defaultacct": "Y",
//   "merchid": "MERCHANT_ID",
//   "token": "9418594164541111"
// }

// A successful response looks like this:

// {
//   "amount": "0.20",
//   "resptext": "Approval",
//   "acctid": "1",
//   "commcard": " C ",
//   "cvvresp": "M",
//   "respcode": "00",
//   "batchid": "1900942291",
//   "avsresp": "Z",
//   "entrymode": "ECommerce",
//   "defaultacct": "Y",
//   "merchid": "MERCHANT_ID",
//   "token": "9418594164541111",
//   "authcode": "PPS158",
//   "respproc": "FNOR",
//   "bintype": "",
//   "profileid": "16618402968441604028",
//   "retref": "112989260941",
//   "respstat": "A",
//   "account": "41XXXXXXXXXX1111"
// }

// 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 *acctid = [jsonResp StringOf: @"acctid"];
NSString *commcard = [jsonResp StringOf: @"commcard"];
NSString *cvvresp = [jsonResp StringOf: @"cvvresp"];
NSString *respcode = [jsonResp StringOf: @"respcode"];
NSString *batchid = [jsonResp StringOf: @"batchid"];
NSString *avsresp = [jsonResp StringOf: @"avsresp"];
NSString *entrymode = [jsonResp StringOf: @"entrymode"];
NSString *defaultacct = [jsonResp StringOf: @"defaultacct"];
NSString *merchid = [jsonResp StringOf: @"merchid"];
NSString *token = [jsonResp StringOf: @"token"];
NSString *authcode = [jsonResp StringOf: @"authcode"];
NSString *respproc = [jsonResp StringOf: @"respproc"];
NSString *bintype = [jsonResp StringOf: @"bintype"];
NSString *profileid = [jsonResp StringOf: @"profileid"];
NSString *retref = [jsonResp StringOf: @"retref"];
NSString *respstat = [jsonResp StringOf: @"respstat"];
NSString *account = [jsonResp StringOf: @"account"];