(Android™) Payeezy Place Temp Authorization Hold on Buyer’s Credit Card

Demonstrates how to place a temporary authorization hold for the desired amount on the buyer’s credit card. You can Capture the authorized amount on completion of service or Void/Refund the transaction as required.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

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

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

    CkCrypt2 crypt = new CkCrypt2();
    CkPrng prng = new CkPrng();
    boolean success;

    // An API key such as y6pWAJNyJyjGv66IsVuWnklkKUPFbb0a
    String apiKey = "my_api_key";
    // An API secret such as 86fbae7030253af3cd15faef2a1f4b67353e41fb6799f576b5093ae52901e6f7
    String apiSecret = "my_api_secret";
    // A token such as fdoa-a480ce8951daa73262734cf102641994c1e55e7cdf4c02b6
    String token = "my_merchant_token";

    // The nonce is a random number (bytes), something like "6057786719490086000"
    String nonce = prng.genRandom(8,"decimal");
    Log.i(TAG, "nonce = " + nonce);

    CkDateTime dtNow = new CkDateTime();
    dtNow.SetFromCurrentSystemTime();
    CkStringBuilder sbTimestamp = new CkStringBuilder();
    // Get the epoch timestamp in seconds
    sbTimestamp.Append(dtNow.getAsUnixTimeStr(false));
    // Change it to milliseconds
    sbTimestamp.Append("000");
    // The timestamp is a number similar to this: 1546011905000 (which is a timestamp taken on 28-Dec-2018).
    String timestamp = sbTimestamp.getAsString();
    Log.i(TAG, "timestamp = " + timestamp);

    // Generate the following JSON request body:
    // {
    //   "merchant_ref": "Astonishing-Sale",
    //   "transaction_type": "authorize",
    //   "method": "credit_card",
    //   "amount": "1299",
    //   "currency_code": "USD",
    //   "credit_card": {
    //     "type": "visa",
    //     "cardholder_name": "John Smith",
    //     "card_number": "4788250000028291",
    //     "exp_date": "1020",
    //     "cvv": "123"
    //   }
    // }

    CkJsonObject json = new CkJsonObject();
    json.UpdateString("merchant_ref","Astonishing-Sale");
    json.UpdateString("transaction_type","authorize");
    json.UpdateString("method","credit_card");
    json.UpdateString("amount","1299");
    json.UpdateString("currency_code","USD");
    json.UpdateString("credit_card.type","visa");
    json.UpdateString("credit_card.cardholder_name","John Smith");
    json.UpdateString("credit_card.card_number","4788250000028291");
    json.UpdateString("credit_card.exp_date","1020");
    json.UpdateString("credit_card.cvv","123");
    json.put_EmitCompact(false);
    Log.i(TAG, json.emit());

    // string hashData = apiKey + nonce + timestamp + token + jsonString;
    CkStringBuilder sbHmacData = new CkStringBuilder();
    sbHmacData.Append(apiKey);
    sbHmacData.Append(nonce);
    sbHmacData.Append(timestamp);
    sbHmacData.Append(token);
    sbHmacData.Append(json.emit());

    // HMAC the data to produce a hex string.
    crypt.put_EncodingMode("hexlower");
    crypt.put_MacAlgorithm("hmac");
    crypt.SetMacKeyString(apiSecret);
    crypt.put_HashAlgorithm("sha256");
    crypt.put_Charset("utf-8");
    String hexHash = crypt.macStringENC(sbHmacData.getAsString());
    Log.i(TAG, "hexHash = " + hexHash);

    // Now base64 encode the hex string:
    CkStringBuilder sbBase64Hash = new CkStringBuilder();
    sbBase64Hash.Append(hexHash);
    sbBase64Hash.Encode("base64","utf-8");

    Log.i(TAG, "This is the Authorization header to be sent with the payeezy request:");
    Log.i(TAG, "Authorization: " + sbBase64Hash.getAsString());

    // -----------------------------------------------------------
    // Now that we have the value for the Authorization header, send the POST containing the JSON.

    CkHttp http = new CkHttp();

    http.put_Accept("*/*");
    http.put_UserAgent("");
    http.SetRequestHeader("Authorization",sbBase64Hash.getAsString());
    http.SetRequestHeader("apikey",apiKey);
    http.SetRequestHeader("nonce",nonce);
    http.SetRequestHeader("timestamp",timestamp);
    http.SetRequestHeader("token",token);

    http.put_SessionLogFilename("qa_output/payeezy.txt");

    String url = "https://api-cert.payeezy.com/v1/transactions";
    CkHttpResponse resp = http.PostJson2(url,"application/json",json.emit());
    if (http.get_LastMethodSuccess() != true) {
        Log.i(TAG, http.lastErrorText());
        return;
        }

    Log.i(TAG, "response status code = " + String.valueOf(resp.get_StatusCode()));
    json.Load(resp.bodyStr());
    Log.i(TAG, json.emit());

    // Sample JSON response:

    // {
    //   "correlation_id": "228.4604632998994",
    //   "transaction_status": "approved",
    //   "validation_status": "success",
    //   "transaction_type": "authorize",
    //   "transaction_id": "ET175628",
    //   "transaction_tag": "2313721985",
    //   "method": "credit_card",
    //   "amount": "1299",
    //   "currency": "USD",
    //   "cvv2": "M",
    //   "token": {
    //     "token_type": "FDToken",
    //     "token_data": {
    //       "value": "9732261336638291"
    //     }
    //   },
    //   "card": {
    //     "type": "visa",
    //     "cardholder_name": "John Smith",
    //     "card_number": "8291",
    //     "exp_date": "1020"
    //   },
    //   "bank_resp_code": "100",
    //   "bank_message": "Approved",
    //   "gateway_resp_code": "00",
    //   "gateway_message": "Transaction Normal"
    // }
    // 

    Log.i(TAG, json.stringOf("correlation_id"));
    Log.i(TAG, json.stringOf("transaction_status"));
    Log.i(TAG, json.stringOf("validation_status"));
    Log.i(TAG, json.stringOf("transaction_type"));
    Log.i(TAG, json.stringOf("transaction_id"));
    Log.i(TAG, json.stringOf("transaction_tag"));
    Log.i(TAG, json.stringOf("method"));
    Log.i(TAG, json.stringOf("amount"));
    Log.i(TAG, json.stringOf("currency"));
    Log.i(TAG, json.stringOf("cvv2"));
    Log.i(TAG, json.stringOf("token.token_type"));
    Log.i(TAG, json.stringOf("token.token_data.value"));
    Log.i(TAG, json.stringOf("card.type"));
    Log.i(TAG, json.stringOf("card.cardholder_name"));
    Log.i(TAG, json.stringOf("card.card_number"));
    Log.i(TAG, json.stringOf("card.exp_date"));
    Log.i(TAG, json.stringOf("bank_resp_code"));
    Log.i(TAG, json.stringOf("bank_message"));
    Log.i(TAG, json.stringOf("gateway_resp_code"));
    Log.i(TAG, json.stringOf("gateway_message"));

  }

  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."
  }
}