@urovotest/urovosdk-docs-mcp 1.0.1

package/docs/02-reference/general/pinpad.md

@@ -0,0 +1,3309 @@
+---
+title: Pinpad API
+module: Pinpad
+domain: general
+tags: ["general", "pinpad", "pinpad"]
+---
+# Pinpad
+
+共 **37** 个 API/条目，来源 `general_sdk.md`。
+
+## API 索引
+
+| 方法 | 类路径 | Demo Activity |
+|------|--------|---------------|
+| [isKeyExist](#iskeyexist) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [loadTEK](#loadtek) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [loadEncryptMainKey](#loadencryptmainkey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [loadMainKey](#loadmainkey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [loadWorkKey](#loadworkkey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [calcMAC](#calcmac) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [calculateDes](#calculatedes) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [downloadKeyDukpt](#downloadkeydukpt) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [calculateMACOfDUKPTExtend](#calculatemacofdukptextend) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [encryptWithPEK(Deprecated)](#encryptwithpek-deprecated) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getDukptPinBlock](#getdukptpinblock) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getPinBlockEx](#getpinblockex) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getRSAPublicKeyModel](#getrsapublickeymodel) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [loadDukptBlob](#loaddukptblob) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptGetKsn](#dukptgetksn) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DiversifiedKey](#diversifiedkey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [genKeyHashValue](#genkeyhashvalue) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [EndPinInputEvent](#endpininputevent) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptEncrytDataIV](#dukptencrytdataiv) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [deleteKey(MK/SK)](#deletekey-mk-sk) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [setKeyAlgorithm](#setkeyalgorithm) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptAesInitial](#dukptaesinitial) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptAesGetKsn](#dukptaesgetksn) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptAesUpdateKsn](#dukptaesupdateksn) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptAesEncryptDataIV](#dukptaesencryptdataiv) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [GetDukptAesPinBlock](#getdukptaespinblock) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getOfflinePinBlcok](#getofflinepinblcok) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [downloadKeyTR31](#downloadkeytr31) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptInitialTr31](#dukptinitialtr31) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [DukptAesInitialTr31](#dukptaesinitialtr31) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [generateRSAKey](#generatersakey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [readRSAPublicKey](#readrsapublickey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [calculateWithRSAPrivateKey](#calculatewithrsaprivatekey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [calculateWithRSAPublicKey](#calculatewithrsapublickey) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [isDukptKeyExist](#isdukptkeyexist) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getLastErrorCode](#getlasterrorcode) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+| [getLastErrorMsg](#getlasterrormsg) | `com.urovo.sdk.pinpad.PinPadProviderImpl` | PinpadActivity, PinpadUtil |
+
+## isKeyExist
+
+Determine is key exist
+
+```java
+boolean isKeyExist(int keyType, int keyId)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.1
+
+- Source section: `3.1`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Determine is key exist
+
+
+Signature/prototype:
+```java
+boolean isKeyExist(int keyType, int keyId)
+```
+
+
+Parameters:
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+
+Load the index of the key store
+Output
+None
+
+
+Return value:
+Existence returns true, otherwise it returns false.
+
+
+Simplified example:
+```java
+boolean exists = PinPadProviderImpl.getInstance().isKeyExist(Constant.KeyType.PIN_KEY, 1);
+```
+
+
+Source details:
+```text
+Prototype
+boolean isKeyExist(int keyType, int keyId)
+Description
+Determine is key exist
+Parameters
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+
+Load the index of the key store
+Output
+None
+Return
+Existence returns true, otherwise it returns false.
+Remark
+```
+
+## loadTEK
+
+Load TEK, and TEK is the key for encrypting main key.
+
+```java
+boolean loadTEK(int keyId, byte[] key, byte[] checkValue)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.2
+
+- Source section: `3.2`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load TEK, and TEK is the key for encrypting main key.
+
+
+Signature/prototype:
+```java
+boolean loadTEK(int keyId, byte[] key, byte[] checkValue)
+```
+
+
+Parameters:
+Input
+keyId - TEKKey storage index
+
+key - Load key
+
+checkValue - Check value KCV is allowed to be null (3DES encryption 4 bytes all 00, take the first 4 bytes)
+Output
+None
+
+
+Return value:
+Load successfully returns true, otherwise returns false.
+
+
+Source details:
+```text
+Prototype
+boolean loadTEK(int keyId, byte[] key, byte[] checkValue)
+Description
+Load TEK, and TEK is the key for encrypting main key.
+Parameters
+Input
+keyId - TEKKey storage index
+
+key - Load key
+
+checkValue - Check value KCV is allowed to be null (3DES encryption 4 bytes all 00, take the first 4 bytes)
+Output
+None
+Return
+Load successfully returns true, otherwise returns false.
+Remark
+```
+
+## loadEncryptMainKey
+
+Load Encrypt main key, encrypted by TEK.
+
+tekkId - the index of TEK.
+
+```java
+boolean loadEncryptMainKey(int tekId, int keyId, byte[] key, byte[] check Value)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.3
+
+- Source section: `3.3`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load Encrypt main key, encrypted by TEK.
+
+tekkId - the index of TEK.
+
+
+Signature/prototype:
+```java
+boolean loadEncryptMainKey(int tekId, int keyId, byte[] key, byte[] check Value)
+```
+
+
+Parameters:
+Input
+keyId - load the index of the key store.
+
+key - load key
+
+checkValue - Check value KCV
+Output
+None
+
+
+Return value:
+Load successfully returns true, otherwise returns false.
+
+
+Usage notes:
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV
+
+
+Source details:
+```text
+Prototype
+boolean loadEncryptMainKey(int tekId, int keyId, byte[] key, byte[] check Value)
+Description
+Load Encrypt main key, encrypted by TEK.
+
+tekkId - the index of TEK.
+Parameters
+Input
+keyId - load the index of the key store.
+
+key - load key
+
+checkValue - Check value KCV
+Output
+None
+Return
+Load successfully returns true, otherwise returns false.
+Remark
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV
+```
+
+## loadMainKey
+
+Load main key
+
+```java
+boolean loadMainKey(int keyId, byte[] key, byte[] checkValue)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.4
+
+- Source section: `3.4`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load main key
+
+
+Signature/prototype:
+```java
+boolean loadMainKey(int keyId, byte[] key, byte[] checkValue)
+```
+
+
+Parameters:
+Input
+keyId - load the index of the key store
+key - load key
+checkValue - Check value KCV
+Output
+None
+
+
+Return value:
+Load successfully returns true, otherwise returns false.
+
+
+Usage notes:
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV
+
+
+Simplified example:
+```java
+byte[] key = BytesUtil.hexString2Bytes("11111111111111111111111111111111");
+boolean ok = PinPadProviderImpl.getInstance().loadMainKey(0, key, null);
+```
+
+
+Source details:
+```text
+Prototype
+boolean loadMainKey(int keyId, byte[] key, byte[] checkValue)
+Description
+Load main key
+Parameters
+Input
+keyId - load the index of the key store
+key - load key
+checkValue - Check value KCV
+Output
+None
+Return
+Load successfully returns true, otherwise returns false.
+Remark
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV
+```
+
+## loadWorkKey
+
+Load work key, including PIN key, MAC key, and track encryption key
+
+```java
+boolean loadWorkKey(int keyType, int mkId, int wkId,
+byte[] key, byte[] checkValue)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.5
+
+- Source section: `3.5`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load work key, including PIN key, MAC key, and track encryption key
+
+
+Signature/prototype:
+```java
+boolean loadWorkKey(int keyType, int mkId, int wkId,
+byte[] key, byte[] checkValue)
+```
+
+
+Parameters:
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+mkId - the index of main key
+wkId - the index of load work key store
+Key - key data
+checkValue - Check value KCV
+Output
+None
+
+
+Return value:
+Load successfully returns true, otherwise returns false.
+
+
+Usage notes:
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV.
+
+
+Simplified example:
+```java
+boolean ok = pinpad.loadWorkKey(Constant.KeyType.PIN_KEY, 0, 1, encryptedPinKey, null);
+```
+
+
+Source details:
+```text
+Prototype
+boolean loadWorkKey(int keyType, int mkId, int wkId,
+byte[] key, byte[] checkValue)
+Description
+Load work key, including PIN key, MAC key, and track encryption key
+Parameters
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+mkId - the index of main key
+wkId - the index of load work key store
+Key - key data
+checkValue - Check value KCV
+Output
+None
+Return
+Load successfully returns true, otherwise returns false.
+Remark
+If the key Encrypt data is the IC key [KEY(16Byte)] structure, check Value is null.
+If the Key data is an integer multiple of 4, check Value is 4 bytes KCV.
+```
+
+## calcMAC
+
+Calculating MAC
+
+```java
+byte[] calcMAC(int keyId, byte[] data, int mode)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.6
+
+- Source section: `3.6`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculating MAC
+
+
+Signature/prototype:
+```java
+byte[] calcMAC(int keyId, byte[] data, int mode)
+```
+
+
+Parameters:
+Input
+keyId - MAC Key index
+data - the data to be calculated
+mode - MAC algorithm:
+0x00: XOR.
+0x01: ANSI 9.9.
+0x02: ECB.
+0x11: ANSI 9.19.
+0x10: POS_ECB.
+0x07: CMAC.
+Output
+None
+
+
+Return value:
+macResult:0x01&0x11:BCD format,0x10:ASCII format.
+
+
+Simplified example:
+```java
+byte[] mac = PinPadProviderImpl.getInstance().calcMAC(1, data, 0x11);
+```
+
+
+Source details:
+```text
+Prototype
+byte[] calcMAC(int keyId, byte[] data, int mode)
+Description
+Calculating MAC
+Parameters
+Input
+keyId - MAC Key index
+data - the data to be calculated
+mode - MAC algorithm:
+0x00: XOR.
+0x01: ANSI 9.9.
+0x02: ECB.
+0x11: ANSI 9.19.
+0x10: POS_ECB.
+0x07: CMAC.
+Output
+None
+Return
+macResult:0x01&0x11:BCD format,0x10:ASCII format.
+Remark
+```
+
+## calculateDes
+
+Encrypt Track Data
+
+```java
+int calculateDes(int desMode, int algorithm, int keyType,int keyId, byte[] data, byte[] dataOut)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.7
+
+- Source section: `3.7`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Encrypt Track Data
+
+
+Signature/prototype:
+```java
+int calculateDes(int desMode, int algorithm, int keyType,int keyId, byte[] data, byte[] dataOut)
+```
+
+
+Parameters:
+Input
+desMode - encryption mode, 0: ENC , 1: DEC.
+Refer to com.urovo.sdk.pinpad.utils.Constant.DesMode.
+algorithm - 1:DES ECB; 2:DES CBC; 3:SM4; 7:AES ECB; 8:AES CBC.
+Refer to com.urovo.sdk.pinpad.utils Constant.Algorithm.
+keyType - the key type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType
+keyId - the key index
+data - source data
+Output
+dataOut - des result out
+
+
+Return value:
+0:success, others:failed.
+
+
+Source details:
+```text
+Prototype
+int calculateDes(int desMode, int algorithm, int keyType,int keyId, byte[] data, byte[] dataOut)
+Description
+Encrypt Track Data
+Parameters
+Input
+desMode - encryption mode, 0: ENC , 1: DEC.
+Refer to com.urovo.sdk.pinpad.utils.Constant.DesMode.
+algorithm - 1:DES ECB; 2:DES CBC; 3:SM4; 7:AES ECB; 8:AES CBC.
+Refer to com.urovo.sdk.pinpad.utils Constant.Algorithm.
+keyType - the key type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType
+keyId - the key index
+data - source data
+Output
+dataOut - des result out
+Return
+0:success, others:failed.
+Remark
+```
+
+## downloadKeyDukpt
+
+downloadKeyDukpt
+
+```java
+int downloadKeyDukpt(int keyIndex, in byte[] Bdk, int BdkLen, in byte[] Ksn, int KsnLen, in byte[] bsIpek, int bsIpeklength)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.8
+
+- Source section: `3.8`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+downloadKeyDukpt
+
+
+Signature/prototype:
+```java
+int downloadKeyDukpt(int keyIndex, in byte[] Bdk, int BdkLen, in byte[] Ksn, int KsnLen, in byte[] bsIpek, int bsIpeklength)
+```
+
+
+Parameters:
+Input
+keyIndex - index of which key sets(1-4).
+Bdk - BDK data
+BdkLen - The length of Bdk
+ksn - KSN data
+KsnLen - The length of KSN data
+bsIpek - IPEK data
+bsIpeklength - The length of IPEK data
+Output
+None
+
+
+Return value:
+ErrorCode
+
+
+Source details:
+```text
+Prototype
+int downloadKeyDukpt(int keyIndex, in byte[] Bdk, int BdkLen, in byte[] Ksn, int KsnLen, in byte[] bsIpek, int bsIpeklength)
+Description
+downloadKeyDukpt
+Parameters
+Input
+keyIndex - index of which key sets(1-4).
+Bdk - BDK data
+BdkLen - The length of Bdk
+ksn - KSN data
+KsnLen - The length of KSN data
+bsIpek - IPEK data
+bsIpeklength - The length of IPEK data
+Output
+None
+Return
+ErrorCode
+Remark
+```
+
+## calculateMACOfDUKPTExtend
+
+Calculate the MAC under DUKPT(X9.19 Retail MAC)
+
+```java
+int calculateMACOfDUKPTExtend(int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.9
+
+- Source section: `3.9`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculate the MAC under DUKPT(X9.19 Retail MAC)
+
+
+Signature/prototype:
+```java
+int calculateMACOfDUKPTExtend(int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+```
+
+
+Parameters:
+Input
+keySetNum - key index.
+rawData - input data
+rawDataLen - The length of rawData
+outData - The MAC result of rawData
+outDataLen - The length of outData
+outKsn - OutKsn Data
+KsnLen - The length of outKsn.
+Output
+None
+
+
+Return value:
+ErrorCode
+
+
+Source details:
+```text
+Prototype
+int calculateMACOfDUKPTExtend(int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+Description
+Calculate the MAC under DUKPT(X9.19 Retail MAC)
+Parameters
+Input
+keySetNum - key index.
+rawData - input data
+rawDataLen - The length of rawData
+outData - The MAC result of rawData
+outDataLen - The length of outData
+outKsn - OutKsn Data
+KsnLen - The length of outKsn.
+Output
+None
+Return
+ErrorCode
+Remark
+```
+
+## encryptWithPEK(Deprecated)
+
+Basic DUKPT Key encryption function
+
+```java
+int encryptWithPEK(int keyUsage, int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.10
+
+- Source section: `3.10`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Basic DUKPT Key encryption function
+
+
+Signature/prototype:
+```java
+int encryptWithPEK(int keyUsage, int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+```
+
+
+Parameters:
+Input
+
+keyUsage:
+* 0x01 - Pin
+* 0x02 - Mac
+* 0x03 - TrackData
+keySetNum - index of which key sets.
+rawData - input data.
+rawDataLen - The length of rawData.
+outData - The encrypt result of rawData
+( the length of outdata must be (inputlen/8+ 1)*8)
+outDataLen - The length of outData
+outKsn - outKsn data
+KsnLen - The length of outKsn.
+Output
+None
+
+
+Return value:
+result
+
+
+Usage notes:
+Suggest using method 3.19 DukptEncrytDataIV.
+
+
+Source details:
+```text
+Prototype
+int encryptWithPEK(int keyUsage, int keySetNum, in byte[] rawData, in int rawDataLen, in byte[] outData, in int[] outDataLen, in byte[] outKsn, in int[] KsnLen)
+Description
+Basic DUKPT Key encryption function
+Parameters
+Input
+
+keyUsage:
+* 0x01 - Pin
+* 0x02 - Mac
+* 0x03 - TrackData
+keySetNum - index of which key sets.
+rawData - input data.
+rawDataLen - The length of rawData.
+outData - The encrypt result of rawData
+( the length of outdata must be (inputlen/8+ 1)*8)
+outDataLen - The length of outData
+outKsn - outKsn data
+KsnLen - The length of outKsn.
+Output
+None
+Return
+result
+Remark
+Suggest using method 3.19 DukptEncrytDataIV.
+```
+
+## getDukptPinBlock
+
+Calculate PinBlock under DUKPT
+
+```java
+void GetDukptPinBlock(Bundle bundle, PinInputListener listener)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.11
+
+- Source section: `3.11`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculate PinBlock under DUKPT
+
+
+Signature/prototype:
+```java
+void GetDukptPinBlock(Bundle bundle, PinInputListener listener)
+```
+
+
+Parameters:
+Input
+
+OnlinePin(boolean) - isOnline pin
+PINKeyNo(int) - pin key index
+cardNo(String) - card holder number.
+
+title(String) - The Title to be displayed on the pinpad
+message(String) - The messge to be displayed on the pinpad
+supportPinLen(String) - default(0, 4,5,6,7,8,9,10,11,12)
+bypass(boolean) - is support bypass
+timeoutMs(long) - enter pin Timeout(ms).
+sound(boolean) - whether play keyboard sound
+FullScreen(boolean) - whether the pinpad is displayed in full screen
+randomKeyboard(boolean) - whether display random number.
+Shortarray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+textSize(shortArray): {10, 10, 10, 10, 10, 10, 10}.
+leftMargin: {10, 10, 10, 10, 10, 10, 10}.
+topMargin: {10, 10, 10, 10, 10, 10, 10}.
+rightMargin: {10, 10, 10, 10, 10, 10, 10}.
+bottomMargin: {10, 10, 10, 10, 10, 10, 10}.
+
+IntArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+* - numberText(StringArray): {0, 1,2,3,4,5,6,7,8,9}.
+* - cancelText: "CANCEL".
+* - deleteText:"DELETE".
+* - okText:"OK".
+listener : The PedInputListener that will be called when a input key event is fired.
+listener : callback listener for pin enter
+PIN input process listener
+Interface PinInputListener {
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input
+* @param data - pin code, null when input is empty
+* @param isNonePin - true if the input is empty
+*/
+void onConfirm(in byte[] data, boolean isNonePin);
+
+/**
+* Called when canceling PIN input
+*/
+void onCancel();
+/**
+* Called when PIN input timeOut
+*/
+void onTimeOut();
+
+/**
+* Callback when wrong
+* @param errorCode - error code
+*/
+void onError(int errorCode);
+
+/**
+* Called when the user confirms the PIN input
+* @param PinBlock - pinBlock data, null when input is empty
+* @param ksn - ksn data, null when input is empty
+*/
+void onConfim_dukpt(byte[] PinBlock, byte[] ksn);
+}
+Output
+None
+
+
+Source details:
+```text
+Prototype
+void GetDukptPinBlock(Bundle bundle, PinInputListener listener)
+Description
+Calculate PinBlock under DUKPT
+Parameters
+Input
+
+OnlinePin(boolean) - isOnline pin
+PINKeyNo(int) - pin key index
+cardNo(String) - card holder number.
+
+title(String) - The Title to be displayed on the pinpad
+message(String) - The messge to be displayed on the pinpad
+supportPinLen(String) - default(0, 4,5,6,7,8,9,10,11,12)
+bypass(boolean) - is support bypass
+timeoutMs(long) - enter pin Timeout(ms).
+sound(boolean) - whether play keyboard sound
+FullScreen(boolean) - whether the pinpad is displayed in full screen
+randomKeyboard(boolean) - whether display random number.
+Shortarray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+textSize(shortArray): {10, 10, 10, 10, 10, 10, 10}.
+leftMargin: {10, 10, 10, 10, 10, 10, 10}.
+topMargin: {10, 10, 10, 10, 10, 10, 10}.
+rightMargin: {10, 10, 10, 10, 10, 10, 10}.
+bottomMargin: {10, 10, 10, 10, 10, 10, 10}.
+
+IntArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+* - numberText(StringArray): {0, 1,2,3,4,5,6,7,8,9}.
+* - cancelText: "CANCEL".
+* - deleteText:"DELETE".
+* - okText:"OK".
+listener : The PedInputListener that will be called when a input key event is fired.
+listener : callback listener for pin enter
+PIN input process listener
+Interface PinInputListener {
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input
+* @param data - pin code, null when input is empty
+* @param isNonePin - true if the input is empty
+*/
+void onConfirm(in byte[] data, boolean isNonePin);
+
+/**
+* Called when canceling PIN input
+*/
+void onCancel();
+/**
+* Called when PIN input timeOut
+*/
+void onTimeOut();
+
+/**
+* Callback when wrong
+* @param errorCode - error code
+*/
+void onError(int errorCode);
+Source note: section truncated for chunk size; consult the source document for remaining detailed tables (93 source lines total).
+```
+
+## getPinBlockEx
+
+Calculate PinBlock under MK/SK
+
+```java
+void getPinBlockEx(Bundle bundle, PinInputListener listener)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.12
+
+- Source section: `3.12`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculate PinBlock under MK/SK
+
+
+Signature/prototype:
+```java
+void getPinBlockEx(Bundle bundle, PinInputListener listener)
+```
+
+
+Parameters:
+Input
+
+onlinePin(boolean) - true-online, false-offline.
+PINKeyNo(int) - pin key index
+pinAlgMode(int) - 0-format 0, 1-format 3. (Optional: default is format 0)
+cardNo(String) - card holder number.
+
+title(String) - The Title to be displayed on the pinpad.
+message(String) - The messge to be displayed on the pinpad .
+supportPinLen (String) - default(0, 4,5,6,7,8,9,10,11,12).
+bypass(boolean) - is support bypass.
+timeoutMs(long) - enter pin Timeout(ms).
+sound(boolean) - whether play keyboard sound.
+FullScreen(boolean) - whether the pinpad is displayed in full screen.
+randomKeyboard(boolean) - whether display random number.
+soundVolume(int) - the volumes of keyboard(1-15).
+infoLocation(String) - The location of the message:LEFT,CENTER,RIGHT.
+money(String) - money text
+randomKeyBoradLocation(boolean) - If true,the vertical position of the key area will automatically change.
+randomKeyboardStaticLocation(intArray) - The coordinates((X,Y)) of the keyboard area. If the Y=0, setting is invalid.
+customization - If true, can customize pinpad UI.
+Refer to the appendix A.
+strJson(String) - If customization is true, customize the pinpad UI with this paramater.
+cancelBitmap(Bitmap) - cancel button
+delBitmap(Bitmap) - delete button
+okBitemap(Bitmap) - ok button
+backspaceBitmap(Bitmap) - back button
+bodyBitmap(Bitmap) - Full screen background image
+keyBitmap(Bitmap) - Keyboard background image
+viewBitmap(Bitmap):
+ShortArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+
+textSize(shortArray): {10, 10, 10, 10, 10, 10, 10}.
+leftMargin: {10, 10, 10, 10, 10, 10, 10}.
+topMargin: {10, 10, 10, 10, 10, 10, 10}.
+rightMargin: {10, 10, 10, 10, 10, 10, 10}.
+bottomMargin: {10, 10, 10, 10, 10, 10, 10}.
+
+IntArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+
+* - numberText(StringArray): {0, 1,2,3,4,5,6,7,8,9}.
+* - cancelText: "CANCEL".
+* - deleteText:"DELETE".
+* - okText:"OK".
+
+listener : The PedInputListener that will be called when a input key event is fired.
+listener : callback listener for pin enter
+PIN input process listener
+Interface PinInputListener {
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input
+* @param data - ciphertext pin block(ASCII)
+* @param isNonePin - true if the input is empty
+*/
+void onConfirm(in byte[] data, boolean isNonePin);
+
+/**
+* Called when canceling PIN input
+*/
+void onCancel();
+/**
+* Called when PIN input timeOut
+*/
+void onTimeOut();
+
+/**
+* Callback when wrong
+* @param errorCode - error code
+*/
+void onError(int errorCode);
+
+/**
+* Called when the user confirms the PIN input
+* @param PinBlock - ciphertext pin block(ASCII)
+* @param ksn - ksn data, null when input is empty
+*/
+void onConfim_dukpt(byte[] PinBlock, byte[] ksn);
+}
+Output
+None
+
+
+Simplified example:
+```java
+Bundle args = new Bundle();
+args.putBoolean("onlinePin", true);
+args.putInt("PINKeyNo", 1);
+args.putString("cardNo", pan);
+args.putString("supportPinLen", "0,4,5,6");
+args.putLong("timeoutMs", 30000L);
+PinPadProviderImpl.getInstance().getPinBlockEx(args, listener);
+```
+
+
+Source details:
+```text
+Prototype
+void getPinBlockEx(Bundle bundle, PinInputListener listener)
+Description
+Calculate PinBlock under MK/SK
+Parameters
+Input
+
+onlinePin(boolean) - true-online, false-offline.
+PINKeyNo(int) - pin key index
+pinAlgMode(int) - 0-format 0, 1-format 3. (Optional: default is format 0)
+cardNo(String) - card holder number.
+
+title(String) - The Title to be displayed on the pinpad.
+message(String) - The messge to be displayed on the pinpad .
+supportPinLen (String) - default(0, 4,5,6,7,8,9,10,11,12).
+bypass(boolean) - is support bypass.
+timeoutMs(long) - enter pin Timeout(ms).
+sound(boolean) - whether play keyboard sound.
+FullScreen(boolean) - whether the pinpad is displayed in full screen.
+randomKeyboard(boolean) - whether display random number.
+soundVolume(int) - the volumes of keyboard(1-15).
+infoLocation(String) - The location of the message:LEFT,CENTER,RIGHT.
+money(String) - money text
+randomKeyBoradLocation(boolean) - If true,the vertical position of the key area will automatically change.
+randomKeyboardStaticLocation(intArray) - The coordinates((X,Y)) of the keyboard area. If the Y=0, setting is invalid.
+customization - If true, can customize pinpad UI.
+Refer to the appendix A.
+strJson(String) - If customization is true, customize the pinpad UI with this paramater.
+cancelBitmap(Bitmap) - cancel button
+delBitmap(Bitmap) - delete button
+okBitemap(Bitmap) - ok button
+backspaceBitmap(Bitmap) - back button
+bodyBitmap(Bitmap) - Full screen background image
+keyBitmap(Bitmap) - Keyboard background image
+viewBitmap(Bitmap):
+ShortArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+
+textSize(shortArray): {10, 10, 10, 10, 10, 10, 10}.
+leftMargin: {10, 10, 10, 10, 10, 10, 10}.
+topMargin: {10, 10, 10, 10, 10, 10, 10}.
+rightMargin: {10, 10, 10, 10, 10, 10, 10}.
+bottomMargin: {10, 10, 10, 10, 10, 10, 10}.
+
+IntArray meaning of each index(0-6):
+* 0: SECURITY_KEYBOARD_TITLE.
+* 1: SECURITY_KEYBOARD_INFO.
+* 2: SECURITY_KEYBOARD_PASSWORD.
+* 3: SECURITY_KEYBOARD_KEY_NUMBER.
+* 4: SECURITY_KEYBOARD_KEY_CANCEL.
+* 5: SECURITY_KEYBOARD_KEY_DELETE.
+* 6: SECURITY_KEYBOARD_KEY_OK.
+backgroundColor(IntArray):{ xff0C9213, 0xff0C9213, 0, 0, 0xFFFF0000, 0xffFFFE00, 0xff0C9213}.
+
+* - numberText(StringArray): {0, 1,2,3,4,5,6,7,8,9}.
+* - cancelText: "CANCEL".
+* - deleteText:"DELETE".
+* - okText:"OK".
+
+listener : The PedInputListener that will be called when a input key event is fired.
+listener : callback listener for pin enter
+PIN input process listener
+Interface PinInputListener {
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input
+* @param data - ciphertext pin block(ASCII)
+* @param isNonePin - true if the input is empty
+Source note: section truncated for chunk size; consult the source document for remaining detailed tables (110 source lines total).
+```
+
+## getRSAPublicKeyModel
+
+Obtain RSA Public key Exponent and Modulus
+
+```java
+boolean getRSAPublicKeyModel(byte[] publickey, int[] publickeyLen,
+int[] exponent)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.13
+
+- Source section: `3.13`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Obtain RSA Public key Exponent and Modulus
+
+
+Signature/prototype:
+```java
+boolean getRSAPublicKeyModel(byte[] publickey, int[] publickeyLen,
+int[] exponent)
+```
+
+
+Parameters:
+Input
+
+Publickey - Public Key Modulus Byte Array
+publickeyLen - Length of Public Key Modulus Byte Array
+Exponent - RSA Exponent
+Output
+None
+
+
+Return value:
+true:success, false:failed.
+
+
+Source details:
+```text
+Prototype
+boolean getRSAPublicKeyModel(byte[] publickey, int[] publickeyLen,
+int[] exponent)
+Description
+Obtain RSA Public key Exponent and Modulus
+Parameters
+Input
+
+Publickey - Public Key Modulus Byte Array
+publickeyLen - Length of Public Key Modulus Byte Array
+Exponent - RSA Exponent
+Output
+None
+Return
+true:success, false:failed.
+Remark
+```
+
+## loadDukptBlob
+
+Decrypt Dukpt and Load The Key Into The Terminal.
+Source key data format:
+type(1 bytes)+keyId(3 bytes)+ipek(16 bytes)+ksn(10 bytes).
+
+```java
+int loadDukptBlob(int keySlot, byte[] blob, int blobLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.14
+
+- Source section: `3.14`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Decrypt Dukpt and Load The Key Into The Terminal.
+Source key data format:
+type(1 bytes)+keyId(3 bytes)+ipek(16 bytes)+ksn(10 bytes).
+
+
+Signature/prototype:
+```java
+int loadDukptBlob(int keySlot, byte[] blob, int blobLen)
+```
+
+
+Parameters:
+Input
+
+keySlot - Dukpt keytype
+Blob - The Encrypted Data
+blobLen - Length of The Encrypted Data
+Output
+None
+
+
+Return value:
+0:success, others:failed
+
+
+Source details:
+```text
+Prototype
+int loadDukptBlob(int keySlot, byte[] blob, int blobLen)
+Description
+Decrypt Dukpt and Load The Key Into The Terminal.
+Source key data format:
+type(1 bytes)+keyId(3 bytes)+ipek(16 bytes)+ksn(10 bytes).
+Parameters
+Input
+
+keySlot - Dukpt keytype
+Blob - The Encrypted Data
+blobLen - Length of The Encrypted Data
+Output
+None
+Return
+0:success, others:failed
+Remark
+```
+
+## DukptGetKsn
+
+getKsn
+
+```java
+int DukptGetKsn(int keySetNum, byte[] outKsn);
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.15
+
+- Source section: `3.15`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+getKsn
+
+
+Signature/prototype:
+```java
+int DukptGetKsn(int keySetNum, byte[] outKsn);
+```
+
+
+Parameters:
+Input
+keySetNum - keyIndex, 1-4
+Output
+outKsn - the ksn value
+
+
+Return value:
+0:success , others:failed
+
+
+Source details:
+```text
+Prototype
+int DukptGetKsn(int keySetNum, byte[] outKsn);
+Description
+getKsn
+Parameters
+Input
+keySetNum - keyIndex, 1-4
+Output
+outKsn - the ksn value
+Return
+0:success , others:failed
+Remark
+```
+
+## DiversifiedKey
+
+Generate new pin key before starting pin input.(3DES ECB)
+
+```java
+int diversifiedKey(int masterkeyIndex, int sourceKeyIndex, int destKeyIndex, String diversifyingData);
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.16
+
+- Source section: `3.16`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Generate new pin key before starting pin input.(3DES ECB)
+
+
+Signature/prototype:
+```java
+int diversifiedKey(int masterkeyIndex, int sourceKeyIndex, int destKeyIndex, String diversifyingData);
+```
+
+
+Parameters:
+Input
+masterkeyIndex - master key index
+sourceKeyIndex - soruce pin key index
+destKeyIndex - new pin key index
+diversifyingData - the data used to generate the new key.(32 hex string)
+Output
+outKsn - the ksn value
+
+
+Return value:
+0:success, others:failed
+
+
+Source details:
+```text
+Prototype
+int diversifiedKey(int masterkeyIndex, int sourceKeyIndex, int destKeyIndex, String diversifyingData);
+Description
+Generate new pin key before starting pin input.(3DES ECB)
+Parameters
+Input
+masterkeyIndex - master key index
+sourceKeyIndex - soruce pin key index
+destKeyIndex - new pin key index
+diversifyingData - the data used to generate the new key.(32 hex string)
+Output
+outKsn - the ksn value
+Return
+0:success, others:failed
+Remark
+```
+
+## genKeyHashValue
+
+Do SHA-256 hashing with key.
+
+```java
+int genKeyHashValue(int KeyUsage, int KeyNo, byte[] DataIn, int DataInLen,
+byte[] ResponseData, byte[] ResLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.17
+
+- Source section: `3.17`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Do SHA-256 hashing with key.
+
+
+Signature/prototype:
+```java
+int genKeyHashValue(int KeyUsage, int KeyNo, byte[] DataIn, int DataInLen,
+byte[] ResponseData, byte[] ResLen)
+```
+
+
+Parameters:
+Input
+keyUsage - keyType
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType
+KeyNo - key index
+DataIn - source data.
+DataInLen - the length of source data
+Output
+ResponseData - response data.
+
+ResLen: the length of response data. Length = ResLen[0].
+
+
+Return value:
+0:success, others:failed
+
+
+Source details:
+```text
+Prototype
+int genKeyHashValue(int KeyUsage, int KeyNo, byte[] DataIn, int DataInLen,
+byte[] ResponseData, byte[] ResLen)
+Description
+Do SHA-256 hashing with key.
+Parameters
+Input
+keyUsage - keyType
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType
+KeyNo - key index
+DataIn - source data.
+DataInLen - the length of source data
+Output
+ResponseData - response data.
+
+ResLen: the length of response data. Length = ResLen[0].
+Return
+0:success, others:failed
+Remark
+```
+
+## EndPinInputEvent
+
+Close the PIN pad
+
+```java
+void EndPinInputEvent(int Event)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.18
+
+- Source section: `3.18`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Close the PIN pad
+
+
+Signature/prototype:
+```java
+void EndPinInputEvent(int Event)
+```
+
+
+Parameters:
+Input
+Event - the oparation code.(16 -cancel)
+Output
+None
+
+
+Return value:
+None
+
+
+Source details:
+```text
+Prototype
+void EndPinInputEvent(int Event)
+Description
+Close the PIN pad
+Parameters
+Input
+Event - the oparation code.(16 -cancel)
+Output
+None
+Return
+None
+Remark
+```
+
+## DukptEncrytDataIV
+
+DUKPT encryption and decryption.
+
+```java
+int DukptEncryptDataIV(int keyUsage, int keyIndex, int encMode, in byte[] iv,
+int ivLen, byte[] dataIn, int inLen, byte[] dataOut, int[] outLen, byte[] outKsn,
+int[] KsnLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.19
+
+- Source section: `3.19`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+DUKPT encryption and decryption.
+
+
+Signature/prototype:
+```java
+int DukptEncryptDataIV(int keyUsage, int keyIndex, int encMode, in byte[] iv,
+int ivLen, byte[] dataIn, int inLen, byte[] dataOut, int[] outLen, byte[] outKsn,
+int[] KsnLen)
+```
+
+
+Parameters:
+Input
+
+keyUsage:
+* 0x01 - Pin
+* 0x02 - Mac
+* 0x03 - TrackData
+* 0x04 - Mac
+keySetNum : index of which key sets.
+encMode:
+When keyType = 1/2/3:
+* 0x00: ecb encryption.
+* 0x01: cbc encryption.
+* 0x10: ecb decryption.
+* 0x11: cbc decryption.
+
+When keyType = 4:
+bit 2-5: mac algorithm 0-5.
+bit 6-7: encryption type, 0-ASE, 1-TDES.
+iv - the initial vector,default:new byte[8].
+ivLen - The length of initial vector.
+dataIn - input data.
+inLen - The length of rawData.
+Output
+outData - The encrypt result of rawData
+(the length of outdata must be (inputlen/8+ 1)*8)
+
+outDataLen - The length of outData.
+
+outKsn - outKsn data(10-bytes).
+
+KsnLen - The length of outKsn.
+
+
+Return value:
+0-success, others-failed.
+
+
+Source details:
+```text
+Prototype
+int DukptEncryptDataIV(int keyUsage, int keyIndex, int encMode, in byte[] iv,
+int ivLen, byte[] dataIn, int inLen, byte[] dataOut, int[] outLen, byte[] outKsn,
+int[] KsnLen)
+Description
+DUKPT encryption and decryption.
+Parameters
+Input
+
+keyUsage:
+* 0x01 - Pin
+* 0x02 - Mac
+* 0x03 - TrackData
+* 0x04 - Mac
+keySetNum : index of which key sets.
+encMode:
+When keyType = 1/2/3:
+* 0x00: ecb encryption.
+* 0x01: cbc encryption.
+* 0x10: ecb decryption.
+* 0x11: cbc decryption.
+
+When keyType = 4:
+bit 2-5: mac algorithm 0-5.
+bit 6-7: encryption type, 0-ASE, 1-TDES.
+iv - the initial vector,default:new byte[8].
+ivLen - The length of initial vector.
+dataIn - input data.
+inLen - The length of rawData.
+Output
+outData - The encrypt result of rawData
+(the length of outdata must be (inputlen/8+ 1)*8)
+
+outDataLen - The length of outData.
+
+outKsn - outKsn data(10-bytes).
+
+KsnLen - The length of outKsn.
+Return
+0-success, others-failed.
+Remark
+```
+
+## deleteKey(MK/SK)
+
+Delete the key (only for MK/SK).
+
+```java
+Int deleteKey(int keyType, int keyId)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.20
+
+- Source section: `3.20`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Delete the key (only for MK/SK).
+
+
+Signature/prototype:
+```java
+Int deleteKey(int keyType, int keyId)
+```
+
+
+Parameters:
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to Constant.KeyType.
+
+keyId - the index of the key.
+Output
+None
+
+
+Return value:
+0:success, 23:key is not exist, others:failed.
+
+
+Source details:
+```text
+Prototype
+Int deleteKey(int keyType, int keyId)
+Description
+Delete the key (only for MK/SK).
+Parameters
+Input
+keyType - key type
+- 0-Main key
+- 1-MAC key
+- 2-PIN key
+- 3-TD key
+
+Refer to Constant.KeyType.
+
+keyId - the index of the key.
+Output
+None
+Return
+0:success, 23:key is not exist, others:failed.
+Remark
+```
+
+## setKeyAlgorithm
+
+Set Key Algorithm.
+
+```java
+void setKeyAlgorithm(int algorithm)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.21
+
+- Source section: `3.21`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Set Key Algorithm.
+
+
+Signature/prototype:
+```java
+void setKeyAlgorithm(int algorithm)
+```
+
+
+Parameters:
+Input
+algorithm- key algorithm
+- 0-Des
+- 1-SM4
+- 2-AES
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyAlgorithm.
+Output
+None
+
+
+Return value:
+None
+
+
+Source details:
+```text
+Prototype
+void setKeyAlgorithm(int algorithm)
+Description
+Set Key Algorithm.
+Parameters
+Input
+algorithm- key algorithm
+- 0-Des
+- 1-SM4
+- 2-AES
+
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyAlgorithm.
+Output
+None
+Return
+None
+Remark
+```
+
+## DukptAesInitial
+
+Inject the AES BDK or Initial KEY (AES-128,AES-192,AES-256)
+
+```java
+int DukptAesInitial(int keyIndex, byte[] Bdk, int BdkLen, byte[] Ipek, int IpekLen,
+int DeriveKeyType, byte[] Ksn, int ksnLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.22
+
+- Source section: `3.22`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Inject the AES BDK or Initial KEY (AES-128,AES-192,AES-256)
+
+
+Signature/prototype:
+```java
+int DukptAesInitial(int keyIndex, byte[] Bdk, int BdkLen, byte[] Ipek, int IpekLen,
+int DeriveKeyType, byte[] Ksn, int ksnLen)
+```
+
+
+Parameters:
+Input
+keyIndex - key index(1-4)
+DeriveKeyType -
+Refer to com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+Output
+None
+
+
+Return value:
+0-success, others-failed.
+
+
+Source details:
+```text
+Prototype
+int DukptAesInitial(int keyIndex, byte[] Bdk, int BdkLen, byte[] Ipek, int IpekLen,
+int DeriveKeyType, byte[] Ksn, int ksnLen)
+Description
+Inject the AES BDK or Initial KEY (AES-128,AES-192,AES-256)
+Parameters
+Input
+keyIndex - key index(1-4)
+DeriveKeyType -
+Refer to com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+Output
+None
+Return
+0-success, others-failed.
+Remark
+```
+
+## DukptAesGetKsn
+
+Get the current KSN for AES DUKPT
+
+```java
+int DukptAesGetKsn(int keyIndex, byte[] outKsn)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.23
+
+- Source section: `3.23`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Get the current KSN for AES DUKPT
+
+
+Signature/prototype:
+```java
+int DukptAesGetKsn(int keyIndex, byte[] outKsn)
+```
+
+
+Parameters:
+Input
+keyIndex - key index(1-4)
+Output
+outKsn - 12 bytes.
+
+
+Return value:
+0-success
+
+
+Source details:
+```text
+Prototype
+int DukptAesGetKsn(int keyIndex, byte[] outKsn)
+Description
+Get the current KSN for AES DUKPT
+Parameters
+Input
+keyIndex - key index(1-4)
+Output
+outKsn - 12 bytes.
+Return
+0-success
+Remark
+```
+
+## DukptAesUpdateKsn
+
+Generate the New KSN for AES DUKPT (KSN counter will add 1)
+
+```java
+int DukptAesUpdateKsn(int keyIndex, byte[] outKsn)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.24
+
+- Source section: `3.24`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Generate the New KSN for AES DUKPT (KSN counter will add 1)
+
+
+Signature/prototype:
+```java
+int DukptAesUpdateKsn(int keyIndex, byte[] outKsn)
+```
+
+
+Parameters:
+Input
+keyIndex - key index(1-4)
+Output
+outKsn - 12 bytes
+
+
+Return value:
+0-success
+
+
+Source details:
+```text
+Prototype
+int DukptAesUpdateKsn(int keyIndex, byte[] outKsn)
+Description
+Generate the New KSN for AES DUKPT (KSN counter will add 1)
+Parameters
+Input
+keyIndex - key index(1-4)
+Output
+outKsn - 12 bytes
+Return
+0-success
+Remark
+```
+
+## DukptAesEncryptDataIV
+
+Use Dukpt-Aes to encrypt data or calc MAC.
+
+```java
+int DukptAesEncryptDataIV(int keyType, int keyIndex, int encMode,
+int workkeytype, byte[] iv, int ivLen, byte[] dataIn, int inLen, byte[] dataOut,
+int[] outLen, byte[] outKsn, int[] KsnLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.25
+
+- Source section: `3.25`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Use Dukpt-Aes to encrypt data or calc MAC.
+
+
+Signature/prototype:
+```java
+int DukptAesEncryptDataIV(int keyType, int keyIndex, int encMode,
+int workkeytype, byte[] iv, int ivLen, byte[] dataIn, int inLen, byte[] dataOut,
+int[] outLen, byte[] outKsn, int[] KsnLen)
+```
+
+
+Parameters:
+Input
+keyType - Key type for Alg
+bit0~7:
+0x01 - Pin;
+0x02 - Mac;
+0x03 - TrackData.
+bit8~15:
+when bit0~7=1 Pin
+0x00 // Encrypt a PIN message
+when bit0~7=2 Mac
+0x00, // MAC code verification
+0x01, // MAC code generation
+0x02, // Two-way message authentication
+when bit0~7=3 TrackData
+0x00, // Data encryption
+0x01, // Data decryption
+0x02, // Two-way data encryption
+keyIndex - key index(1-4).
+encMode - 1bytes
+when Keytype=1，encmode：
+0x00: format0
+0x01: format1
+0x02: format2
+0x03: format3
+0x04: format4
+when Keytype=3，encmode：
+0x00: ecb encode.
+0x01: cbc encode.
+0x10: ecb decode.
+0x11: cbc decode.
+when Keytype=2, encmode:
+mac alg
+0x01: MAC_ALG_X9_19.
+0x02: MAC_ALG_ISO_9797_1_MAC_ALG5.
+0x03: CMAC.
+workkeytype- com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+_2TDEA = 0
+_3TDEA = 1
+_AES128 = 2
+_AES192 = 3
+_AES256 = 4
+iv - the initial vector,default:new byte[16].
+ivLen - The length of initial vector.
+dataIn - input data.
+inLen - The length of rawData.
+Output
+dataOut - The encrypt result of rawData.
+outLen - The length of outData.
+outKsn - outKsn data(12-bytes).
+outLen - The length of outData.
+
+
+Return value:
+0-success
+
+
+Source details:
+```text
+Prototype
+int DukptAesEncryptDataIV(int keyType, int keyIndex, int encMode,
+int workkeytype, byte[] iv, int ivLen, byte[] dataIn, int inLen, byte[] dataOut,
+int[] outLen, byte[] outKsn, int[] KsnLen)
+Description
+Use Dukpt-Aes to encrypt data or calc MAC.
+Parameters
+Input
+keyType - Key type for Alg
+bit0~7:
+0x01 - Pin;
+0x02 - Mac;
+0x03 - TrackData.
+bit8~15:
+when bit0~7=1 Pin
+0x00 // Encrypt a PIN message
+when bit0~7=2 Mac
+0x00, // MAC code verification
+0x01, // MAC code generation
+0x02, // Two-way message authentication
+when bit0~7=3 TrackData
+0x00, // Data encryption
+0x01, // Data decryption
+0x02, // Two-way data encryption
+keyIndex - key index(1-4).
+encMode - 1bytes
+when Keytype=1，encmode：
+0x00: format0
+0x01: format1
+0x02: format2
+0x03: format3
+0x04: format4
+when Keytype=3，encmode：
+0x00: ecb encode.
+0x01: cbc encode.
+0x10: ecb decode.
+0x11: cbc decode.
+when Keytype=2, encmode:
+mac alg
+0x01: MAC_ALG_X9_19.
+0x02: MAC_ALG_ISO_9797_1_MAC_ALG5.
+0x03: CMAC.
+workkeytype- com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+_2TDEA = 0
+_3TDEA = 1
+_AES128 = 2
+_AES192 = 3
+_AES256 = 4
+iv - the initial vector,default:new byte[16].
+ivLen - The length of initial vector.
+dataIn - input data.
+inLen - The length of rawData.
+Output
+dataOut - The encrypt result of rawData.
+outLen - The length of outData.
+outKsn - outKsn data(12-bytes).
+outLen - The length of outData.
+Return
+0-success
+Remark
+```
+
+## GetDukptAesPinBlock
+
+Calculate PinBlock under DUKPT AES , like as GetDukptPinBlock.
+
+```java
+void GetDukptAesPinBlock(Bundle bundle, final PinInputListener pinInputListener)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.26
+
+- Source section: `3.26`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculate PinBlock under DUKPT AES , like as GetDukptPinBlock.
+
+
+Signature/prototype:
+```java
+void GetDukptAesPinBlock(Bundle bundle, final PinInputListener pinInputListener)
+```
+
+
+Parameters:
+Input
+Same as GetDukptPinBlock parameters
+Add:
+WorkKeyType(int) - com.urovo.sdk.pinpad.utils.Constant.DukptKeyType
+Output
+
+
+Source details:
+```text
+Prototype
+void GetDukptAesPinBlock(Bundle bundle, final PinInputListener pinInputListener)
+Description
+Calculate PinBlock under DUKPT AES , like as GetDukptPinBlock.
+Parameters
+Input
+Same as GetDukptPinBlock parameters
+Add:
+WorkKeyType(int) - com.urovo.sdk.pinpad.utils.Constant.DukptKeyType
+Output
+
+Return
+
+Remark
+```
+
+## getOfflinePinBlcok
+
+Offline pin verification in emv process.
+
+```java
+void getOfflinePinBlock(Bundle bundle, final OfflinePinInputListener listener)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.27
+
+- Source section: `3.27`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Offline pin verification in emv process.
+
+
+Signature/prototype:
+```java
+void getOfflinePinBlock(Bundle bundle, final OfflinePinInputListener listener)
+```
+
+
+Parameters:
+Input
+title(String): The Title to be displayed on the pinpad.
+
+message (String): The messge to be displayed on the pinpad.
+
+supportPinLen(String) : default(0, 4,5,6,7,8,9,10,11,12).
+
+bypass(boolean): is support bypass.
+
+timeoutMs(long) : enter pin Timeout(ms).
+
+sound(boolean)：whether play keyboard sound.
+
+FullScreen(boolean):whether the pinpad is displayed in full screen.
+
+randomKeyboard(boolean):whether display random number.
+
+onlinePin(boolean): fixed with false.
+
+CardSlot(int): fixed with 0.
+
+inputType(int):3-plaintext pin, 4-ciphertext pin.
+
+ModuleLen(int): used for ciphertext pin.
+
+Module(String): used for ciphertext pin.
+
+ExponentLen(int): used for ciphertext pin.
+
+Exponent(String): used for ciphertext offline pin.
+
+listener : callback listener for pin enter
+PIN input process listener:
+need to call "EmvNfcKernelApi.sendOfflinePINVerifyResult(int result)"
+after onCofirm/onCancel/onTimeOut/onError callback.
+Interface OfflinePinInputListener{
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input.
+* @param resultCode: offline verification result.
+*/
+void onConfirm(int resultCode);
+
+/**
+* Called when canceling PIN input.
+* @param pinEntryType: 0-plaintext pin, 1-ciphertext pin.
+* @param retryTimes: remaining retry attempts.
+*/
+void onRetry(int pinEntryType, int retryTimes);;
+
+/**
+* Called when canceling PIN input.
+* @param resultCode: offline verification result.
+*/
+void onCancel(int errorCode);
+
+/**
+* Called when PIN input timeOut.
+* @param resultCode: offline verification result.
+*/
+void onTimeOut(int errorCode);
+
+/**
+* Callback when wrong
+* @param errorCode - error code.
+* @param resultCode: offline verification result.
+*/
+void onError(int errorCode);
+}
+Output
+None
+
+
+Return value:
+None
+
+
+Source details:
+```text
+Prototype
+void getOfflinePinBlock(Bundle bundle, final OfflinePinInputListener listener)
+Description
+Offline pin verification in emv process.
+Parameters
+Input
+title(String): The Title to be displayed on the pinpad.
+
+message (String): The messge to be displayed on the pinpad.
+
+supportPinLen(String) : default(0, 4,5,6,7,8,9,10,11,12).
+
+bypass(boolean): is support bypass.
+
+timeoutMs(long) : enter pin Timeout(ms).
+
+sound(boolean)：whether play keyboard sound.
+
+FullScreen(boolean):whether the pinpad is displayed in full screen.
+
+randomKeyboard(boolean):whether display random number.
+
+onlinePin(boolean): fixed with false.
+
+CardSlot(int): fixed with 0.
+
+inputType(int):3-plaintext pin, 4-ciphertext pin.
+
+ModuleLen(int): used for ciphertext pin.
+
+Module(String): used for ciphertext pin.
+
+ExponentLen(int): used for ciphertext pin.
+
+Exponent(String): used for ciphertext offline pin.
+
+listener : callback listener for pin enter
+PIN input process listener:
+need to call "EmvNfcKernelApi.sendOfflinePINVerifyResult(int result)"
+after onCofirm/onCancel/onTimeOut/onError callback.
+Interface OfflinePinInputListener{
+/**
+* Button press event
+* @param len - password length entered
+* @param key - the current Key value
+*/
+void onInput(int len, int key);
+
+/**
+* Called when the user confirms the PIN input.
+* @param resultCode: offline verification result.
+*/
+void onConfirm(int resultCode);
+
+/**
+* Called when canceling PIN input.
+* @param pinEntryType: 0-plaintext pin, 1-ciphertext pin.
+* @param retryTimes: remaining retry attempts.
+*/
+void onRetry(int pinEntryType, int retryTimes);;
+
+/**
+* Called when canceling PIN input.
+* @param resultCode: offline verification result.
+*/
+void onCancel(int errorCode);
+
+/**
+* Called when PIN input timeOut.
+* @param resultCode: offline verification result.
+*/
+void onTimeOut(int errorCode);
+
+/**
+* Callback when wrong
+* @param errorCode - error code.
+* @param resultCode: offline verification result.
+*/
+void onError(int errorCode);
+}
+Source note: section truncated for chunk size; consult the source document for remaining detailed tables (85 source lines total).
+```
+
+## downloadKeyTR31
+
+Load mksk key in tr31 format
+
+```java
+boolean downloadKeyTR31(int mKeyType, int wKeyType, Bundle bundle)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.28
+
+- Source section: `3.28`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load mksk key in tr31 format
+
+
+Signature/prototype:
+```java
+boolean downloadKeyTR31(int mKeyType, int wKeyType, Bundle bundle)
+```
+
+
+Parameters:
+Input
+mKeyType - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+wKeyType - work key type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+bundle:
+/**
+keyNo: kbpk index.
+sKeyNo: work key index.
+content-tr31: tr31 keyblock.
+content_size: length of tr31 keyblock.
+**/
+Output
+None
+
+
+Return value:
+true-success, false: failed.
+
+
+Source details:
+```text
+Prototype
+boolean downloadKeyTR31(int mKeyType, int wKeyType, Bundle bundle)
+Description
+Load mksk key in tr31 format
+Parameters
+Input
+mKeyType - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+wKeyType - work key type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+bundle:
+/**
+keyNo: kbpk index.
+sKeyNo: work key index.
+content-tr31: tr31 keyblock.
+content_size: length of tr31 keyblock.
+**/
+Output
+None
+Return
+true-success, false: failed.
+Remark
+```
+
+## DukptInitialTr31
+
+Load tdes dukpt key in tr31 format
+
+```java
+int DukptInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.29
+
+- Source section: `3.29`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load tdes dukpt key in tr31 format
+
+
+Signature/prototype:
+```java
+int DukptInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+```
+
+
+Parameters:
+Input
+KbpkUsage - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+KbpkKeyNo - kbpk index.
+keySetNum - dukpt key index.
+isBdk - bdk or ipek.(0-ipek, others-bdk).
+KeyInfo - tr31 key block.
+KeyLen - length of tr31 key block.
+Ksn - ksn.
+KsnLen - length of ksn.
+Kcv_Alg - kcv algorithm.(0-ecb, 1-cmac).
+Kcv_IV - kcv iv data.
+Kcv_IVLen - length of kcv iv data.
+Output
+out_kcv - response kcv.
+
+outLen - length of reponse kcv.
+
+
+Return value:
+0-success, else: failed.
+
+
+Source details:
+```text
+Prototype
+int DukptInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+Description
+Load tdes dukpt key in tr31 format
+Parameters
+Input
+KbpkUsage - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+KbpkKeyNo - kbpk index.
+keySetNum - dukpt key index.
+isBdk - bdk or ipek.(0-ipek, others-bdk).
+KeyInfo - tr31 key block.
+KeyLen - length of tr31 key block.
+Ksn - ksn.
+KsnLen - length of ksn.
+Kcv_Alg - kcv algorithm.(0-ecb, 1-cmac).
+Kcv_IV - kcv iv data.
+Kcv_IVLen - length of kcv iv data.
+Output
+out_kcv - response kcv.
+
+outLen - length of reponse kcv.
+Return
+0-success, else: failed.
+Remark
+```
+
+## DukptAesInitialTr31
+
+Load tdes dukpt key in tr31 format
+
+```java
+int DukptAesInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, int driveKeyType, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.30
+
+- Source section: `3.30`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Load tdes dukpt key in tr31 format
+
+
+Signature/prototype:
+```java
+int DukptAesInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, int driveKeyType, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+```
+
+
+Parameters:
+Input
+KbpkUsage - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+KbpkKeyNo - kbpk index.
+keySetNum - dukpt key index.
+isBdk - bdk or ipek.(0-ipek, others-bdk).
+driveKeyType:
+Refer to com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+KeyInfo - tr31 key block.
+KeyLen - length of tr31 key block.
+Ksn - ksn.
+KsnLen - length of ksn.
+Kcv_Alg - kcv algorithm.(0-ecb, 1-cmac).
+Kcv_IV - kcv iv data.
+Kcv_IVLen - length of kcv iv data.
+Output
+out_kcv: response kcv.
+
+outLen: length of reponse kcv.
+
+
+Return value:
+0-success, else: failed.
+
+
+Source details:
+```text
+Prototype
+int DukptAesInitialTr31(int KbpkUsage, int KbpkKeyNo, int keySetNum, int isBdk, int driveKeyType, byte[] KeyInfo, int KeyLen, byte[] Ksn, int KsnLen, int Kcv_Alg, byte[] Kcv_IV, int Kcv_IVLen, byte[] out_kcv, int[] outLen)
+Description
+Load tdes dukpt key in tr31 format
+Parameters
+Input
+KbpkUsage - kbpk type.
+Refer to com.urovo.sdk.pinpad.utils.Constant.KeyType.
+KbpkKeyNo - kbpk index.
+keySetNum - dukpt key index.
+isBdk - bdk or ipek.(0-ipek, others-bdk).
+driveKeyType:
+Refer to com.urovo.sdk.pinpad.utils.Constant.DukptKeyType.
+KeyInfo - tr31 key block.
+KeyLen - length of tr31 key block.
+Ksn - ksn.
+KsnLen - length of ksn.
+Kcv_Alg - kcv algorithm.(0-ecb, 1-cmac).
+Kcv_IV - kcv iv data.
+Kcv_IVLen - length of kcv iv data.
+Output
+out_kcv: response kcv.
+
+outLen: length of reponse kcv.
+Return
+0-success, else: failed.
+Remark
+```
+
+## generateRSAKey
+
+Generates RSA key pair.
+
+```java
+int generateRSAKey(int rsaIndex, int keySize, String exponent)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.31
+
+- Source section: `3.31`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Generates RSA key pair.
+
+
+Signature/prototype:
+```java
+int generateRSAKey(int rsaIndex, int keySize, String exponent)
+```
+
+
+Parameters:
+Input
+rsaIndex - 0-9.
+keySize - 512, 1024, 2048, 3072, 4096.
+exponent: - default value is 010001.
+Output
+None
+
+
+Return value:
+0:success, others:failed
+
+
+Source details:
+```text
+Prototype
+int generateRSAKey(int rsaIndex, int keySize, String exponent)
+Description
+Generates RSA key pair.
+Parameters
+Input
+rsaIndex - 0-9.
+keySize - 512, 1024, 2048, 3072, 4096.
+exponent: - default value is 010001.
+Output
+None
+Return
+0:success, others:failed
+Remark
+```
+
+## readRSAPublicKey
+
+Read RSA public key from device.
+
+```java
+RSAPublicKey readRSAPublicKey(int rsaIndex)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.32
+
+- Source section: `3.32`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Read RSA public key from device.
+
+
+Signature/prototype:
+```java
+RSAPublicKey readRSAPublicKey(int rsaIndex)
+```
+
+
+Parameters:
+Input
+rsaIndex - 0-9.
+Output
+None
+
+
+Return value:
+The RSA public key.
+
+
+Source details:
+```text
+Prototype
+RSAPublicKey readRSAPublicKey(int rsaIndex)
+Description
+Read RSA public key from device.
+Parameters
+Input
+rsaIndex - 0-9.
+Output
+None
+Return
+The RSA public key.
+Remark
+```
+
+## calculateWithRSAPrivateKey
+
+Calculation with RSA private key.
+
+```java
+byte[] calculateWithRSAPrivateKey(int rsaIndex, byte[] data)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.33
+
+- Source section: `3.33`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculation with RSA private key.
+
+
+Signature/prototype:
+```java
+byte[] calculateWithRSAPrivateKey(int rsaIndex, byte[] data)
+```
+
+
+Parameters:
+Input
+rsaIndex - 0-9.
+
+data -the data used for calculation.(Data with padding).
+Output
+None
+
+
+Return value:
+The calculation result.
+
+
+Source details:
+```text
+Prototype
+byte[] calculateWithRSAPrivateKey(int rsaIndex, byte[] data)
+Description
+Calculation with RSA private key.
+Parameters
+Input
+rsaIndex - 0-9.
+
+data -the data used for calculation.(Data with padding).
+Output
+None
+Return
+The calculation result.
+Remark
+```
+
+## calculateWithRSAPublicKey
+
+Calculation with RSA public key.
+
+```java
+byte[] calculateWithRSAPublicKey(int rsaIndex, byte[] data)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.34
+
+- Source section: `3.34`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Calculation with RSA public key.
+
+
+Signature/prototype:
+```java
+byte[] calculateWithRSAPublicKey(int rsaIndex, byte[] data)
+```
+
+
+Parameters:
+Input
+rsaIndex - 0-9.
+
+data -the data used for calculation.(Data with padding).
+Output
+None
+
+
+Return value:
+The calculation result.
+
+
+Source details:
+```text
+Prototype
+byte[] calculateWithRSAPublicKey(int rsaIndex, byte[] data)
+Description
+Calculation with RSA public key.
+Parameters
+Input
+rsaIndex - 0-9.
+
+data -the data used for calculation.(Data with padding).
+Output
+None
+Return
+The calculation result.
+Remark
+```
+
+## isDukptKeyExist
+
+Determine is the dukpt key exist.
+
+```java
+boolean isDukptKeyExist(boolean aesAlg, int keyIndex, byte[] outKsn)
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.35
+
+- Source section: `3.35`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+Determine is the dukpt key exist.
+
+
+Signature/prototype:
+```java
+boolean isDukptKeyExist(boolean aesAlg, int keyIndex, byte[] outKsn)
+```
+
+
+Parameters:
+Input
+aesAlg - is aes algorithm.
+
+keyIndex - key index.
+
+outKsn - the ksn.
+Output
+None
+
+
+Return value:
+The calculation result.
+
+
+Source details:
+```text
+Prototype
+boolean isDukptKeyExist(boolean aesAlg, int keyIndex, byte[] outKsn)
+Description
+Determine is the dukpt key exist.
+Parameters
+Input
+aesAlg - is aes algorithm.
+
+keyIndex - key index.
+
+outKsn - the ksn.
+Output
+None
+Return
+The calculation result.
+Remark
+```
+
+## getLastErrorCode
+
+The last error code
+
+```java
+int getLastErrorCode()
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.36
+
+- Source section: `3.36`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+The last error code
+
+
+Signature/prototype:
+```java
+int getLastErrorCode()
+```
+
+
+Parameters:
+Input
+None
+Output
+None
+
+
+Return value:
+The error code.
+
+
+Usage notes:
+Refer to the Pinpad Error Code Definition.
+
+
+Source details:
+```text
+Prototype
+int getLastErrorCode()
+Description
+The last error code
+Parameters
+Input
+None
+Output
+None
+Return
+The error code.
+Remark
+Refer to the Pinpad Error Code Definition.
+```
+
+## getLastErrorMsg
+
+The last error message.
+
+```java
+String getLastErrorMsg()
+```
+
+- **类路径：** `com.urovo.sdk.pinpad.PinPadProviderImpl`
+- **Demo Activity（参考）：** PinpadActivity, PinpadUtil
+- **源文档章节：** 3.35
+
+- Source section: `3.35`
+
+- Package/class path: `com.urovo.sdk.pinpad.PinPadProviderImpl`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/view/PinpadActivity.java and UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/utils/PinpadUtil.java`
+
+
+
+Purpose:
+The last error message.
+
+
+Signature/prototype:
+```java
+String getLastErrorMsg()
+```
+
+
+Parameters:
+Input
+None
+Output
+None
+
+
+Return value:
+The error message.
+
+
+Usage notes:
+Pinpad Error Code Definition
+Error Code
+Error Description
+0x00
+Success
+0x01
+Unsupported command
+0x02
+Command length error
+0x03
+Command separator error
+0x04
+Command separator length error
+0x05
+command head (CB) error
+0x06
+Data crc16 error
+0x07
+Message mac error
+0x09
+Message format error
+0x0C
+Unsupported algorithm
+0x0D
+Unsupported format
+0x0E
+Unsupported mode
+0x12
+Keys not ready or init
+0x14
+Keys number not found
+0x15
+Keys number out of range
+0x16
+Keys download
+0x17
+Keys not download
+0x18
+Keys out of space
+0x19
+Keys exists or can not be overwrite
+0x1A
+Keys encrypt keys not download
+0x1B
+Keys unsupported specified use
+0x1C
+Unsupported keys length
+0x1D
+Reserved
+0x28
+Unsupported pinblock format
+0x29
+Username length error
+0x2A
+Username value error
+0x2B
+User pinblock length error
+0x2C
+User pinblock value error
+0x2D
+Pinblock char error
+100
+Parameter is null or empty
+101
+Mismatch data length
+102
+Invalid data length
+103
+Invalid key index
+104
+Invalid parameter
+105
+InvalidRSA public key
+106
+Runtime exption
+
+
+Source details:
+```text
+Prototype
+String getLastErrorMsg()
+Description
+The last error message.
+Parameters
+Input
+None
+Output
+None
+Return
+The error message.
+Remark
+
+Pinpad Error Code Definition
+Error Code
+Error Description
+0x00
+Success
+0x01
+Unsupported command
+0x02
+Command length error
+0x03
+Command separator error
+0x04
+Command separator length error
+0x05
+command head (CB) error
+0x06
+Data crc16 error
+0x07
+Message mac error
+0x09
+Message format error
+0x0C
+Unsupported algorithm
+0x0D
+Unsupported format
+0x0E
+Unsupported mode
+0x12
+Keys not ready or init
+0x14
+Keys number not found
+0x15
+Keys number out of range
+0x16
+Keys download
+0x17
+Keys not download
+0x18
+Keys out of space
+0x19
+Keys exists or can not be overwrite
+0x1A
+Keys encrypt keys not download
+0x1B
+Keys unsupported specified use
+0x1C
+Unsupported keys length
+0x1D
+Reserved
+0x28
+Unsupported pinblock format
+0x29
+Username length error
+0x2A
+Username value error
+0x2B
+User pinblock length error
+0x2C
+User pinblock value error
+0x2D
+Pinblock char error
+Parameter is null or empty
+Mismatch data length
+Invalid data length
+Invalid key index
+Invalid parameter
+InvalidRSA public key
+Source note: section truncated for chunk size; consult the source document for remaining detailed tables (81 source lines total).
+```