Visual FoxPro

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

Visual FoxPro

LOCAL lnSuccess
LOCAL loHttp
LOCAL loJson
LOCAL lcUrl
LOCAL loResp
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

lnSuccess = 0

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

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

loResp = CreateObject('Chilkat.HttpResponse')
lnSuccess = loHttp.HttpStr("PUT",lcUrl,loJson.Emit(),"utf-8","application/json",loResp)
IF (lnSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    RELEASE loResp
    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(loResp.StatusCode)

loJsonResp = CreateObject('Chilkat.JsonObject')
loJsonResp.Load(loResp.BodyStr)
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 loResp
RELEASE loJsonResp