(Delphi ActiveX) CardConnect Authorization

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

Chilkat for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: TChilkatHttp;
success: Integer;
json: TChilkatJsonObject;
url: WideString;
responseStr: WideString;
jsonResp: TChilkatJsonObject;
amount: WideString;
resptext: WideString;
acctid: WideString;
commcard: WideString;
cvvresp: WideString;
respcode: WideString;
batchid: WideString;
avsresp: WideString;
entrymode: WideString;
defaultacct: WideString;
merchid: WideString;
token: WideString;
authcode: WideString;
respproc: WideString;
bintype: WideString;
profileid: WideString;
retref: WideString;
respstat: WideString;
account: WideString;

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

http := TChilkatHttp.Create(Self);

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

url := 'https://<site>.cardconnect.com:<port>/cardconnect/rest/auth';
responseStr := http.PutText(url,json.Emit(),'utf-8','application/json',0,0);

if (http.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    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(http.LastStatus));

jsonResp := TChilkatJsonObject.Create(Self);
jsonResp.Load(responseStr);
jsonResp.EmitCompact := 0;

Memo1.Lines.Add('response JSON:');
Memo1.Lines.Add(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

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