Professional Documents
Culture Documents
EMV
Interface Description
1
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
版本修订历史记录:
2
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
目录
1. EMV 类.....................................................................................................................................5
1.1. 读取 EMV 内核版本号............................................................................................5
1.2. 删除所有 AID............................................................................................................5
1.3. 删除所有 CAPK..........................................................................................................5
1.4. 获取 AID 列表总数...................................................................................................6
1.5. 获取 Capk 列表总数.................................................................................................6
1.6. 根据索引号获取一条 AID 列表..............................................................................7
1.7. 根据索引号获取一条 Capk.....................................................................................7
1.8. 追加一条 AID...........................................................................................................7
1.9. 追加一条 Capk.........................................................................................................8
1.10. 追加一条 AID...........................................................................................................9
1.11. 追加一条 Capk.........................................................................................................9
1.12. 从内核获取 tag 的值.............................................................................................10
1.13. 设置 tag 的值到内核.............................................................................................10
1.14. 打包 TLV 结构的数据............................................................................................11
1.15. 从内核获取 tag 数据,打包 TLV 结构的数据.........................................................11
1.16. 打包 TLV 列表数据................................................................................................12
1.17. EMV 内核初始化......................................................................................................12
1.18. 非接交易预处理.....................................................................................................12
1.19. 执行 EMV 交易(包括非接交易)............................................................................13
1.20. 余额查询................................................................................................................13
1.21. 读交易日志............................................................................................................14
1.22. 读二磁道信息和银行卡号.....................................................................................15
1.23. 获取 CVM 类型(非接专用)...................................................................................16
1.24. 将 PIN BLOCK 设置到内核..................................................................................16
1.25. 解析联机响应数据.................................................................................................17
2. OnEmvListener 回调类..........................................................................................................18
2.1. 选择应用回调.........................................................................................................18
2.2. 确认卡号回调.........................................................................................................18
2.3. 输入 PIN 回调........................................................................................................19
2.4. 持卡人证件验证回调.............................................................................................20
2.5. 联机处理回调.........................................................................................................21
3. EMVReturn 结果类................................................................................................................23
3
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
4
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
2. EMV Class
Stuct
Remarks
Example
5
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Output
Return
Stuct
Remarks
Example
Stuct
Remarks
Example
6
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Stuct
Remarks
Example
Output
Return A string of AID data in TLV format
=null, get error
Stuct
Remarks
Output
Return A string of Capk data in TLV format
=null, get error
Stuct
Example
Stuct
Remarks
Output
Return
Stuct
Remarks
8
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
emvHandler.addApp(emvHandler .
hexStringToBytes
("9F0605A0000000659F220109DF05
083230303931323331DF060101DF07
0101DF028180B72A8FEF5B27F2B55
0398FDCC256F714BAD497FF56094
B7408328CB626AA6F0E6A9DF8388
EB9887BC930170BCC1213E90FC07
0D52C8DCD0FF9E10FAD36801FE93
FC998A721705091F18BC7C98241C
ADC15A2B9DA7FB963142C0AB640
D5D0135E77EBAE95AF1B4FEFAD
CF9C012366BDDA0455C1564A6881
0D7127676D493890BDDF040103DF
03144410C6D51C2F83ADFD92528F
A6E38A32DF048D0A")
Output
Return
Stuct
Remarks
Example
Output
9
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Return
Stuct
Remarks
Example
kernel
0x95 TVR
0x9B TSI
0x5A PAN
Output
Return Get the value of the tag
Stuct
Remarks
Example
10
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
value value
Output
Return The value of the EmvResult object
Stuct
Remarks
Example
Output
Return TLV format data
Stuct
Remarks
Example
11
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
value value
Return
Stuct
Remarks
Example
Stuct
Remarks
Example
12
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Stuct
Remarks
Example
Output
Return
Stuct
Remarks
13
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Output
Return The value of the EmvResult object
Stuct
Remarks
Example
contactless transactions)
14
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Stuct
Remarks
Example
object:
KERNAL_EMV_PBOC = 0; //Contact
EMV&PBOC
KERNAL_CONTACTLESS_ENTRY_
entry
obtained
Stuct
Remarks
Example
15
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
object:
KERNAL_EMV_PBOC = 0; //Contact
EMV&PBOC
KERNAL_CONTACTLESS_ENTRY_
entry
returned in transLogNum[0]
when defined.
Stuct
Remarks
Example
16
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Input
Output track2 Track 2 data, the data is returned in
track2[0]
Stuct
Remarks
Example
Input
Output
Return the following values for the EmvData
object:
17
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
=
0x00; //NO CVM
public static final
byte RD_CVM_ONLINE_PIN
= (byte)0x80;
//ONLINE PIN
public static final
byte RD_CVM_SIG
=
0x40; //SIGNATURE
Stuct
Remarks
Example
18
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
issuerResp,int issuerRespLen)
Description Parsing online response data
39 domain response code (if the
Output
The following values for the
EmvResult object:
Public static final int EMV_OK =
0; //OK
Public static final int
EMV_ONLINE_FAILED = -20;
Return //Unsuccessful online connection failed
Public static final int
EMV_ONLINE_NORESP_MAC_OR
_RECV_ERR = -38; // Online
unsuccessful, no response online or
return MAC error or receive data error,
correct
Stuct
Remarks
Example
19
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Output
Return The APDU data of the response,
Stuct
Remarks
20
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
multiple applications;
Contactlss do not execute this callback
Output
Return Public static final int EMV_OK =
0; //OK
EMV_USER_CANCEL = -7;
//transaction cancellation
Stuct
Remarks
Output
Return Public static final int EMV_OK =
0; //OK
EMV_USER_CANCEL = -7;
//transaction cancellation
21
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
Stuct
Remarks
RD_CVM_ONLINE_PIN) to execute the input online PIN. If you want to force the
object:
OFFLINE_ENCIPHERED_PIN =
0x02;
Output
22
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
object:
0; //OK
EMV_USER_CANCEL = -7;
//transaction cancellation
password or no password
Stuct
Remarks
be executed;
following values
0x00: ID card
0x02: Passport
23
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
0x05: Other
Output
Return The following values for the
EmvResult object:
0; //OK
EMV_USER_CANCEL = -7;
//transaction cancellation
Stuct
Remarks
If the connection is successful, the issuing bank authorization response code [8A]
Input
Output
Return The following values for the
EmvResult object:
Public static final int EMV_OK
24
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
= 0; //OK
EMV_ONLINE_FAILED = -20;
//Unsuccessful online
connection failed
EMV_ONLINE_NORESP_MAC_OR_RECV_
unsuccessful, no response
EMV_ONLINE_RESP_AAC = -40;
returns rejection
Stuct
Remarks
25
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
4. Annex
26
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
27
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
28
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
package com.zcs.sdk.emv;
29
Shenzhen ZCS Technology Co., Ltd EMV Interface Description
30