Delphi DLL Requires Chilkat v11.0.0+

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

Delphi DLL

var
success: Boolean;
http: HCkHttp;
json: HCkJsonObject;
url: PWideChar;
resp: HCkHttpResponse;
jsonResp: HCkJsonObject;
amount: PWideChar;
resptext: PWideChar;
acctid: PWideChar;
commcard: PWideChar;
cvvresp: PWideChar;
respcode: PWideChar;
batchid: PWideChar;
avsresp: PWideChar;
entrymode: PWideChar;
defaultacct: PWideChar;
merchid: PWideChar;
token: PWideChar;
authcode: PWideChar;
respproc: PWideChar;
bintype: PWideChar;
profileid: PWideChar;
retref: PWideChar;
respstat: PWideChar;
account: PWideChar;

begin
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:

//  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
json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'merchid','MERCHANT_ID');
CkJsonObject_UpdateString(json,'accttype','VISA');
CkJsonObject_UpdateString(json,'orderid','AB-11-9876');
CkJsonObject_UpdateString(json,'account','4111111111111111');
CkJsonObject_UpdateString(json,'expiry','1221');
CkJsonObject_UpdateString(json,'amount','20');
CkJsonObject_UpdateString(json,'currency','USD');
CkJsonObject_UpdateString(json,'name','TOM JONES');
CkJsonObject_UpdateString(json,'address','123 MAIN STREET');
CkJsonObject_UpdateString(json,'city','anytown');
CkJsonObject_UpdateString(json,'region','NY');
CkJsonObject_UpdateString(json,'country','US');
CkJsonObject_UpdateString(json,'postal','55555');
CkJsonObject_UpdateString(json,'profile','Y');
CkJsonObject_UpdateString(json,'ecomind','E');
CkJsonObject_UpdateString(json,'cvv2','123');
CkJsonObject_UpdateNull(json,'track');
CkJsonObject_UpdateString(json,'capture','Y');

url := 'https://<site>.cardconnect.com:<port>/cardconnect/rest/auth';

resp := CkHttpResponse_Create();
success := CkHttp_HttpStr(http,'PUT',url,CkJsonObject__emit(json),'utf-8','application/json',resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  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.
Memo1.Lines.Add('response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));

jsonResp := CkJsonObject_Create();
CkJsonObject_Load(jsonResp,CkHttpResponse__bodyStr(resp));
CkJsonObject_putEmitCompact(jsonResp,False);

Memo1.Lines.Add('response JSON:');
Memo1.Lines.Add(CkJsonObject__emit(jsonResp));

//  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

amount := CkJsonObject__stringOf(jsonResp,'amount');
resptext := CkJsonObject__stringOf(jsonResp,'resptext');
acctid := CkJsonObject__stringOf(jsonResp,'acctid');
commcard := CkJsonObject__stringOf(jsonResp,'commcard');
cvvresp := CkJsonObject__stringOf(jsonResp,'cvvresp');
respcode := CkJsonObject__stringOf(jsonResp,'respcode');
batchid := CkJsonObject__stringOf(jsonResp,'batchid');
avsresp := CkJsonObject__stringOf(jsonResp,'avsresp');
entrymode := CkJsonObject__stringOf(jsonResp,'entrymode');
defaultacct := CkJsonObject__stringOf(jsonResp,'defaultacct');
merchid := CkJsonObject__stringOf(jsonResp,'merchid');
token := CkJsonObject__stringOf(jsonResp,'token');
authcode := CkJsonObject__stringOf(jsonResp,'authcode');
respproc := CkJsonObject__stringOf(jsonResp,'respproc');
bintype := CkJsonObject__stringOf(jsonResp,'bintype');
profileid := CkJsonObject__stringOf(jsonResp,'profileid');
retref := CkJsonObject__stringOf(jsonResp,'retref');
respstat := CkJsonObject__stringOf(jsonResp,'respstat');
account := CkJsonObject__stringOf(jsonResp,'account');

CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(jsonResp);