API Guide

/**
 * Value of TAG 9F06.
 */
private byte[] aid = new byte[16];
/**
 * Length of AID.
 */
private int aidlen;
/**
 * Value of TAG DF37.
 */
private byte[] kernelid= new byte[8];
/**
 * Extend usage
 * <p>
 * 0x00 - default, will no check<br>
 * |0x01 - should be matching transactionType<br>
 * |0x02 - should be matching externString</p>
 */
private int externCheckFlag;
/**
 * Value of TAG 9C.
 */
private byte transactionType;
private byte[]externString = new byte[50];
private int externStrlen;

private byte[] modulus = new byte[248];
private int pkModuluslen;
private byte[] exponent = new byte[3];
private byte[] hash = new byte[20];
private byte[] expiredDate = new byte[4];
private byte[] rid = new byte[5];
private int index;
private byte algorithmIndicator;
private byte hashAlgorithm;
private byte[] rfu = new byte[4];

/**
 * Registered Application Provider Identifier
 */
private byte[] rid = new byte[5];
/**
 * Certification Authority Public Key Index
 */
private int index;
/**
 * Certificate Serial Number
 */
private byte[] əcsn = new byte[3];
/**
 * Reserved for Futrue Use
 */
private byte[] rfu = new byte[3];

/**
 * The Pan 19byte ascii
 */
private byte[] pan = new byte[19];
/**
 * Lenth of PAN
 */
private int panlen;
/**
 * PAN Serial Number. OxFF: ignore
 */
private int panSN;
/**
 * Reserved for Futrue Use
 */
private byte[] rfu = new byte[4];

PerformTransactionListener extends UIEventListener, APDUListener, TransResultListener

CompleteTransactionListener extends UIEventListener, APDUListener, TransResultListener

@Override
public void getPIN(int pinType, int pinTryCnt, publickey pinPK) {
    Log.d(getClass().getName(), String.format("PerfromTransactionListener::getPIN():  %d, %d", pinType, pinTryCnt));
    byte[] pan = mEmvL3Module.getData(EmvL3Const.L3_DATA.PAN);

    if(pinType == EmvL3Const.PINType.PIN_OFFLINE_ENCIPHERED && pinPK == null){
        showMessage("OfflinePin Without publickey");
        mEmvL3Module.responseEvent(ErrorCode.L3_ERR_CANCEL, null);
    }

    ((MainActivity) context).startEnterPin(pinType, new String(pan), pinPK);
}

public void startEnterPin(int Pintype, String pan, publickey pinPK) {
   appendText("Into Enter Pin");
   if(getPinKCV(2) == null){
      appendText("Withput Pin Key,Skip Enter Pin");
      mEmvL3Flow.ResponseEvent(ErrorCode.L3_ERR_SUCC, new byte[]{(byte)0x90,0x00});
      return;
   }
   try {
      NSDKModuleManager moduleManager = NSDKModuleManagerImpl.getInstance();
      DeviceManager deviceManager = (DeviceManager) moduleManager.getModule(ModuleType.DEVICE_MANAGER);
      DeviceInfo deviceInfo = deviceManager.getDeviceInfo();
      String model = deviceInfo.getDeviceModel();
      Log.d(getClass().getName(), "device model : "+model);
      if("X800".equalsIgnoreCase(model)) {
         Intent intent = new Intent(MainActivity.activity, SecondDisplayActivity.class);
         Bundle bundle = new Bundle();
         bundle.putBoolean("isRandomLayout", false);
         bundle.putInt("keyType", KEY_TYPE_DES);
         bundle.putBoolean("isX800", true);
         bundle.putString("moduleItem", "Online PIN");
         bundle.putString("PAN",  new String(pan));
         intent.putExtras(bundle);
         MainActivity.activity.startActivityForResult(intent,MainActivity.REQUEST_DISPLAY_ACTIVITY);
         return;
      }
   } catch (NSDKException e) {
      e.printStackTrace();
   }

   isNeedStart = false;
   Intent intent = new Intent(MainActivity.this, KeyBoardNumberActivity.class);
   intent.putExtra("pinType", Pintype);
   intent.putExtra("pan", pan);
   if(Pintype == EmvL3Const.PINType.PIN_OFFLINE_ENCIPHERED){
      byte[] pk_mod = new byte[pinPK.pk_mod_len];
      System. arraycopy(pinPK.pk_modulus,0,pk_mod,0,pinPK.pk_mod_len);
      intent.putExtra("module", ISOUtils.hexString(pinPK.pk_modulus));
      intent.putExtra("exponent", ISOUtils.hexString(pinPK.pk_exponent));
   }
   startActivityForResult(intent, 1);

}

