Pascal (Lazarus/Delphi)

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

Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Http,
  Chilkat.HttpResponse,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  json: TJsonObject;
  url: string;
  resp: THttpResponse;
  jsonResp: TJsonObject;
  amount: string;
  resptext: string;
  acctid: string;
  commcard: string;
  cvvresp: string;
  respcode: string;
  batchid: string;
  avsresp: string;
  entrymode: string;
  defaultacct: string;
  merchid: string;
  token: string;
  authcode: string;
  respproc: string;
  bintype: string;
  profileid: string;
  retref: string;
  respstat: string;
  account: string;

begin
  success := False;

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

  http := THttp.Create;

  http.BasicAuth := True;
  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 := TJsonObject.Create;
  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';

  resp := THttpResponse.Create;
  success := http.HttpStr('PUT',url,json.Emit(),'utf-8','application/json',resp);
  if (success = False) then
    begin
      WriteLn(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.
  WriteLn('response status code = ' + resp.StatusCode);

  jsonResp := TJsonObject.Create;
  jsonResp.Load(resp.BodyStr);
  jsonResp.EmitCompact := False;

  WriteLn('response JSON:');
  WriteLn(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');


  http.Free;
  json.Free;
  resp.Free;
  jsonResp.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.