@urovotest/urovosdk-docs-mcp 1.0.1

package/docs/02-reference/emv/emv-callback.md

@@ -0,0 +1,1155 @@
+---
+title: EMV Callback API
+module: EMV Callback
+domain: emv
+tags: ["emv", "emv-callback", "emv callback"]
+---
+# EMV Callback
+
+共 **19** 个 API/条目，来源 `emv_sdk.md`。
+
+## API 索引
+
+| 方法 | 类路径 | Demo Activity |
+|------|--------|---------------|
+| [onRequestSetAmount](#onrequestsetamount) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestConfirmCardno](#onrequestconfirmcardno) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onReturnCheckCardResult](#onreturncheckcardresult) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestSelectApplication](#onrequestselectapplication) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestPinEntry](#onrequestpinentry) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestFinalConfirm](#onrequestfinalconfirm) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestOnlineProcess](#onrequestonlineprocess) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onReturnBatchData](#onreturnbatchdata) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onReturnTransactionResult](#onreturntransactionresult) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestDisplayText](#onrequestdisplaytext) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestOfflinePinEntry](#onrequestofflinepinentry) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onRequestOfflinePINVerify](#onrequestofflinepinverify) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onReturnIssuerScriptResult](#onreturnissuerscriptresult) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onNFCrequestTipsConfirm](#onnfcrequesttipsconfirm) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onNFCrequestOnline](#onnfcrequestonline) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onNFCrequestImportPin](#onnfcrequestimportpin) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onNFCTransResult](#onnfctransresult) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onNFCErrorInfor](#onnfcerrorinfor) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+| [onReturnNfcCardData](#onreturnnfccarddata) | `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener` | EmvActivityNew |
+
+## onRequestSetAmount
+
+atstartEmv,thiscallback will not betriggered.Tocancelthe
+process,call cancelSetAmount.
+
+```java
+voidonRequestSetAmount()
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.01
+
+- Source section: `2.01`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+atstartEmv,thiscallback will not betriggered.Tocancelthe
+process,call cancelSetAmount.
+
+
+Signature/prototype:
+```java
+voidonRequestSetAmount()
+```
+
+
+Return value:
+None
+
+
+Simplified example:
+```java
+public void onRequestSetAmount() {
+    emv.setAmountEx(100L, 0L);
+}
+```
+
+
+Source details:
+```text
+Declare: voidonRequestSetAmount()
+Requestinput of amountin theEMV process.If amountis input
+Description: atstartEmv,thiscallback will not betriggered.Tocancelthe
+process,call cancelSetAmount.
+Return: None
+```
+
+## onRequestConfirmCardno
+
+Confirm theCardnumber,shouldcallsendConfirmCardnoResult(true)
+
+```java
+voidonRequestConfirmCardno()
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.02
+
+- Source section: `2.02`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Confirm theCardnumber,shouldcallsendConfirmCardnoResult(true)
+
+
+Signature/prototype:
+```java
+voidonRequestConfirmCardno()
+```
+
+
+Simplified example:
+```java
+public void onRequestConfirmCardno() {
+    emv.sendConfirmCardnoResult(true);
+}
+```
+
+
+Source details:
+```text
+Declare: voidonRequestConfirmCardno()
+Description: 
+Confirm theCardnumber,shouldcallsendConfirmCardnoResult(true)
+Return:
+```
+
+## onReturnCheckCardResult
+
+card.
+
+•Seeenum CheckCardResult
+Key: StripInfo
+
+```java
+checkCardResult, Hashtable<String,String>
+decodeData)
+Returntheresultsinresponsetoaswiped, insertedor tapped
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.03
+
+- Source section: `2.03`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+card.
+
+•Seeenum CheckCardResult
+Key: StripInfo
+
+
+Signature/prototype:
+```java
+checkCardResult, Hashtable<String,String>
+decodeData)
+Returntheresultsinresponsetoaswiped, insertedor tapped
+```
+
+
+Return value:
+CardNo
+
+
+Source details:
+```text
+voidonReturnCheckCardResult(CheckCardResult
+Declare: checkCardResult, Hashtable<String,String>
+decodeData)
+Returntheresultsinresponsetoaswiped, insertedor tapped
+Description: 
+card.
+
+•Seeenum CheckCardResult
+Key: StripInfo
+Return: CardNo
+```
+
+## onRequestSelectApplication
+
+canceltheprocess, call cancelSelectApplication.
+Returnalist of applications supportedbythemPOSdevice and
+
+```java
+voidonRequestSelectApplication(ArrayList<String> appList)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.04
+
+- Source section: `2.04`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+canceltheprocess, call cancelSelectApplication.
+Returnalist of applications supportedbythemPOSdevice and
+
+
+Signature/prototype:
+```java
+voidonRequestSelectApplication(ArrayList<String> appList)
+```
+
+
+Return value:
+theEMV chipcard.Theapplications aresortedbypriority,where
+index0 isthehighestpriority.
+
+
+Simplified example:
+```java
+public void onRequestSelectApplication(ArrayList<String> apps) {
+    emv.selectApplication(0);
+}
+```
+
+
+Source details:
+```text
+Declare: voidonRequestSelectApplication(ArrayList<String> appList)
+Requestselection of anapplication from thereturnedlist.To
+Description: 
+canceltheprocess, call cancelSelectApplication.
+Returnalist of applications supportedbythemPOSdevice and
+Return: theEMV chipcard.Theapplications aresortedbypriority,where
+index0 isthehighestpriority.
+```
+
+## onRequestPinEntry
+
+theprocess, call cancelPinEntry.This callbackcan betriggered
+bystartKernel.
+IndicatethePINentrysource, seePinEntrySource
+
+```java
+voidonRequestPinEntry(PinEntrySource pinEntrySource)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.05
+
+- Source section: `2.05`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+theprocess, call cancelPinEntry.This callbackcan betriggered
+bystartKernel.
+IndicatethePINentrysource, seePinEntrySource
+
+
+Signature/prototype:
+```java
+voidonRequestPinEntry(PinEntrySource pinEntrySource)
+```
+
+
+Return value:
+enumeration.
+
+
+Simplified example:
+```java
+public void onRequestPinEntry(ContantPara.PinEntrySource source) {
+    emv.sendPinEntry();
+}
+```
+
+
+Source details:
+```text
+Declare: voidonRequestPinEntry(PinEntrySource pinEntrySource)
+RequestPIN entryfrom thespecifiedPinEntrySource.Tocancel
+Description: theprocess, call cancelPinEntry.This callbackcan betriggered
+bystartKernel.
+IndicatethePINentrysource, seePinEntrySource
+Return: 
+enumeration.
+```
+
+## onRequestFinalConfirm
+
+thefirst generateAC command.Toproceedor cancelthe
+transaction, call sendFinalConfirmResult.
+
+```java
+voidonRequestFinalConfirm()
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.06
+
+- Source section: `2.06`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+thefirst generateAC command.Toproceedor cancelthe
+transaction, call sendFinalConfirmResult.
+
+
+Signature/prototype:
+```java
+voidonRequestFinalConfirm()
+```
+
+
+Return value:
+None
+
+
+Source details:
+```text
+Declare: voidonRequestFinalConfirm()
+TheEMV processrequest fora finalconfirmation beforecalling
+Description: thefirst generateAC command.Toproceedor cancelthe
+transaction, call sendFinalConfirmResult.
+Return: None
+```
+
+## onRequestOnlineProcess
+
+transaction, call sendOnlineProcessResult.
+
+Aset of transaction datainTag-Length-Valueformatthat should
+besent backtoonline server.
+
+```java
+voidonRequestOnlineProcess(String tlv,StringdataKsn)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.07
+
+- Source section: `2.07`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+transaction, call sendOnlineProcessResult.
+
+Aset of transaction datainTag-Length-Valueformatthat should
+besent backtoonline server.
+
+
+Signature/prototype:
+```java
+voidonRequestOnlineProcess(String tlv,StringdataKsn)
+```
+
+
+Return value:
+Tlv:TLVdata
+dataKsn:KSN fordataencryption
+
+
+Simplified example:
+```java
+public void onRequestOnlineProcess(String cardTlvData, String dataKsn) {
+    // Send cardTlvData as field 55, then return issuer TLV.
+    emv.sendOnlineProcessResult("8A023030");
+}
+```
+
+
+Source details:
+```text
+Declare: voidonRequestOnlineProcess(String tlv,StringdataKsn)
+Requestthetransactiongo online.Toproceedor terminatethe
+Description: 
+transaction, call sendOnlineProcessResult.
+
+Aset of transaction datainTag-Length-Valueformatthat should
+besent backtoonline server.
+Return: 
+Tlv:TLVdata
+dataKsn:KSN fordataencryption
+```
+
+## onReturnBatchData
+
+Returnthebatchdataafter completionof an EMV transaction.
+Aset of transaction datainTag-Length-Valueformatthat should
+
+```java
+voidonReturnBatchData(String tlv)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.08
+
+- Source section: `2.08`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Returnthebatchdataafter completionof an EMV transaction.
+Aset of transaction datainTag-Length-Valueformatthat should
+
+
+Signature/prototype:
+```java
+voidonReturnBatchData(String tlv)
+```
+
+
+Return value:
+besent backtoserver forprocessing.(Usein offlineapprove)
+
+
+Source details:
+```text
+Declare: voidonReturnBatchData(String tlv)
+Description: Returnthebatchdataafter completionof an EMV transaction.
+Aset of transaction datainTag-Length-Valueformatthat should
+Return: 
+besent backtoserver forprocessing.(Usein offlineapprove)
+```
+
+## onReturnTransactionResult
+
+Returnthetransactionresult.
+Indicatethetransactionresult, seeTransactionResult
+
+```java
+voidonReturnTransactionResult(TransactionResult transResult)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.09
+
+- Source section: `2.09`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Returnthetransactionresult.
+Indicatethetransactionresult, seeTransactionResult
+
+
+Signature/prototype:
+```java
+voidonReturnTransactionResult(TransactionResult transResult)
+```
+
+
+Return value:
+enumeration.
+
+
+Simplified example:
+```java
+public void onReturnTransactionResult(ContantPara.TransactionResult result) {
+    if (result == ContantPara.TransactionResult.ONLINE_APPROVAL ||
+        result == ContantPara.TransactionResult.OFFLINE_APPROVAL) {
+        // complete approved transaction
+    } else {
+        // decline, reverse, or show failure according to business rules
+    }
+}
+```
+
+
+Source details:
+```text
+Declare: voidonReturnTransactionResult(TransactionResult transResult)
+Description: Returnthetransactionresult.
+Indicatethetransactionresult, seeTransactionResult
+Return: 
+enumeration.
+```
+
+## onRequestDisplayText
+
+Returnthemessage toprompt customer.
+Indicatethemessageto bedisplayed, seeDisplayText
+
+```java
+voidonRequestDisplayText(DisplayText displayText)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.10
+
+- Source section: `2.10`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Returnthemessage toprompt customer.
+Indicatethemessageto bedisplayed, seeDisplayText
+
+
+Signature/prototype:
+```java
+voidonRequestDisplayText(DisplayText displayText)
+```
+
+
+Return value:
+enumeration.
+
+
+Source details:
+```text
+Declare: voidonRequestDisplayText(DisplayText displayText)
+Description: Returnthemessage toprompt customer.
+Indicatethemessageto bedisplayed, seeDisplayText
+Return: 
+enumeration.
+```
+
+## onRequestOfflinePinEntry
+
+Usuallynotuse
+
+```java
+pinEntrySource,int PinTryCount);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.11
+
+- Source section: `2.11`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Usuallynotuse
+
+
+Signature/prototype:
+```java
+pinEntrySource,int PinTryCount);
+```
+
+
+Source details:
+```text
+voidonRequestOfflinePinEntry(ContantPara.PinEntrySource
+Declare: 
+pinEntrySource,int PinTryCount);
+Description: Usuallynotuse
+Return:
+```
+
+## onRequestOfflinePINVerify
+
+Offlinepinverify(use inAndroidos8.0)
+
+```java
+pinEntrySource,int pinEntryType, Bundlebundle);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.12
+
+- Source section: `2.12`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Offlinepinverify(use inAndroidos8.0)
+
+
+Signature/prototype:
+```java
+pinEntrySource,int pinEntryType, Bundlebundle);
+```
+
+
+Parameters:
+pinEntrySource-seeeuam ContantPara.PinEntrySource
+
+pinEntryType:0-----Offline PlainPin1--- OfflineencryptionPin
+bundle:key: ModuleLen
+
+
+Return value:
+Module
+ExponentLen
+Exponent
+
+
+Usage notes:
+Pleasecheckthesampledemoapp
+
+
+Simplified example:
+```java
+public void onRequestOfflinePINVerify(ContantPara.PinEntrySource source, int type, Bundle data) {
+    int retries = emv.getOfflinePinTryTimes();
+    // collect offline PIN, then call sendOfflinePINVerifyResult(result) when required
+}
+```
+
+
+Source details:
+```text
+voidonRequestOfflinePINVerify(ContantPara.PinEntrySource
+Declare: 
+pinEntrySource,int pinEntryType, Bundlebundle);
+Description: Offlinepinverify(use inAndroidos8.0)
+Parameters: pinEntrySource-seeeuam ContantPara.PinEntrySource
+
+pinEntryType:0-----Offline PlainPin1--- OfflineencryptionPin
+bundle:key: ModuleLen
+Return: Module
+ExponentLen
+Exponent
+Remark: Pleasecheckthesampledemoapp
+```
+
+## onReturnIssuerScriptResult
+
+Tlv:-field55data
+
+```java
+onReturnIssuerScriptResult(ContantPara.IssuerScriptResult
+scriptResult,String tlv)
+ReturnScriptResult,tagDF31isscarptresult
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.13
+
+- Source section: `2.13`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Tlv:-field55data
+
+
+Signature/prototype:
+```java
+onReturnIssuerScriptResult(ContantPara.IssuerScriptResult
+scriptResult,String tlv)
+ReturnScriptResult,tagDF31isscarptresult
+```
+
+
+Return value:
+none
+
+
+Source details:
+```text
+void
+Declare: onReturnIssuerScriptResult(ContantPara.IssuerScriptResult
+scriptResult,String tlv)
+ReturnScriptResult,tagDF31isscarptresult
+Description: 
+Tlv:-field55data
+Return: none
+```
+
+## onNFCrequestTipsConfirm
+
+messageID:checkenumNfcTipMessageID
+msg:
+PLS_REMOVE_CARD,
+PLS_USE_CONTACT_IC_CARD,//1
+NEED_SIGNATURE,//2
+END_APPLICATION,//3
+SEE_PHONE_REMOVE_AND_PRESENT_CARD,//4
+DISPLAY_BALANCE,//5
+
+```java
+messageID,Stringmsg);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.14
+
+- Source section: `2.14`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+messageID:checkenumNfcTipMessageID
+msg:
+PLS_REMOVE_CARD,
+PLS_USE_CONTACT_IC_CARD,//1
+NEED_SIGNATURE,//2
+END_APPLICATION,//3
+SEE_PHONE_REMOVE_AND_PRESENT_CARD,//4
+DISPLAY_BALANCE,//5
+
+
+Signature/prototype:
+```java
+messageID,Stringmsg);
+```
+
+
+Parameters:
+CARD_READ_OK,//6
+PLS_SECOND_TAP_CARD,//7
+APPLICATION_BLOCKED,//8
+TRY_AGAIN_RESENT_CARD,//9
+USE_MAG_STRIPE,//10
+INSERT_SWIPE_OR_TRY_ANOTHER_CARD,//11
+TERMINATE,
+CARD_ERROR,
+PROCESSING_ERROR,
+UNKNOW
+
+
+Usage notes:
+CalledatprocessPayPassKernel
+
+
+Source details:
+```text
+void onNFCrequestTipsConfirm(ContantPara.NfcTipMessageID
+Declare: 
+messageID,Stringmsg);
+Requestapplicationdisplaymassage.
+Description: 
+messageID:checkenumNfcTipMessageID
+msg:
+PLS_REMOVE_CARD,
+PLS_USE_CONTACT_IC_CARD,//1
+NEED_SIGNATURE,//2
+END_APPLICATION,//3
+SEE_PHONE_REMOVE_AND_PRESENT_CARD,//4
+DISPLAY_BALANCE,//5
+Parameters: CARD_READ_OK,//6
+PLS_SECOND_TAP_CARD,//7
+APPLICATION_BLOCKED,//8
+TRY_AGAIN_RESENT_CARD,//9
+USE_MAG_STRIPE,//10
+INSERT_SWIPE_OR_TRY_ANOTHER_CARD,//11
+TERMINATE,
+CARD_ERROR,
+PROCESSING_ERROR,
+UNKNOW
+
+Remark: CalledatprocessPayPassKernel
+```
+
+## onNFCrequestOnline
+
+Whentransactionneedgoonline
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+
+```java
+void onNFCrequestOnline (Hashtable<String,String>hashtable);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.15
+
+- Source section: `2.15`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Whentransactionneedgoonline
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+
+
+Signature/prototype:
+```java
+void onNFCrequestOnline (Hashtable<String,String>hashtable);
+```
+
+
+Parameters:
+"TRACKDATA" :customformatdata,usuallynotuse
+"EMVDATA":contactlesstransactionTLVdata
+
+
+Return value:
+If0x5A(PAN)isnotreturned,pleaseParsingtag0x57togetPAN,if0x57
+
+
+Usage notes:
+is not returned, please check whether it's a mstrip card. For mastercard
+mstriptheTrack2EquivalentDatawillbesaveattag0x9f6b
+
+
+Source details:
+```text
+Declare: void onNFCrequestOnline (Hashtable<String,String>hashtable);
+Description: Whentransactionneedgoonline
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+Parameters: "TRACKDATA" :customformatdata,usuallynotuse
+"EMVDATA":contactlesstransactionTLVdata
+Return: 
+If0x5A(PAN)isnotreturned,pleaseParsingtag0x57togetPAN,if0x57
+Remark: is not returned, please check whether it's a mstrip card. For mastercard
+mstriptheTrack2EquivalentDatawillbesaveattag0x9f6b
+```
+
+## onNFCrequestImportPin
+
+ParametersNotusednow
+Callthepasswordkeyboardinthiscallbackfunction,youmayneedtoget
+thecardnumber
+
+```java
+voidonNFCrequestImportPin (int type, int lasttimeFlag, Stringamt);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.16
+
+- Source section: `2.16`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+ParametersNotusednow
+Callthepasswordkeyboardinthiscallbackfunction,youmayneedtoget
+thecardnumber
+
+
+Signature/prototype:
+```java
+voidonNFCrequestImportPin (int type, int lasttimeFlag, Stringamt);
+```
+
+
+Parameters:
+You can get the card number through tag5A, if tag5A is empty, you can
+getthecardnumberthroughtag57
+
+
+Source details:
+```text
+Declare: voidonNFCrequestImportPin (int type, int lasttimeFlag, Stringamt);
+ContactlessrequestimportPIN
+Description: 
+ParametersNotusednow
+Callthepasswordkeyboardinthiscallbackfunction,youmayneedtoget
+thecardnumber
+Parameters: 
+You can get the card number through tag5A, if tag5A is empty, you can
+getthecardnumberthroughtag57
+Return: 
+Remark:
+```
+
+## onNFCTransResult
+
+Returnthetransactionresulttoapplication
+
+Result:
+CheckenumNfcTransResult
+ONLINE_APPROVAL,
+DECLINE_ONLINE,
+TERMINATE,
+OFFLINE_APPROVAL,
+
+```java
+voidonNFCTransResult(ContantPara.NfcTransResultresult);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.17
+
+- Source section: `2.17`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Returnthetransactionresulttoapplication
+
+Result:
+CheckenumNfcTransResult
+ONLINE_APPROVAL,
+DECLINE_ONLINE,
+TERMINATE,
+OFFLINE_APPROVAL,
+
+
+Signature/prototype:
+```java
+voidonNFCTransResult(ContantPara.NfcTransResultresult);
+```
+
+
+Parameters:
+OTHER_INTERFACES,
+RETRY,
+CARD_REMOVED,
+ISSUER_SCRIPT_UPDATE_SUCCESSFUL,//8
+ISSUER_SCRIPT_UPDATE_FAILED,//9
+DECLINE_OFFLINE
+None
+
+
+Return value:
+If the result is OFFLINE_APPROVAL, please call getNfcCvmCode() to
+get the CVM (Cardholder Verification Method) code. Then, If the return
+
+
+Usage notes:
+value of the CVM code is 0x10 (indicating signature required), then
+requireasignaturewhenprintingtheslip.
+
+
+Source details:
+```text
+Declare: voidonNFCTransResult(ContantPara.NfcTransResultresult);
+Description: Returnthetransactionresulttoapplication
+
+Result:
+CheckenumNfcTransResult
+ONLINE_APPROVAL,
+DECLINE_ONLINE,
+TERMINATE,
+OFFLINE_APPROVAL,
+Parameters: 
+OTHER_INTERFACES,
+RETRY,
+CARD_REMOVED,
+ISSUER_SCRIPT_UPDATE_SUCCESSFUL,//8
+ISSUER_SCRIPT_UPDATE_FAILED,//9
+DECLINE_OFFLINE
+None
+Return: 
+If the result is OFFLINE_APPROVAL, please call getNfcCvmCode() to
+get the CVM (Cardholder Verification Method) code. Then, If the return
+Remark: 
+value of the CVM code is 0x10 (indicating signature required), then
+requireasignaturewhenprintingtheslip.
+```
+
+## onNFCErrorInfor
+
+Contactlesstransactionerrorcallbackfunction
+errID:checkenum NfcErrMessageID
+strErrInfo:
+ERR_LOAD_CALLBACK,
+ICS_PARAM_NOT_FIND,
+KERNEL_ERR,
+
+```java
+strErrInfo);
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.18
+
+- Source section: `2.18`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+Contactlesstransactionerrorcallbackfunction
+errID:checkenum NfcErrMessageID
+strErrInfo:
+ERR_LOAD_CALLBACK,
+ICS_PARAM_NOT_FIND,
+KERNEL_ERR,
+
+
+Signature/prototype:
+```java
+strErrInfo);
+```
+
+
+Parameters:
+ERR_PIN_LENTH,
+ERR_MULT_CARD,
+ERR_CHECK_CARD,
+AID_PARAM_NOT_FIND,
+CAPK_PARAM_NOT_FIND,
+GET_KERNEL_DATA_FAILED,
+QPBOC_FDDA_FAILED,
+PURE_ELE_CASH_CARD_NOT_ALLOW_ONLINE_TRANS,
+
+
+Source details:
+```text
+void onNFCErrorInfor (ContantPara.NfcErrMessageID errID, String
+Declare: 
+strErrInfo);
+Description: Contactlesstransactionerrorcallbackfunction
+errID:checkenum NfcErrMessageID
+strErrInfo:
+ERR_LOAD_CALLBACK,
+ICS_PARAM_NOT_FIND,
+KERNEL_ERR,
+Parameters: ERR_PIN_LENTH,
+ERR_MULT_CARD,
+ERR_CHECK_CARD,
+AID_PARAM_NOT_FIND,
+CAPK_PARAM_NOT_FIND,
+GET_KERNEL_DATA_FAILED,
+QPBOC_FDDA_FAILED,
+PURE_ELE_CASH_CARD_NOT_ALLOW_ONLINE_TRANS,
+Return: 
+
+Remark:
+```
+
+## onReturnNfcCardData
+
+ReturncontactlesstransactionTLVdata
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+
+```java
+public void onReturnNfcCardData(Hashtable<String,String>hashtable)
+```
+
+- **类路径：** `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+- **Demo Activity（参考）：** EmvActivityNew
+- **源文档章节：** 2.19
+
+- Source section: `2.19`
+
+- Package/class path: `com.urovo.i9000s.api.emv.EmvNfcKernelApi` / `com.urovo.i9000s.api.emv.EmvListener`
+
+- Demo reference: `UrovoPosSdkDemo/app/src/main/java/com/urovo/sdk/emv/EmvActivityNew.java`
+
+
+
+Purpose:
+ReturncontactlesstransactionTLVdata
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+
+
+Signature/prototype:
+```java
+public void onReturnNfcCardData(Hashtable<String,String>hashtable)
+```
+
+
+Parameters:
+"TRACKDATA" :customformatdata,usuallynotuse
+"EMVDATA":contactlesstransactionTLVdata
+"QPBOCTYPE":ifnotsupportQPBOC,itisNULL
+If0x5A(PAN)isnotreturned,pleaseParsingtag0x57togetPAN,if0x57
+
+
+Usage notes:
+is not returned, please check whether it's a mstrip card. For mastercard
+mstriptheTrack2EquivalentDatawillbesaveattag0x9F6B
+3.EMV Enum
+
+
+Source details:
+```text
+Declare: public void onReturnNfcCardData(Hashtable<String,String>hashtable)
+Description: ReturncontactlesstransactionTLVdata
+Hashtable:
+"KSN" :customformatksn,usuallynotuse
+Parameters: 
+"TRACKDATA" :customformatdata,usuallynotuse
+"EMVDATA":contactlesstransactionTLVdata
+"QPBOCTYPE":ifnotsupportQPBOC,itisNULL
+If0x5A(PAN)isnotreturned,pleaseParsingtag0x57togetPAN,if0x57
+Remark: is not returned, please check whether it's a mstrip card. For mastercard
+mstriptheTrack2EquivalentDatawillbesaveattag0x9F6B
+3.EMV Enum
+```