@Override
public void selectCandidateList(ArrayList<Candidate> arrayList) {
    Log.d(getClass().getName(), "PerfromTransactionListener::selectCandidateList");
    selectCandidate(arrayList);
    // m_EmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, nSelect);
}

/**
 * Show the candidate list for customer to choose
 *
 * @param candidates The candidate list
 * @return Result of UI,ErrorCode.L3_ERR_SUCC for success, ErrorCode.L3_ERR_CANCEL for cancelled
 */
private void selectCandidate(final ArrayList<Candidate> candidates) {
    Log.d(getClass().getName(), " selectCandidate:" + candidates.size());
    String[] items = new String[candidates.size()];
    int index = 0;
    for (Candidate candidate : candidates) {
        String name = null;
        int n = 1;
        if (candidate.getIssuerCodeTableIndex() > 8) {
            n -= 1;
            candidate.setIssuerCodeTableIndex((byte)(candidate.getIssuerCodeTableIndex()-8));
        }

        //boolean supportIsscode = ((candidate.getTerminalCodeTable()[n] & (1L << (candidate.getIssuerCodeTableIndex() - 1))) != 0x00);
        if ( candidate.getPreferName()[0] != 0x00) {
            name = new String(candidate.getPreferName());
        } else {
            if (candidate.getLabel()[0] != 0x00) {
                name = new String(candidate.getLabel());
            } else {
                name = BytesUtils.bytesToHex(candidate.getAID());
            }
        }

        items[index] = name;
        index++;
    }

    selectItems("Select Candidates", items);
}

protected void selectItems(String title, String[] items) {

    ((MainActivity) context).runOnUiThread(new Runnable() {
        @Override
        public void run() {
            selectMenu(title, items);
        }
    });
}

private void selectMenu(String title, String[] items) {

    final byte[] choice = {0};

    AlertDialog.Builder builderDiaLog = new AlertDialog.Builder(context).setIcon(R.mipmap.ic_launcher).setTitle(title)
            .setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    choice[0] = (byte) i;
                }
            }).setPositiveButton("sure", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, choice);
                }
            }).setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_CANCEL, choice);
                }
            });
    builderDiaLog.create().show();
}

@Override
public void selectAccount() {
	Log.d(getClass().getName(), "PerfromTransactionListener::selectAccount()");
	String[] items = new String[4];
	items[0] = "Default";
	items[1] = "Savings";
	items[2] = "Cheque/debit";
	items[3] = "Credit";

	selectItems("Select Account", items);
//  m_EmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, null);
}
protected void selectItems(String title, String[] items) {

    ((MainActivity) context).runOnUiThread(new Runnable() {
        @Override
        public void run() {
            selectMenu(title, items);
        }
    });
}

private void selectMenu(String title, String[] items) {

    final byte[] choice = {0};

    AlertDialog.Builder builderDiaLog = new AlertDialog.Builder(context).setIcon(R.mipmap.ic_launcher).setTitle(title)
            .setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    choice[0] = (byte) i;
                }
            }).setPositiveButton("sure", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, choice);
                }
            }).setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_CANCEL, choice);
                }
            });
    builderDiaLog.create().show();
}

@Override
public void selectLanguage(byte[] languageNo) {
    Log.d(getClass().getName(), "PerfromTransactionListener::selectLanguage()");
    if (languageNo == null) {
        mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, null);
        return;
    }

    String[] items = new String[2];
    items[0] = "Chinese";
    items[1] = "English";

    selectItems("Select Language", items);

}

protected void selectItems(String title, String[] items) {

    ((MainActivity) context).runOnUiThread(new Runnable() {
        @Override
        public void run() {
            selectMenu(title, items);
        }
    });
}

