Android™

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

Android™

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

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

    CkHttp http = new CkHttp();

    http.put_BasicAuth(true);
    http.put_Login("API_USERNAME");
    http.put_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
    CkJsonObject json = new CkJsonObject();
    json.UpdateString("merchid","MERCHANT_ID");
    json.UpdateString("accttype","VISA");
    json.UpdateString("orderid","AB-11-9876");
    json.UpdateString("account","4111111111111111");
    json.UpdateString("expiry","1221");
    json.UpdateString("amount","20");
    json.UpdateString("currency","USD");
    json.UpdateString("name","TOM JONES");
    json.UpdateString("address","123 MAIN STREET");
    json.UpdateString("city","anytown");
    json.UpdateString("region","NY");
    json.UpdateString("country","US");
    json.UpdateString("postal","55555");
    json.UpdateString("profile","Y");
    json.UpdateString("ecomind","E");
    json.UpdateString("cvv2","123");
    json.UpdateNull("track");
    json.UpdateString("capture","Y");

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

    CkHttpResponse resp = new CkHttpResponse();
    success = http.HttpStr("PUT",url,json.emit(),"utf-8","application/json",resp);
    if (success == false) {
        Log.i(TAG, 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.
    Log.i(TAG, "response status code = " + String.valueOf(resp.get_StatusCode()));

    CkJsonObject jsonResp = new CkJsonObject();
    jsonResp.Load(resp.bodyStr());
    jsonResp.put_EmitCompact(false);

    Log.i(TAG, "response JSON:");
    Log.i(TAG, 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

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

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}