(Ruby) 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 Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

# 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(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 = 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"
responseStr = http.putText(url,json.emit(),"utf-8","application/json",false,false)

if (http.get_LastMethodSuccess() == false)
    print http.lastErrorText() + "\n";
    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.
print "response status code = " + http.get_LastStatus().to_s() + "\n";

jsonResp = Chilkat::CkJsonObject.new()
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")