private void selectMenu(String title, String[] items) {

    final byte[] choice = {0};

    AlertDialog.Builder builderDiaLog = new AlertDialog.Builder(context).setIcon(R.mipmap.ic_launcher).setTitle(title)
            .setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    choice[0] = (byte) i;
                }
            }).setPositiveButton("sure", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, choice);
                }
            }).setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_CANCEL, choice);
                }
            });
    builderDiaLog.create().show();
}

@Override
public void checkCredentials(byte type, byte[] number) {
    com.nlutils.util.LoggerUtils.e(" checkCredentials:");
    String credentTials;
    switch (type) {
        case 0:
            credentTials = "ID CARD:" + BytesUtils.bytesToBinaryString(number);
            break;
        case 1:
            credentTials = "OFFICER:" + BytesUtils.bytesToBinaryString(number);
            break;
        case 2:
            credentTials = "PASSPORT:" + BytesUtils.bytesToBinaryString(number);
            break;
        case 3:
            credentTials = "ENTRY CARD:" + BytesUtils.bytesToBinaryString(number);
            break;
        case 4:
            credentTials = "TEMP IDCARD:" + BytesUtils.bytesToBinaryString(number);
            break;
        default:
            credentTials = "OTHER:" + BytesUtils.bytesToBinaryString(number);
            break;
    }
    userConfirm("CheckCredenTials", credentTials);
}

protected void userConfirm(String title, String cardNum) {

    ((MainActivity) context).runOnUiThread(new Runnable() {
        @Override
        public void run() {
            confirm(title, cardNum);
        }
    });
}

private void confirm(String title, String cardNum) {

    AlertDialog.Builder builderDiaLog = new AlertDialog.Builder(context).setIcon(R.mipmap.ic_launcher).setTitle(title)
            .setMessage(cardNum).setPositiveButton("sure", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, null);
                }
            }).setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                @Override
                public void onClick(DialogInterface dialogInterface, int i) {
                    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_CANCEL, null);
                }
            });
    builderDiaLog.create().show();
}

@Override
public void transResult(int result, int errcode) {
    Log.d(getClass().getName(), String.format("PerfromTransactionListener::transResult():  %d, %d ", result, errcode));
    Log.d(getClass().getName(), mEmvL3Module.errorMessage(errcode));
    /**
     * Handle transaction result
     */
    switch (result) {
        case EmvL3Const.TransResult.L3_TXN_APPROVED:
            getKernelData(false);
            showToast("approve offline");
            endTransaction();
            break;
        case EmvL3Const.TransResult.L3_TXN_DECLINE:
            showToast("declined offline");
            getKernelData(false);
            endTransaction();
            break;
        case EmvL3Const.TransResult.L3_TXN_ONLINE:
            getKernelData(false);
            goOnline();
            break;
        default:
            if (result == EmvL3Const.TransResult.L3_TXN_TRY_ANOTHER) {
                showMessage("Try Another Interface");
            } else if (errcode == ErrorCode.L3_ERR_TIMEOUT) {
                showMessage("User Timeout");
            } else if (errcode == ErrorCode.L3_ERR_CANCEL || errcode == ErrorCode.EMV_ERR_CANCEL) {
                showMessage("Transaction Cancelled");
            } else {
                showMessage("Transaction Aborted");
            }
            getKernelData(true);
            showToast("transaction terminate");
            endTransaction();
            break;
    }
}

@Override
public void transResult(int result, int errcode) {
    Log.d(getClass().getName(), String.format("CompleteTransactionListener::transResult():  %d, %d ", result, errcode));
    Log.d(getClass().getName(), mEmvL3Module.errorMessage(errcode));
    /**
     * Handle transaction result
     */
    switch (result) {
        case EmvL3Const.TransResult.L3_TXN_APPROVED:
            getKernelData(false);
            showToast("approve online");
            endTransaction();
            break;
        case EmvL3Const.TransResult.L3_TXN_DECLINE:
            getKernelData(false);
            showToast("decline online");
            endTransaction();
            break;
        default:
            getKernelData(true);
            if (result == EmvL3Const.TransResult.L3_TXN_TRY_ANOTHER) {
                showMessage("Try Another Interface");
            } else if (errcode == ErrorCode.L3_ERR_TIMEOUT) {
                showMessage("User Timeout");
            } else if (errcode == ErrorCode.L3_ERR_CANCEL || errcode == ErrorCode.EMV_ERR_CANCEL) {
                showMessage("Transaction Cancelled");
            } else {
                showMessage("Transaction Aborted");
            }
            showToast("Transaction terminate");
            endTransaction();
            break;

    }
}

