(Tcl) CardConnect Void

Demonstrates how to send a CardConnect void request.

The void service cancels a transaction that is in either "Authorized" or "Queued for Capture" status.. ...

See https://developer.cardconnect.com/cardconnect-api#void

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set success 0

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

set http [new_CkHttp]

CkHttp_put_BasicAuth $http 1
CkHttp_put_Login $http "API_USERNAME"
CkHttp_put_Password $http "API_PASSWORD"

# Build and send the following JSON:

# The "retref" is the value returned in the JSON response for the Authorization request.

# {
#     "retref":"112989260941",
#     "merchid":"MERCHANT_ID"
# }

set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "retref" "112989260941"
CkJsonObject_UpdateString $json "merchid" "MERCHANT_ID"

set url "https://<site>.cardconnect.com:<port>/cardconnect/rest/void"

set resp [new_CkHttpResponse]

set success [CkHttp_HttpStr $http "PUT" $url [CkJsonObject_emit $json] "utf-8" "application/json" $resp]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $json
    delete_CkHttpResponse $resp
    exit
}

# 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.
puts "response status code = [CkHttpResponse_get_StatusCode $resp]"

set jsonResp [new_CkJsonObject]

CkJsonObject_Load $jsonResp [CkHttpResponse_bodyStr $resp]
CkJsonObject_put_EmitCompact $jsonResp 0

puts "response JSON:"
puts [CkJsonObject_emit $jsonResp]

# A successful response looks like this:

# {
#   "authcode": "REVERS",
#   "respproc": "FNOR",
#   "amount": "0.00",
#   "resptext": "Approval",
#   "currency": "USD",
#   "retref": "112989260941",
#   "respstat": "A",
#   "respcode": "00",
#   "merchid": "496160873888"
# }

# Use this online tool to generate parsing code from sample JSON: 
# Generate Parsing Code from JSON

set authcode [CkJsonObject_stringOf $jsonResp "authcode"]
set respproc [CkJsonObject_stringOf $jsonResp "respproc"]
set amount [CkJsonObject_stringOf $jsonResp "amount"]
set resptext [CkJsonObject_stringOf $jsonResp "resptext"]
set currency [CkJsonObject_stringOf $jsonResp "currency"]
set retref [CkJsonObject_stringOf $jsonResp "retref"]
set respstat [CkJsonObject_stringOf $jsonResp "respstat"]
set respcode [CkJsonObject_stringOf $jsonResp "respcode"]
set merchid [CkJsonObject_stringOf $jsonResp "merchid"]

delete_CkHttp $http
delete_CkJsonObject $json
delete_CkHttpResponse $resp
delete_CkJsonObject $jsonResp