(C) CardConnect Authorization

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 C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkHttp.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkJsonObject json;
    const char *url;
    const char *responseStr;
    HCkJsonObject jsonResp;
    const char *amount;
    const char *resptext;
    const char *acctid;
    const char *commcard;
    const char *cvvresp;
    const char *respcode;
    const char *batchid;
    const char *avsresp;
    const char *entrymode;
    const char *defaultacct;
    const char *merchid;
    const char *token;
    const char *authcode;
    const char *respproc;
    const char *bintype;
    const char *profileid;
    const char *retref;
    const char *respstat;
    const char *account;

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

    http = CkHttp_Create();

    CkHttp_putBasicAuth(http,TRUE);
    CkHttp_putLogin(http,"API_USERNAME");
    CkHttp_putPassword(http,"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
    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"merchid","MERCHANT_ID");
    CkJsonObject_UpdateString(json,"accttype","VISA");
    CkJsonObject_UpdateString(json,"orderid","AB-11-9876");
    CkJsonObject_UpdateString(json,"account","4111111111111111");
    CkJsonObject_UpdateString(json,"expiry","1221");
    CkJsonObject_UpdateString(json,"amount","20");
    CkJsonObject_UpdateString(json,"currency","USD");
    CkJsonObject_UpdateString(json,"name","TOM JONES");
    CkJsonObject_UpdateString(json,"address","123 MAIN STREET");
    CkJsonObject_UpdateString(json,"city","anytown");
    CkJsonObject_UpdateString(json,"region","NY");
    CkJsonObject_UpdateString(json,"country","US");
    CkJsonObject_UpdateString(json,"postal","55555");
    CkJsonObject_UpdateString(json,"profile","Y");
    CkJsonObject_UpdateString(json,"ecomind","E");
    CkJsonObject_UpdateString(json,"cvv2","123");
    CkJsonObject_UpdateNull(json,"track");
    CkJsonObject_UpdateString(json,"capture","Y");

    url = "https://<site>.cardconnect.com:<port>/cardconnect/rest/auth";
    responseStr = CkHttp_putText(http,url,CkJsonObject_emit(json),"utf-8","application/json",FALSE,FALSE);

    if (CkHttp_getLastMethodSuccess(http) == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        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.
    printf("response status code = %d\n",CkHttp_getLastStatus(http));

    jsonResp = CkJsonObject_Create();
    CkJsonObject_Load(jsonResp,responseStr);
    CkJsonObject_putEmitCompact(jsonResp,FALSE);

    printf("response JSON:\n");
    printf("%s\n",CkJsonObject_emit(jsonResp));

    // 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

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


    CkHttp_Dispose(http);
    CkJsonObject_Dispose(json);
    CkJsonObject_Dispose(jsonResp);

    }