(Visual FoxPro) 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 ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL lcUrl
LOCAL lcResponseStr
LOCAL loJsonResp
LOCAL lcAmount
LOCAL lcResptext
LOCAL lcAcctid
LOCAL lcCommcard
LOCAL lcCvvresp
LOCAL lcRespcode
LOCAL lcBatchid
LOCAL lcAvsresp
LOCAL lcEntrymode
LOCAL lcDefaultacct
LOCAL lcMerchid
LOCAL lcToken
LOCAL lcAuthcode
LOCAL lcRespproc
LOCAL lcBintype
LOCAL lcProfileid
LOCAL lcRetref
LOCAL lcRespstat
LOCAL lcAccount

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')

loHttp.BasicAuth = 1
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
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
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"
lcResponseStr = loHttp.PutText(lcUrl,loJson.Emit(),"utf-8","application/json",0,0)

IF (loHttp.LastMethodSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    CANCEL
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(loHttp.LastStatus)

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJsonResp = CreateObject('Chilkat.JsonObject')
loJsonResp.Load(lcResponseStr)
loJsonResp.EmitCompact = 0

? "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 loJsonResp