Sample code for 30+ languages & platforms
Xbase++ 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

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oHttp
LOCAL oJson
LOCAL cUrl
LOCAL oResp
LOCAL oJsonResp
LOCAL cAmount
LOCAL cResptext
LOCAL cAcctid
LOCAL cCommcard
LOCAL cCvvresp
LOCAL cRespcode
LOCAL cBatchid
LOCAL cAvsresp
LOCAL cEntrymode
LOCAL cDefaultacct
LOCAL cMerchid
LOCAL cToken
LOCAL cAuthcode
LOCAL cRespproc
LOCAL cBintype
LOCAL cProfileid
LOCAL cRetref
LOCAL cRespstat
LOCAL cAccount

nSuccess := 0

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

oHttp := CreateObject("Chilkat.Http")

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

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

oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpStr("PUT", cUrl, oJson:Emit(), "utf-8", "application/json", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oHttp:destroy()
    oJson:destroy()
    oResp:destroy()
    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(oResp:StatusCode)

oJsonResp := CreateObject("Chilkat.JsonObject")
oJsonResp:Load(oResp:BodyStr)
oJsonResp:EmitCompact := 0

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

cAmount := oJsonResp:StringOf("amount")
cResptext := oJsonResp:StringOf("resptext")
cAcctid := oJsonResp:StringOf("acctid")
cCommcard := oJsonResp:StringOf("commcard")
cCvvresp := oJsonResp:StringOf("cvvresp")
cRespcode := oJsonResp:StringOf("respcode")
cBatchid := oJsonResp:StringOf("batchid")
cAvsresp := oJsonResp:StringOf("avsresp")
cEntrymode := oJsonResp:StringOf("entrymode")
cDefaultacct := oJsonResp:StringOf("defaultacct")
cMerchid := oJsonResp:StringOf("merchid")
cToken := oJsonResp:StringOf("token")
cAuthcode := oJsonResp:StringOf("authcode")
cRespproc := oJsonResp:StringOf("respproc")
cBintype := oJsonResp:StringOf("bintype")
cProfileid := oJsonResp:StringOf("profileid")
cRetref := oJsonResp:StringOf("retref")
cRespstat := oJsonResp:StringOf("respstat")
cAccount := oJsonResp:StringOf("account")

oHttp:destroy()
oJson:destroy()
oResp:destroy()
oJsonResp:destroy()