Swift

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

Swift

func chilkatTest() {
    var success: Bool = false

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

    let http = CkoHttp()!

    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
    let json = CkoJsonObject()!
    json.updateString(jsonPath: "merchid", value: "MERCHANT_ID")
    json.updateString(jsonPath: "accttype", value: "VISA")
    json.updateString(jsonPath: "orderid", value: "AB-11-9876")
    json.updateString(jsonPath: "account", value: "4111111111111111")
    json.updateString(jsonPath: "expiry", value: "1221")
    json.updateString(jsonPath: "amount", value: "20")
    json.updateString(jsonPath: "currency", value: "USD")
    json.updateString(jsonPath: "name", value: "TOM JONES")
    json.updateString(jsonPath: "address", value: "123 MAIN STREET")
    json.updateString(jsonPath: "city", value: "anytown")
    json.updateString(jsonPath: "region", value: "NY")
    json.updateString(jsonPath: "country", value: "US")
    json.updateString(jsonPath: "postal", value: "55555")
    json.updateString(jsonPath: "profile", value: "Y")
    json.updateString(jsonPath: "ecomind", value: "E")
    json.updateString(jsonPath: "cvv2", value: "123")
    json.updateNull(jsonPath: "track")
    json.updateString(jsonPath: "capture", value: "Y")

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

    let resp = CkoHttpResponse()!
    success = http.httpStr(verb: "PUT", url: url, bodyStr: json.emit(), charset: "utf-8", contentType: "application/json", response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        return
    }

    // 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.statusCode.intValue)")

    let jsonResp = CkoJsonObject()!
    jsonResp.load(json: resp.bodyStr)
    jsonResp.emitCompact = 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

    var amount: String? = jsonResp.string(of: "amount")
    var resptext: String? = jsonResp.string(of: "resptext")
    var acctid: String? = jsonResp.string(of: "acctid")
    var commcard: String? = jsonResp.string(of: "commcard")
    var cvvresp: String? = jsonResp.string(of: "cvvresp")
    var respcode: String? = jsonResp.string(of: "respcode")
    var batchid: String? = jsonResp.string(of: "batchid")
    var avsresp: String? = jsonResp.string(of: "avsresp")
    var entrymode: String? = jsonResp.string(of: "entrymode")
    var defaultacct: String? = jsonResp.string(of: "defaultacct")
    var merchid: String? = jsonResp.string(of: "merchid")
    var token: String? = jsonResp.string(of: "token")
    var authcode: String? = jsonResp.string(of: "authcode")
    var respproc: String? = jsonResp.string(of: "respproc")
    var bintype: String? = jsonResp.string(of: "bintype")
    var profileid: String? = jsonResp.string(of: "profileid")
    var retref: String? = jsonResp.string(of: "retref")
    var respstat: String? = jsonResp.string(of: "respstat")
    var account: String? = jsonResp.string(of: "account")

}