Sample code for 30+ languages & platforms
Unicode C

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

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkJsonObjectW json;
    const wchar_t *url;
    HCkHttpResponseW resp;
    HCkJsonObjectW jsonResp;
    const wchar_t *amount;
    const wchar_t *resptext;
    const wchar_t *acctid;
    const wchar_t *commcard;
    const wchar_t *cvvresp;
    const wchar_t *respcode;
    const wchar_t *batchid;
    const wchar_t *avsresp;
    const wchar_t *entrymode;
    const wchar_t *defaultacct;
    const wchar_t *merchid;
    const wchar_t *token;
    const wchar_t *authcode;
    const wchar_t *respproc;
    const wchar_t *bintype;
    const wchar_t *profileid;
    const wchar_t *retref;
    const wchar_t *respstat;
    const wchar_t *account;

    success = FALSE;

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

    http = CkHttpW_Create();

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

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

    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpStr(http,L"PUT",url,CkJsonObjectW_emit(json),L"utf-8",L"application/json",resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkJsonObjectW_Dispose(json);
        CkHttpResponseW_Dispose(resp);
        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.
    wprintf(L"response status code = %d\n",CkHttpResponseW_getStatusCode(resp));

    jsonResp = CkJsonObjectW_Create();
    CkJsonObjectW_Load(jsonResp,CkHttpResponseW_bodyStr(resp));
    CkJsonObjectW_putEmitCompact(jsonResp,FALSE);

    wprintf(L"response JSON:\n");
    wprintf(L"%s\n",CkJsonObjectW_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 = CkJsonObjectW_stringOf(jsonResp,L"amount");
    resptext = CkJsonObjectW_stringOf(jsonResp,L"resptext");
    acctid = CkJsonObjectW_stringOf(jsonResp,L"acctid");
    commcard = CkJsonObjectW_stringOf(jsonResp,L"commcard");
    cvvresp = CkJsonObjectW_stringOf(jsonResp,L"cvvresp");
    respcode = CkJsonObjectW_stringOf(jsonResp,L"respcode");
    batchid = CkJsonObjectW_stringOf(jsonResp,L"batchid");
    avsresp = CkJsonObjectW_stringOf(jsonResp,L"avsresp");
    entrymode = CkJsonObjectW_stringOf(jsonResp,L"entrymode");
    defaultacct = CkJsonObjectW_stringOf(jsonResp,L"defaultacct");
    merchid = CkJsonObjectW_stringOf(jsonResp,L"merchid");
    token = CkJsonObjectW_stringOf(jsonResp,L"token");
    authcode = CkJsonObjectW_stringOf(jsonResp,L"authcode");
    respproc = CkJsonObjectW_stringOf(jsonResp,L"respproc");
    bintype = CkJsonObjectW_stringOf(jsonResp,L"bintype");
    profileid = CkJsonObjectW_stringOf(jsonResp,L"profileid");
    retref = CkJsonObjectW_stringOf(jsonResp,L"retref");
    respstat = CkJsonObjectW_stringOf(jsonResp,L"respstat");
    account = CkJsonObjectW_stringOf(jsonResp,L"account");


    CkHttpW_Dispose(http);
    CkJsonObjectW_Dispose(json);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(jsonResp);

    }