B4X 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

B4X

Dim success As Boolean = False

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

Dim http As ChilkatHttp
http.Initialize("http")

http.BasicAuth = True
http.Login = "API_USERNAME"
http.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
Dim json As ChilkatJsonObject
json.Initialize
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")

Dim url As String = "https://<site>.cardconnect.com:<port>/cardconnect/rest/auth"

Dim resp As ChilkatHttpResponse
resp.Initialize
success = http.HttpStr("PUT", url, json.Emit, "utf-8", "application/json", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If


'  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.
Log("response status code = " & resp.StatusCode)

Dim jsonResp As ChilkatJsonObject
jsonResp.Initialize
jsonResp.Load(resp.BodyStr)
jsonResp.EmitCompact = False

Log("response JSON:")
Log(jsonResp.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

Dim amount As String = jsonResp.StringOf("amount")
Dim resptext As String = jsonResp.StringOf("resptext")
Dim acctid As String = jsonResp.StringOf("acctid")
Dim commcard As String = jsonResp.StringOf("commcard")
Dim cvvresp As String = jsonResp.StringOf("cvvresp")
Dim respcode As String = jsonResp.StringOf("respcode")
Dim batchid As String = jsonResp.StringOf("batchid")
Dim avsresp As String = jsonResp.StringOf("avsresp")
Dim entrymode As String = jsonResp.StringOf("entrymode")
Dim defaultacct As String = jsonResp.StringOf("defaultacct")
Dim merchid As String = jsonResp.StringOf("merchid")
Dim token As String = jsonResp.StringOf("token")
Dim authcode As String = jsonResp.StringOf("authcode")
Dim respproc As String = jsonResp.StringOf("respproc")
Dim bintype As String = jsonResp.StringOf("bintype")
Dim profileid As String = jsonResp.StringOf("profileid")
Dim retref As String = jsonResp.StringOf("retref")
Dim respstat As String = jsonResp.StringOf("respstat")
Dim account As String = jsonResp.StringOf("account")