Perl Requires Chilkat v11.0.0+

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

Perl

use chilkat();

$success = 0;

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

$http = chilkat::CkHttp->new();

$http->put_BasicAuth(1);
$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 = chilkat::CkJsonObject->new();
$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 = chilkat::CkHttpResponse->new();
$success = $http->HttpStr("PUT",$url,$json->emit(),"utf-8","application/json",$resp);
if ($success == 0) {
    print $http->lastErrorText() . "\r\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 = " . $resp->get_StatusCode() . "\r\n";

$jsonResp = chilkat::CkJsonObject->new();
$jsonResp->Load($resp->bodyStr());
$jsonResp->put_EmitCompact(0);

print "response JSON:" . "\r\n";
print $jsonResp->emit() . "\r\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");