Lua 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

Lua

local chilkat = require("chilkat")

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

local http = chilkat.Http.new()

http.basic_auth = 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
local json = chilkat.JsonObject.new()
json:update_string("merchid", "MERCHANT_ID")
json:update_string("accttype", "VISA")
json:update_string("orderid", "AB-11-9876")
json:update_string("account", "4111111111111111")
json:update_string("expiry", "1221")
json:update_string("amount", "20")
json:update_string("currency", "USD")
json:update_string("name", "TOM JONES")
json:update_string("address", "123 MAIN STREET")
json:update_string("city", "anytown")
json:update_string("region", "NY")
json:update_string("country", "US")
json:update_string("postal", "55555")
json:update_string("profile", "Y")
json:update_string("ecomind", "E")
json:update_string("cvv2", "123")
json:update_null("track")
json:update_string("capture", "Y")

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

local resp = chilkat.HttpResponse.new()
local success = http:http_str("PUT", url, json:emit(), "utf-8", "application/json", resp)
if not success then
    print(http.last_error_text)
    return
end

-- 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.
print("response status code = " .. resp.status_code)

local jsonResp = chilkat.JsonObject.new()
jsonResp:load(resp.body_str)
jsonResp.emit_compact = false

print("response JSON:")
print(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

local amount = jsonResp:string_of("amount")
local resptext = jsonResp:string_of("resptext")
local acctid = jsonResp:string_of("acctid")
local commcard = jsonResp:string_of("commcard")
local cvvresp = jsonResp:string_of("cvvresp")
local respcode = jsonResp:string_of("respcode")
local batchid = jsonResp:string_of("batchid")
local avsresp = jsonResp:string_of("avsresp")
local entrymode = jsonResp:string_of("entrymode")
local defaultacct = jsonResp:string_of("defaultacct")
local merchid = jsonResp:string_of("merchid")
local token = jsonResp:string_of("token")
local authcode = jsonResp:string_of("authcode")
local respproc = jsonResp:string_of("respproc")
local bintype = jsonResp:string_of("bintype")
local profileid = jsonResp:string_of("profileid")
local retref = jsonResp:string_of("retref")
local respstat = jsonResp:string_of("respstat")
local account = jsonResp:string_of("account")