Delphi DLL

CardConnect Settlement Status

See more CardConnect Examples

Demonstrates how to get the status of transactions which have been submitted to the processor for settlement.

The settlement status service returns the status of transactions which have been submitted to the processor for settlement. The transaction’s setlstatus is updated appropriately when CardConnect’s receives a response from the processor. You can either specify a batchid to return a specific batch of transactions, or use a date to return all transactions settled for that date. ...

See https://developer.cardconnect.com/cardconnect-api#settlement-status

Delphi DLL

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
http: HCkHttp;
url: PWideChar;
responseStr: PWideChar;
jsonResp: HCkJsonObject;
setlamount: PWideChar;
setlstat: PWideChar;
salesdoc: PWideChar;
retref: PWideChar;
respproc: PWideChar;
hostbatch: PWideChar;
refundtotal: PWideChar;
batchid: PWideChar;
chargetotal: PWideChar;
hoststat: PWideChar;
merchid: PWideChar;
i: Integer;
count_i: Integer;

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

url := 'https://<site>.cardconnect.com:<port>/cardconnect/rest/settlestat?merchid=<merchid>&batchid=<batchid>';
responseStr := CkHttp__quickGetStr(http,url);
if (CkHttp_getLastMethodSuccess(http) = 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(CkHttp_getLastStatus(http)));

jsonResp := CkJsonObject_Create();
CkJsonObject_Load(jsonResp,responseStr);
CkJsonObject_putEmitCompact(jsonResp,False);

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

// A successful response looks like this:

// {
//   "respproc": "FNOR",
//   "hostbatch": "",
//   "refundtotal": "0.00",
//   "batchid": "1900942291",
//   "chargetotal": "0.00",
//   "hoststat": "",
//   "merchid": "MERCHANT_ID",
//   "txns": [
//     {
//       "setlamount": "13.28",
//       "setlstat": "R",
//       "salesdoc": "rosedale_1555412201_392",
//       "retref": "106631225001"
//     },
//     {
//       "setlamount": "13.28",
//       "setlstat": "R",
//       "salesdoc": "rosedale_1555412353_392",
//       "retref": "106731125153"
//     },
//     {
//       "setlamount": "7.64",
//       "setlstat": "R",
//       "salesdoc": "rosedale_1555414960_393",
//       "retref": "106008227760"
//     }
//   ]
// }

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

respproc := CkJsonObject__stringOf(jsonResp,'respproc');
hostbatch := CkJsonObject__stringOf(jsonResp,'hostbatch');
refundtotal := CkJsonObject__stringOf(jsonResp,'refundtotal');
batchid := CkJsonObject__stringOf(jsonResp,'batchid');
chargetotal := CkJsonObject__stringOf(jsonResp,'chargetotal');
hoststat := CkJsonObject__stringOf(jsonResp,'hoststat');
merchid := CkJsonObject__stringOf(jsonResp,'merchid');
i := 0;
count_i := CkJsonObject_SizeOfArray(jsonResp,'txns');
while i < count_i do
  begin
    CkJsonObject_putI(jsonResp,i);
    setlamount := CkJsonObject__stringOf(jsonResp,'txns[i].setlamount');
    setlstat := CkJsonObject__stringOf(jsonResp,'txns[i].setlstat');
    salesdoc := CkJsonObject__stringOf(jsonResp,'txns[i].salesdoc');
    retref := CkJsonObject__stringOf(jsonResp,'txns[i].retref');
    i := i + 1;
  end;

CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonResp);

end;