Lianja 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

Lianja

llSuccess = .F.

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

loHttp = createobject("CkHttp")

loHttp.BasicAuth = .T.
loHttp.Login = "API_USERNAME"
loHttp.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
loJson = createobject("CkJsonObject")
loJson.UpdateString("merchid","MERCHANT_ID")
loJson.UpdateString("accttype","VISA")
loJson.UpdateString("orderid","AB-11-9876")
loJson.UpdateString("account","4111111111111111")
loJson.UpdateString("expiry","1221")
loJson.UpdateString("amount","20")
loJson.UpdateString("currency","USD")
loJson.UpdateString("name","TOM JONES")
loJson.UpdateString("address","123 MAIN STREET")
loJson.UpdateString("city","anytown")
loJson.UpdateString("region","NY")
loJson.UpdateString("country","US")
loJson.UpdateString("postal","55555")
loJson.UpdateString("profile","Y")
loJson.UpdateString("ecomind","E")
loJson.UpdateString("cvv2","123")
loJson.UpdateNull("track")
loJson.UpdateString("capture","Y")

lcUrl = "https://<site>.cardconnect.com:<port>/cardconnect/rest/auth"

loResp = createobject("CkHttpResponse")
llSuccess = loHttp.HttpStr("PUT",lcUrl,loJson.Emit(),"utf-8","application/json",loResp)
if (llSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loJson
    release loResp
    return
endif

//  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.
? "response status code = " + str(loResp.StatusCode)

loJsonResp = createobject("CkJsonObject")
loJsonResp.Load(loResp.BodyStr)
loJsonResp.EmitCompact = .F.

? "response JSON:"
? loJsonResp.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

lcAmount = loJsonResp.StringOf("amount")
lcResptext = loJsonResp.StringOf("resptext")
lcAcctid = loJsonResp.StringOf("acctid")
lcCommcard = loJsonResp.StringOf("commcard")
lcCvvresp = loJsonResp.StringOf("cvvresp")
lcRespcode = loJsonResp.StringOf("respcode")
lcBatchid = loJsonResp.StringOf("batchid")
lcAvsresp = loJsonResp.StringOf("avsresp")
lcEntrymode = loJsonResp.StringOf("entrymode")
lcDefaultacct = loJsonResp.StringOf("defaultacct")
lcMerchid = loJsonResp.StringOf("merchid")
lcToken = loJsonResp.StringOf("token")
lcAuthcode = loJsonResp.StringOf("authcode")
lcRespproc = loJsonResp.StringOf("respproc")
lcBintype = loJsonResp.StringOf("bintype")
lcProfileid = loJsonResp.StringOf("profileid")
lcRetref = loJsonResp.StringOf("retref")
lcRespstat = loJsonResp.StringOf("respstat")
lcAccount = loJsonResp.StringOf("account")


release loHttp
release loJson
release loResp
release loJsonResp