(PHP Extension) 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 PHP Downloads PHP Extension for Windows, Linux, MacOS, Alpine Linux, Solaris

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

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

$http = new CkHttp();

$http->put_BasicAuth(true);
$http->put_Login('API_USERNAME');
$http->put_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 = new CkJsonObject();
$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',false,false);

if ($http->get_LastMethodSuccess() == false) {
    print $http->lastErrorText() . "\n";
    exit;
}

// 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.
print 'response status code = ' . $http->get_LastStatus() . "\n";

$jsonResp = new CkJsonObject();
$jsonResp->Load($responseStr);
$jsonResp->put_EmitCompact(false);

print 'response JSON:' . "\n";
print $jsonResp->emit() . "\n";

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

?>