@Override
public void transResult(int result, int errcode) {
    Log.d(getClass().getName(), String.format("PerfromTransactionListener::transResult():  %d, %d ", result, errcode));
    Log.d(getClass().getName(), mEmvL3Module.errorMessage(errcode));
    /**
     * Handle transaction result
     */
    switch (result) {
        case EmvL3Const.TransResult.L3_TXN_APPROVED:
            getKernelData(false);
            showToast("approve offline");
            endTransaction();
            break;
        case EmvL3Const.TransResult.L3_TXN_DECLINE:
            showToast("declined offline");
            getKernelData(false);
            endTransaction();
            break;
        case EmvL3Const.TransResult.L3_TXN_ONLINE:
            getKernelData(false);
            goOnline();
            break;
        default:
            if (result == EmvL3Const.TransResult.L3_TXN_TRY_ANOTHER) {
                showMessage("Try Another Interface");
            } else if (errcode == ErrorCode.L3_ERR_TIMEOUT) {
                showMessage("User Timeout");
            } else if (errcode == ErrorCode.L3_ERR_CANCEL || errcode == ErrorCode.EMV_ERR_CANCEL) {
                showMessage("Transaction Cancelled");
            } else {
                showMessage("Transaction Aborted");
            }
            getKernelData(true);
            showToast("transaction terminate");
            endTransaction();
            break;
    }
}

@Override
public void uiEvent(int i, byte[] bytes) {
    processUIEvent(i, bytes);
    mEmvL3Module.responseEvent(ErrorCode.L3_ERR_SUCC, null);
}

private void processUIEvent(int uiEvent, byte[] uiEventData) {
    Log.d(getClass().getName(), "ProcessUIEvent() called");

    switch (uiEvent) {
        /**
         * Prompt the customer to tap or insert or swipe the card.
         * The ui event data will be used to distinguish the type .
         */
        case EmvL3Const.UIEvent.UI_PRESENT_CARD:
            //Present card again.
            if (uiEventData[0] == EmvL3Const.UICard.UI_PRESENTCARD_AGAIN) {
                showMessage("PRESENT CARD AGAIN");
                break;
            }

            //Contact card fallback,prompting customer to swipe card
            if (uiEventData[0] == EmvL3Const.UICard.UI_FALLBACK_CT) {
                showMessage("CONTACT FALLBACK");
                break;
            }

            //Contactless card fallback,prompting customer to insert or swipe card
            if (uiEventData[0] == EmvL3Const.UICard.UI_FALLBACK_CLSS) {
                showMessage("CONTACTLESS FALLBACK");
                break;
            }

            //Swiped card which has chip,need to insert the card
            if (uiEventData[0] == EmvL3Const.UICard.UI_USE_CHIP) {
                showMessage("PLS USE CHIP");
                break;
            }

            //To show the current card interface type, like EmvL3Const.UICard.UI_STRIPE{@}
            if (uiEventData[0] != EmvL3Const.UICard.UI_KEYIN) {
                showMessage("TAP/INSERT/SWIP");
                break;
            }
            break;
        case EmvL3Const.UIEvent.UI_SEE_PHONE:
            // You can show that See Phone for Instructions
            showMessage("PLS SEE PHONE FOR STRUCTION");
            break;
        case EmvL3Const.UIEvent.UI_CHIP_ERR_RETRY:
            //The chip is error or card is reverse inserted
            showMessage("CHIP ERR ,PLS RETRY");
            break;
        case EmvL3Const.UIEvent.UI_PROCESSING:
            showMessage("Processing...");
            break;
        case EmvL3Const.UIEvent.UI_PIN_STATUS:
            showMessage("PIN STATUS");
            break;
    }
}