Delphi DLL

CardConnect Capture Level 3 Data

See more CardConnect Examples

Demonstrates how to send a CardConnect Capture request with Lavel 3 line item data.

If available, Level 3 line item data can be sent with the capture request, particularly for any commercial or corporate payment cards. To qualify for Level 3 Interchange rates, Level 2 data must also be provided. ...

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

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpResponse, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
http: HCkHttp;
json: HCkJsonObject;
url: PWideChar;
resp: HCkHttpResponse;
jsonResp: HCkJsonObject;
amount: PWideChar;
resptext: PWideChar;
setlstat: PWideChar;
commcard: PWideChar;
respcode: PWideChar;
batchid: PWideChar;
merchid: PWideChar;
token: PWideChar;
authcode: PWideChar;
respproc: 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:

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

// {
//   "retref": "2880000333",
//   "shiptozip": "11111-1111",
//   "shipfromzip": "99999-9999",
//   "amount": "596.00",
//   "items": [
//     {
//       "discamnt": "0",
//       "unitcost": "900",
//       "uom": "CS",
//       "lineno": "1",
//       "description": "DESCRIPTION-1",
//       "taxamnt": "117",
//       "quantity": "1000",
//       "upc": "UPC-1",
//       "netamnt": "150",
//       "material": "MATERIAL-1"
//     },
//     {
//       "discamnt": "0",
//       "unitcost": "450",
//       "uom": "CS",
//       "lineno": "2",
//       "description": "DESCRIPTION-2",
//       "taxamnt": "117",
//       "quantity": "2000",
//       "upc": "UPC-1",
//       "netamnt": "300",
//       "material": "MATERIAL-2"
//     }
//   ],
//   "taxamount": "40.00",
//   "merchid": "123456789012",
//   "account": "4111111111111111",
//   "ponumber": "PO-0736332"
// }
// 
// Use this online tool to generate the code from sample JSON: 
// Generate Code to Create JSON

json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'retref','112989260941');
CkJsonObject_UpdateString(json,'shiptozip','11111-1111');
CkJsonObject_UpdateString(json,'shipfromzip','99999-9999');
CkJsonObject_UpdateString(json,'amount','596.00');
CkJsonObject_UpdateString(json,'items[0].discamnt','0');
CkJsonObject_UpdateString(json,'items[0].unitcost','900');
CkJsonObject_UpdateString(json,'items[0].uom','CS');
CkJsonObject_UpdateString(json,'items[0].lineno','1');
CkJsonObject_UpdateString(json,'items[0].description','DESCRIPTION-1');
CkJsonObject_UpdateString(json,'items[0].taxamnt','117');
CkJsonObject_UpdateString(json,'items[0].quantity','1000');
CkJsonObject_UpdateString(json,'items[0].upc','UPC-1');
CkJsonObject_UpdateString(json,'items[0].netamnt','150');
CkJsonObject_UpdateString(json,'items[0].material','MATERIAL-1');
CkJsonObject_UpdateString(json,'items[1].discamnt','0');
CkJsonObject_UpdateString(json,'items[1].unitcost','450');
CkJsonObject_UpdateString(json,'items[1].uom','CS');
CkJsonObject_UpdateString(json,'items[1].lineno','2');
CkJsonObject_UpdateString(json,'items[1].description','DESCRIPTION-2');
CkJsonObject_UpdateString(json,'items[1].taxamnt','117');
CkJsonObject_UpdateString(json,'items[1].quantity','2000');
CkJsonObject_UpdateString(json,'items[1].upc','UPC-1');
CkJsonObject_UpdateString(json,'items[1].netamnt','300');
CkJsonObject_UpdateString(json,'items[1].material','MATERIAL-2');
CkJsonObject_UpdateString(json,'taxamount','40.00');
CkJsonObject_UpdateString(json,'merchid','MERCHANT_ID');
CkJsonObject_UpdateString(json,'account','4111111111111111');
CkJsonObject_UpdateString(json,'ponumber','PO-0736332');

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

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

// A successful response looks like this:

// {
//   "amount": "596.00",
//   "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

amount := CkJsonObject__stringOf(jsonResp,'amount');
resptext := CkJsonObject__stringOf(jsonResp,'resptext');
setlstat := CkJsonObject__stringOf(jsonResp,'setlstat');
commcard := CkJsonObject__stringOf(jsonResp,'commcard');
respcode := CkJsonObject__stringOf(jsonResp,'respcode');
batchid := CkJsonObject__stringOf(jsonResp,'batchid');
merchid := CkJsonObject__stringOf(jsonResp,'merchid');
token := CkJsonObject__stringOf(jsonResp,'token');
authcode := CkJsonObject__stringOf(jsonResp,'authcode');
respproc := CkJsonObject__stringOf(jsonResp,'respproc');
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);

end;