http://sdkwiki.wizarpos.com/api.php?action=feedcontributions&feedformat=atom&user=Mahong
wizarPOS - User contributions [en]
2026-07-08T19:27:34Z
User contributions
MediaWiki 1.39.5
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5556
Payment Apps
2026-07-08T06:25:03Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.9_2605251.apk Payment Emulator2.3.9]<br />
* [https://ftp.wizarpos.com/paymentPayWizard_APP_V2.12.0-global-release.apk PayWizard_V2.12.0]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5555
Firmware
2026-07-03T07:18:40Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[SDK杂记]]<br />
<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android-0603.zip Next指纹新的SDKnbbiometrics-scan-and-extract-sample-android-0603.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电, Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/RelayAndPulseDemo-init_modified260304.zip 源码relaypulsedemo][https://ftp.wizarpos.com/techsupport/software/relayDemo-1.0.exboard.apk relaypulsedemo apk] 调用exboard, 测试pulse（参数可设置），relay(参数不可设置)<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App&diff=5554
Payment App
2026-07-03T04:03:53Z
<p>Mahong: </p>
<hr />
<div>[[Quick Start]]<br />
<br />
[[Windows Debug Tools]]<br />
<br />
[[Core Protocol|Core Protocol(Important Payment Communication Protocols)]]<br />
<br />
[[Payment Apps|Payment Apps(Usually installed by WizarPOS)]]<br />
<br />
[[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]]<br />
<br />
[[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]]<br />
<br />
[[Cloud Mode Integration]]<br />
<br />
[[Payment App Development]]<br />
<br />
[[Common Feature Development]]<br />
<br />
[https://ftp.wizarpos.com/payment/WizarPOS_Integration_Certification_Letter.docx WizarPOS_Integration_Certification_Letter.docx]<br />
<br />
[https://ftp.wizarpos.com/payment/PAYwizardTestCasev1.0.xlsm PAYwizard Test Case v1.0.xlsm]<br />
<br />
[https://docs.google.com/spreadsheets/d/1l2oXztWAOHN48vEPOS_BQU1Q1HZuoWNz4RwcDHSygfo/edit?usp=sharing Cloud Integration Test Case]<br />
<br />
[https://docs.google.com/spreadsheets/d/1iFdDG9zqkNiNrM_-Me83XgAOViz-zGiH9xueBQlNWNY/edit?usp=sharing Aidl Intergration & Core Payment Test Case]<br />
<br />
[[Chinese Document]]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App&diff=5553
Payment App
2026-07-03T04:03:38Z
<p>Mahong: </p>
<hr />
<div>[[Quick Start]]<br />
<br />
[[Windows Debug Tools]]<br />
<br />
[[Core Protocol|Core Protocol(Important Payment Communication Protocols)]]<br />
<br />
[[Payment Apps|Payment Apps(Usually installed by WizarPOS)]]<br />
<br />
[[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]]<br />
<br />
[[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]]<br />
<br />
[[Cloud Mode Integration]]<br />
<br />
[[Payment App Development]]<br />
<br />
[[Common Feature Development]]<br />
<br />
[https://ftp.wizarpos.com/payment/WizarPOS_Integration_Certification_Letter.docx WizarPOS_Integration_Certification_Letter.docx]<br />
<br />
[https://ftp.wizarpos.com/payment/PAYwizardTestCasev1.0.xlsm PAYwizard Test Case v1.0.xlsm]<br />
<br />
[https://docs.google.com/spreadsheets/d/1l2oXztWAOHN48vEPOS_BQU1Q1HZuoWNz4RwcDHSygfo/edit?usp=sharing Cloud Integration Test Case]<br />
<br />
[https://docs.google.com/spreadsheets/d/1iFdDG9zqkNiNrM_-Me83XgAOViz-zGiH9xueBQlNWNY/edit?usp=sharing]<br />
<br />
[[Chinese Document]]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App&diff=5552
Payment App
2026-07-03T04:02:53Z
<p>Mahong: </p>
<hr />
<div>[[Quick Start]]<br />
<br />
[[Windows Debug Tools]]<br />
<br />
[[Core Protocol|Core Protocol(Important Payment Communication Protocols)]]<br />
<br />
[[Payment Apps|Payment Apps(Usually installed by WizarPOS)]]<br />
<br />
[[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]]<br />
<br />
[[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]]<br />
<br />
[[Cloud Mode Integration]]<br />
<br />
[[Payment App Development]]<br />
<br />
[[Common Feature Development]]<br />
<br />
[https://ftp.wizarpos.com/payment/WizarPOS_Integration_Certification_Letter.docx WizarPOS_Integration_Certification_Letter.docx]<br />
<br />
[https://ftp.wizarpos.com/payment/PAYwizardTestCasev1.0.xlsm PAYwizard Test Case v1.0.xlsm]<br />
<br />
[https://docs.google.com/spreadsheets/d/1l2oXztWAOHN48vEPOS_BQU1Q1HZuoWNz4RwcDHSygfo/edit?usp=sharing]<br />
<br />
[https://docs.google.com/spreadsheets/d/1iFdDG9zqkNiNrM_-Me83XgAOViz-zGiH9xueBQlNWNY/edit?usp=sharing]<br />
<br />
[[Chinese Document]]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App&diff=5551
Payment App
2026-07-03T04:02:35Z
<p>Mahong: </p>
<hr />
<div>[[Quick Start]]<br />
<br />
[[Windows Debug Tools]]<br />
<br />
[[Core Protocol|Core Protocol(Important Payment Communication Protocols)]]<br />
<br />
[[Payment Apps|Payment Apps(Usually installed by WizarPOS)]]<br />
<br />
[[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]]<br />
<br />
[[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]]<br />
<br />
[[Cloud Mode Integration]]<br />
<br />
[[Payment App Development]]<br />
<br />
[[Common Feature Development]]<br />
<br />
[https://ftp.wizarpos.com/payment/WizarPOS_Integration_Certification_Letter.docx WizarPOS_Integration_Certification_Letter.docx]<br />
<br />
[https://ftp.wizarpos.com/payment/PAYwizardTestCasev1.0.xlsm [ENG]PAYwizard Test Case v1.0.xlsm]<br />
<br />
[https://docs.google.com/spreadsheets/d/1l2oXztWAOHN48vEPOS_BQU1Q1HZuoWNz4RwcDHSygfo/edit?usp=sharing]<br />
<br />
[https://docs.google.com/spreadsheets/d/1iFdDG9zqkNiNrM_-Me83XgAOViz-zGiH9xueBQlNWNY/edit?usp=sharing]<br />
<br />
[[Chinese Document]]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App&diff=5550
Payment App
2026-07-03T04:02:14Z
<p>Mahong: </p>
<hr />
<div>[[Quick Start]]<br />
<br />
[[Windows Debug Tools]]<br />
<br />
[[Core Protocol|Core Protocol(Important Payment Communication Protocols)]]<br />
<br />
[[Payment Apps|Payment Apps(Usually installed by WizarPOS)]]<br />
<br />
[[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]]<br />
<br />
[[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]]<br />
<br />
[[Cloud Mode Integration]]<br />
<br />
[[Payment App Development]]<br />
<br />
[[Common Feature Development]]<br />
<br />
[https://ftp.wizarpos.com/payment/WizarPOS_Integration_Certification_Letter.docx WizarPOS_Integration_Certification_Letter.docx]<br />
<br />
[https://ftp.wizarpos.com/payment/[ENG]PAYwizardTestCasev1.0.xlsm [ENG]PAYwizard Test Case v1.0.xlsm]<br />
<br />
[https://docs.google.com/spreadsheets/d/1l2oXztWAOHN48vEPOS_BQU1Q1HZuoWNz4RwcDHSygfo/edit?usp=sharing]<br />
<br />
[https://docs.google.com/spreadsheets/d/1iFdDG9zqkNiNrM_-Me83XgAOViz-zGiH9xueBQlNWNY/edit?usp=sharing]<br />
<br />
[[Chinese Document]]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Internal_Integration_(POS_App_Development)&diff=5549
Internal Integration (POS App Development)
2026-06-30T07:04:22Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing normal applications on the terminal. The application can call the AIDL interface provided by the PAYWizard application to perform different types of transactions. In this mode, PAYWizard does not communicate with the Vendor Machine; the self-developed application is responsible for communicating with the Vendor Machine.<br />
<br />
===PAYWizard AIDL interface:===<br />
[https://github.com/SmartPOSSamples/PayMentAIDLDemo/blob/main/app/src/main/aidl/com/wizarpos/payment/aidl/IPaymentPay.aidl Paywizard IPaymentPay.aidl]<br />
<br />
[https://github.com/SmartPOSSamples/PayMentAIDLDemo/blob/main/app/src/main/aidl/com/wizarpos/payment/aidl/IPaymentPayCallback.aidl Paywizard PaymentPayCallback.aidl]<br />
===PayMentAIDLDemo===<br />
[https://github.com/SmartPOSSamples/PayMentAIDLDemo PayMentAIDLDemo]<br />
===Core Protocol===<br />
Please send and receive data according to this protocal document:[[Core Protocol]]<br />
===Flow===<br />
[https://ftp.wizarpos.com/techsupport/ticket/flowchartofdevelopnormalapp.png Here is a flowchart]<br />
===APK===<br />
[https://ftp.wizarpos.com/payment/PayMentAidlDemo_release_V1.0.6_20260114.apk PayMentAidlDemo_release_V1.0.6_20260114]<br />
<br />
See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/internal-integration internal-integration]<br />
<br />
====Best practice for payment in D22(D3)/Q3(Q2)====<br />
For developing applications on the D22.<br />
* Install [https://ftp.wizarpos.com/payment/AccessoryAgentHostService-master-release-v1.0.30-r20251208115422-q1_platform.apk the new accessory agent] on D22(D3)/Q3(Q2)<br />
* Install initconnectionmode on D22/Q3, configure master and slave. This step is usually pre-initialized at the factory and does not require further configuration by the customer.<br />
* Install PAYwizard app on D22/Q3<br />
* Set protocal of PAYwizard to DEFAULT on D22, and set the payment package name to com.wizarpos.opc<br />
* Set protocal of PAYwizard to USB ACCESSORY on Q3, and set the payment package name to com.wizarpos.paywizard.demo</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5548
Payment Apps
2026-06-17T09:31:50Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.9_2605251.apk Payment Emulator2.3.9]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_APP_V2.11.0-global-release.apk PayWizard_V2.11.0]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5547
Firmware
2026-06-10T09:26:44Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[SDK杂记]]<br />
<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android-0603.zip Next指纹新的SDKnbbiometrics-scan-and-extract-sample-android-0603.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/RelayAndPulseDemo-init_modified260304.zip 源码relaypulsedemo][https://ftp.wizarpos.com/techsupport/software/relayDemo-1.0.exboard.apk relaypulsedemo apk] 调用exboard, 测试pulse（参数可设置），relay(参数不可设置)<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5546
SDK杂记
2026-06-03T09:23:28Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
<br />
com.cloudpos.TerminalSpec<br />
<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver><br />
==对于在Q1K/Q2pro上，persist.wp.hw.customerdisplay值可能是size:240x320或者size:272x480，由驱动负责设置。SDK提供获取接口来解析这个属性：<br />
android.util.Size CustomerDisplayDevice.getSize();==<br />
cloudpossdkV1.8.2.10_Standard.aar以上开始支持。<br />
<br />
Q1K系列，需要bootloader0857+支持 #40099<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/><br />
<br />
com.cloudpos.customerdisplay<br />
<br />
CustomerDisplayDevice device = (CustomerDisplayDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);<br />
<br />
device.open();<br />
<br />
device.close();<br />
<br />
==logcat打包接口==<br />
需要权限<br />
<br />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /><br />
<br />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" /><br />
<br />
接口实现<br />
ILogDevice device = LogDeviceImpl.getInstance(context);<br />
<br />
示例代码：<br />
<br />
public void test() {<br />
<br />
if(th null || th.getState() Thread.State.TERMINATED){<br />
<br />
th = new Thread(new Runnable() {<br />
<br />
@Override<br />
<br />
public void run() {<br />
<br />
boolean result ;<br />
<br />
ILogDevice logDevice = LogDeviceImpl.getInstance(mContext);<br />
<br />
// result = logDevice.packageLog(1, "/sdcard/test/1_logs.zip");<br />
<br />
// Logger.debug("run 1_logs result (%s)", result);<br />
<br />
result = logDevice.packageLogcats(3, "/sdcard/test/3_logcats.zip");<br />
<br />
Logger.debug("run 3_logcats result (%s)", result);<br />
<br />
long endTime = System.currentTimeMillis();<br />
<br />
long startTime = endTime - 12 * 60 * 60 * 1000;<br />
<br />
result = logDevice.packageLogcats(startTime, endTime, "/sdcard/test/11_hours_logcats.zip");<br />
<br />
Logger.debug("run 11_hours_logcats result (%s)", result);<br />
}<br />
});<br />
th.start();<br />
}<br />
}<br />
==属性ro.wp.antenna.position，0表示内置，1表示外置==<br />
提供JavaSDK的底层c的接口部分，每次被调用时，同时设置persist.wp.antenna.position确保信息持久化。<br />
<br />
cloudpossdkV1.8.1.1 验证ok<br />
<br />
需要固件支持，Q3MINI-V（pcbc）system1072+ #40676<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_MCUCTL" /><br />
<br />
AntennaDevice device = (AntennaDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_ANTENNA);<br />
<br />
device.open();<br />
<br />
device.getAntennaMode();<br />
<br />
device.setAntennaMode(AntennaDevice.AntennaMode.INTERNAL);<br />
<br />
device.close();<br />
==On Android 10 and above, background services that want to start other services and activities must have the following permissions.==<br />
<br />
<uses-permission android:name="android.permission.START_ACTIVITIES_FROM_BACKGROUND" /><br />
<br />
<uses-permission android:name="android.permission.START_FOREGROUND_SERVICES_FROM_BACKGROUND" /><br />
<br />
==电子钱包接口说明==<br />
The writeValue method is only used when initialize to the card for the first time. For subsequent interactions with the card, the decreaseValue and increaseValue methods need to be called. According to the rules of different cards, before performing the addition or subtraction operation, the verifykeya or verifykeyb methods should be called.<br />
<br />
==selectPinblockFormat==<br />
对于AES key, 默认是4， 而且只能是4， 也可以通过接口设置4，其他不支持.<br />
<br />
int selectPinblockFormat(int nPinblockFormat)<br />
throws DeviceException<br />
Selects the pinblock format to use. Default format is ISO0. Notes on Pinblock Format Support and Handling: - Supported Formats: The HAL layer supports ISO0, ISO2, ISO4, and SM4 formats. - Case 0: ISO2 is exclusively for IC card offline PIN functions. The pinblock is stored in the hardware security module (HSM) and is inaccessible to the HAL layer, as it is not encrypted. - Case 1: When a key with a specific algorithm is injected, if the algorithm doesn't match the pinblock format, the HSM returns an error. A match leads to successful processing. - Case 2: Injecting a key without specifying an algorithm allows the HSM to choose the pinblock format based on your selection. - Case 3: If no pinblock format is selected, the HSM chooses one based on the algorithm of the injected key.<br />
Parameters:<br />
nPinblockFormat - Format index (0~5, ISO0/ISO1/ISO2/ISO3/ISO4/SM4).<br />
Returns:<br />
Negative for error, non-negative for success.<br />
Throws:<br />
DeviceException - for standard reasons as documented in DeviceException.<br />
==emv_trans_initialize()==<br />
Before each transaction is initiated, the emv_trans_initialize() interface should be called to clear the previous data and set the parameters for the new transaction (such as TransAmount/OtherAmount/Trans Date/Time/Trace/Trans Type...)<br />
==exitEMVKernel()==<br />
It should be emphasized that exitEMVKernel() should be deprecated and should never be called at any time.<br />
==pinpad写密文主密钥接口的checkvalue的计算方法==<br />
用解出来的新主密钥对8个0x00做3des加密取前4个当校验值<br />
==算pinblock的时候报-81152（No data available）==<br />
原因调用JNI层calculate pinblock之前要先select key, 不调用select key, 就会报这个错误。<br />
<br />
JavaSDK的方法已经封装了selectkey, 所以没有问题<br />
==注入主密钥的方式汇总==<br />
两层密钥体系下：<br />
<br />
1. 手输主密钥，测试阶段用，参考https://sdkwiki.wizarpos.com/index.php?title=%E6%89%8B%E5%B7%A5%E6%B3%A8%E5%85%A5%E4%B8%BB%E5%AF%86%E9%92%A5%EF%BC%8C%E5%AE%A2%E6%88%B7%E8%B0%83%E8%AF%95%E6%97%B6%E7%94%A8<br />
<br />
2. 母POS注入，参考https://smartpossdk.gitbook.io/cloudpossdk/faq/key-injection/use-tmk-keyloader-pos<br />
<br />
3. RKMS，以及远程注入主密钥demo开发系统，参考https://smartpossdk.gitbook.io/cloudpossdk/faq/key-injection/understand-remote-key-injection<br />
<br />
4. SDK接口，不推荐，但是开发已经提供，有客户如果需要，也可以给。<br />
<br />
1）reset master key to 16 bytes 0x38, then call updateMaster key, updateMasterKey(int masterKeyID, byte[] oldMasterKey, byte[] newMasterKey)<br />
<br />
2) 只在最开始的时候reset master key, 调用updateMasterKey(int masterKeyID, byte[] oldMasterKey, byte[] newMasterKey)， 应用里存储新的<br />
master key, 作为下次的更新时候传入的oldMaster key. 应用存储的key也可以使用HSM密钥加密存储，保证安全。<br />
<br />
三层密钥体系下：<br />
<br />
传输密钥需要使用母POS, RKMS, 或者远程注入主密钥的接口，或者SDK特殊给客户定制的更新传输密钥的接口注入。<br />
<br />
主密钥使用SDK提供的接口注入。updateMasterKeyWithCheck(int masterKeyID, byte[] cipherNewMasterKey, byte[] checkValue, int algoCheckValue)<br />
==updateTransferKey仅支持visiontek,GSS==<br />
GSS是新加的，需要配合使用如下的SDK和aar。<br />
<br />
cloudpossdkV1.7.7.18_gss.aar 验证ok<br />
<br />
需配合agentAssistant 2.15.191+使用<br />
<br />
logo=gss或者visiontek<br />
<br />
visiontek以前就支持。配合使用visiontek的aar包<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_PIN_UPDATE_TRANSFER_KEY" /><br />
<br />
com.cloudpos.advance.ext.pinpad<br />
<br />
IPINPadDevice iPinPadDevice = POSTerminalAdvance.getInstance().getPINPadDevice();<br />
<br />
iPinPadDevice.open(context);<br />
<br />
iPinPadDevice.updateTransferKey(slot,arryCipherNewKey);<br />
<br />
iPinPadDevice.close();<br />
==安卓6和7默认是NMEA串口，安卓12以后默认是ACM串口==<br />
==Mifare card restoreValue和 transferValue的用法==<br />
restorevalue, transfervalue一般用作备份数据。<br />
<br />
在同一个扇区操作。<br />
<br />
在扇区的不同block之间备份，首先block必须使用writevalue初始化成电子钱包。<br />
<br />
同一个扇区的不同block, verify一次就可以。<br />
<br />
调用逻辑：open--verfiy--restorevalue--transfervalue--close。<br />
<br />
restorevalue和transfervalue之间做verify，transfervalue失败。<br />
==ExtBoardDevice调用方法==<br />
ExtBoardDevice extBoardDevice = (ExtBoardDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_EXT_BOARD);<br />
<br />
extBoardDevice.open();<br />
<br />
extBoardDevice.close();<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_SERIAL" /><br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_VIRTUAL_SERIAL_PORT" /><br />
==MDB factor decimal问题==<br />
一般factor设置1， decimal设置2. decimal设置成2的含义：因为mdb不能传输小数位数，这个设置可以让mdb传输带两个小数位数的数值，比如售货机设置0.01， 那么在协议命令里，可以设置值为1， 这样因为decimal为2， 所以实际的值是0.01. 有些售货机默认都是2， 不接受我们协议去更改。所以我们这边比如测试OPC的时候就设置为2. 售货机改不改都没关系。如果售货机会有其他值，那么再根据实际情况调整。<br />
==普通应用截屏接口==<br />
cloudpossdkV1.7.6.7以上<br />
<br />
WizarViewAgentAssistant-v2.15.183+ <br />
<br />
com.cloudpos.advance.ext.system<br />
<br />
ISystemDevice iSystemDevice = POSTerminalAdvance.getInstance().getSystemDevice();<br />
<br />
iSystemDevice.open(context);<br />
<br />
iSystemDevice .screenshot();<br />
<br />
iSystemDevice .getScreenshotInPNG();<br />
<br />
iSystemDevice.close();<br />
<br />
<uses-permission android:name="android.permission.READ_FRAME_BUFFER" /><br />
==wifi hotspot的设置API==<br />
cloudpossdkV1.7.6.7以上<br />
<br />
WizarViewAgentAssistant-v2.15.179+<br />
<br />
com.cloudpos.advance.ext.system.network<br />
<br />
IWifiDevice iWifiDevice = POSTerminalAdvance.getInstance().getSystemDevice().getNetworkManager().getWifiManager();<br />
<br />
iWifiDevice.open(context);<br />
<br />
iWifiDevice.startWifiAp("wifitest","abcdefgh","WPA2_PSK",false);<br />
<br />
iWifiDevice.stopWifiAp();<br />
<br />
iWifiDevice.close();<br />
<br />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /><br />
==检查终端是否root的接口==<br />
cloudpossdkV1.7.6.7及以上<br />
<br />
WizarViewAgentAssistant-v2.15.164+ <br />
<br />
com.cloudpos.advance.ext.system<br />
<br />
ISystemDevice iSystemDevice = POSTerminalAdvance.getInstance().getSystemDevice();<br />
<br />
iSystemDevice.open(context);<br />
<br />
iSystemDevice .isTerminalRooted();<br />
<br />
iSystemDevice.close();<br />
==添加wifi证书，IUserCredentials使用==<br />
cloudpossdkV1.7.6.10 以上开始支持<br />
<br />
WizarViewAgentAssistant-2.15.183以上开始<br />
<br />
com.cloudpos.advance.ext.system.security<br />
<br />
IUserCredentials iUserCredentials = POSTerminalAdvance.getInstance().getSystemDevice().getUserCredentialsManager();<br />
<br />
iUserCredentials.open(context);<br />
<br />
iUserCredentials.installCaCert(CaCertBuffer);<br />
<br />
iUserCredentials.existCaCert(CaCertAlias);<br />
<br />
iUserCredentials.getCaCert(CaCertAlias);<br />
<br />
iUserCredentials.deleteCaCert(CaCertAlias);<br />
<br />
iUserCredentials.installKeyPair(KeyPairAlias,type,privateKeyBuffer,certBuffer);<br />
<br />
iUserCredentials.existKeyPair(KeyPairAlias);<br />
<br />
iUserCredentials.removeKeyPair(KeyPairAlias);<br />
<br />
iUserCredentials.clearCredentials();<br />
<br />
iUserCredentials.close();<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_USERCERTIFICATE" /><br />
==功能键唤醒终端(waking up terminal by function key )==<br />
cloudpossdkV1.7.7.3以上<br />
<br />
WizarViewAgentAssistant-v2.15.186+ <br />
<br />
com.cloudpos.advance.ext.system<br />
<br />
ISystemDevice iSystemDevice = POSTerminalAdvance.getInstance().getSystemDevice();<br />
<br />
iSystemDevice.open(context);<br />
<br />
iSystemDevice . setButtonWakeup (true);<br />
<br />
iSystemDevice . isButtonWakeup ();<br />
<br />
iSystemDevice.close();<br />
<br />
<uses-permission android:name="android.permission.WRITE_POS_SETTINGS" /><br />
==普通应用kill支付应用接口==<br />
/** * Force-stops a payment application.<br />
* * <p>This API terminates the target process immediately and clears its running state. * Only built-in/system payment applications are allowed to be terminated by this method. * Calling this on non-built-in apps will return {@code false} without performing any action.</p> * *<br />
@param pkgName the package name of the payment application * @return {@code true} if the app process was successfully terminated; * {@code false} otherwise * * @requiresPermission android.permission.CLOUDPOS_APP_MANAGER<br />
*/<br />
boolean stopApp(String pkgName);<br />
<br />
cloudpossdkV1.7.7.18_Standard.aar及以上<br />
<br />
agentAssistant 2.15.190及以上<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_MANAGE_APP" /><br />
<br />
ISystemDevice iSystemDevice = POSTerminalAdvance.getInstance().getSystemDevice();<br />
<br />
iSystemDevice.open(context);<br />
<br />
iSystemDevice.stopApp("com.example.paytest");<br />
<br />
iSystemDevice.close();<br />
<br />
==获取打印以及卡片最后使用时间的应用接口==<br />
/** * Gets the last time the specified device was accessed. <br />
* * @param deviceName the unique name of the device *<br />
@return the last used time in milliseconds since epoch, * or -1 if the device has never been used * see : System.currentTimeMillis() * <br />
@throws DeviceException for standard reasons as documented in {@link DeviceException NO_IMPLEMENT}.<br />
*/<br />
<br />
abstract public long getDeviceLastAccessTime(String deviceName) throws DeviceException;<br />
<br />
cloudpossdkV1.7.7.18_Standard.aar 验证ok<br />
<br />
需配合agent 5.4.43+使用<br />
<br />
system也有更新，解决RF时间不准确问题（例如Q3MU system1042+）<br />
<br />
long result = POSTerminal.getInstance(context).getDeviceLastAccessTime(deviceName);<br />
==Admin/user登录/退出接口==<br />
cloudpossdkV1.7.7.18_Standard.aar及以上<br />
<br />
需配合 possetting 1.32.208及以上<br />
<br />
添加权限<br />
<br />
<uses-permission android:name="android.permission.USER_PWD" /> <br />
<br />
<uses-permission android:name="android.permission.ADMIN_PWD" /><br />
<br />
com.cloudpos.advance.ext.system.login<br />
<br />
ILoginDevice iLoginDevice = POSTerminalAdvance.getInstance().getSystemDevice().getLoginManager();<br />
<br />
iLoginDevice.open(context);</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5545
SDK杂记
2026-06-03T07:10:48Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
<br />
com.cloudpos.TerminalSpec<br />
<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver><br />
==对于在Q1K/Q2pro上，persist.wp.hw.customerdisplay值可能是size:240x320或者size:272x480，由驱动负责设置。SDK提供获取接口来解析这个属性：<br />
android.util.Size CustomerDisplayDevice.getSize();==<br />
cloudpossdkV1.8.2.10_Standard.aar以上开始支持。<br />
<br />
Q1K系列，需要bootloader0857+支持 #40099<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/><br />
<br />
com.cloudpos.customerdisplay<br />
<br />
CustomerDisplayDevice device = (CustomerDisplayDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);<br />
<br />
device.open();<br />
<br />
device.close();<br />
<br />
==logcat打包接口==<br />
需要权限<br />
<br />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /><br />
<br />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" /><br />
<br />
接口实现<br />
ILogDevice device = LogDeviceImpl.getInstance(context);<br />
<br />
示例代码：<br />
<br />
public void test() {<br />
<br />
if(th null || th.getState() Thread.State.TERMINATED){<br />
<br />
th = new Thread(new Runnable() {<br />
<br />
@Override<br />
<br />
public void run() {<br />
<br />
boolean result ;<br />
<br />
ILogDevice logDevice = LogDeviceImpl.getInstance(mContext);<br />
<br />
// result = logDevice.packageLog(1, "/sdcard/test/1_logs.zip");<br />
<br />
// Logger.debug("run 1_logs result (%s)", result);<br />
<br />
result = logDevice.packageLogcats(3, "/sdcard/test/3_logcats.zip");<br />
<br />
Logger.debug("run 3_logcats result (%s)", result);<br />
<br />
long endTime = System.currentTimeMillis();<br />
<br />
long startTime = endTime - 12 * 60 * 60 * 1000;<br />
<br />
result = logDevice.packageLogcats(startTime, endTime, "/sdcard/test/11_hours_logcats.zip");<br />
<br />
Logger.debug("run 11_hours_logcats result (%s)", result);<br />
}<br />
});<br />
th.start();<br />
}<br />
}<br />
==属性ro.wp.antenna.position，0表示内置，1表示外置==<br />
提供JavaSDK的底层c的接口部分，每次被调用时，同时设置persist.wp.antenna.position确保信息持久化。<br />
<br />
cloudpossdkV1.8.1.1 验证ok<br />
<br />
需要固件支持，Q3MINI-V（pcbc）system1072+ #40676<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_MCUCTL" /><br />
<br />
AntennaDevice device = (AntennaDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_ANTENNA);<br />
<br />
device.open();<br />
<br />
device.getAntennaMode();<br />
<br />
device.setAntennaMode(AntennaDevice.AntennaMode.INTERNAL);<br />
<br />
device.close();</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5544
SDK杂记
2026-06-03T07:05:41Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
com.cloudpos.TerminalSpec<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver><br />
==对于在Q1K/Q2pro上，persist.wp.hw.customerdisplay值可能是size:240x320或者size:272x480，由驱动负责设置。SDK提供获取接口来解析这个属性：<br />
android.util.Size CustomerDisplayDevice.getSize();<br />
cloudpossdkV1.8.2.10_Standard.aar以上开始支持。<br />
Q1K系列，需要bootloader0857+支持 #40099<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/><br />
<br />
com.cloudpos.customerdisplay<br />
CustomerDisplayDevice device = (CustomerDisplayDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);<br />
device.open();<br />
<br />
device.close();<br />
<br />
==logcat打包接口==<br />
需要权限<br />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /><br />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" /><br />
<br />
接口实现<br />
ILogDevice device = LogDeviceImpl.getInstance(context);<br />
示例代码：<br />
public void test() {<br />
if(th null || th.getState() Thread.State.TERMINATED){<br />
th = new Thread(new Runnable() {<br />
@Override<br />
public void run() {<br />
boolean result ;<br />
ILogDevice logDevice = LogDeviceImpl.getInstance(mContext);<br />
// result = logDevice.packageLog(1, "/sdcard/test/1_logs.zip");<br />
// Logger.debug("run 1_logs result (%s)", result);<br />
<br />
result = logDevice.packageLogcats(3, "/sdcard/test/3_logcats.zip");<br />
Logger.debug("run 3_logcats result (%s)", result);<br />
long endTime = System.currentTimeMillis();<br />
long startTime = endTime - 12 * 60 * 60 * 1000;<br />
result = logDevice.packageLogcats(startTime, endTime, "/sdcard/test/11_hours_logcats.zip");<br />
Logger.debug("run 11_hours_logcats result (%s)", result);<br />
}<br />
});<br />
th.start();<br />
}<br />
}<br />
==属性ro.wp.antenna.position，0表示内置，1表示外置==<br />
提供JavaSDK的底层c的接口部分，每次被调用时，同时设置persist.wp.antenna.position确保信息持久化。<br />
cloudpossdkV1.8.1.1 验证ok<br />
需要固件支持，Q3MINI-V（pcbc）system1072+ #40676<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_MCUCTL" /><br />
<br />
AntennaDevice device = (AntennaDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_ANTENNA);<br />
device.open();<br />
device.getAntennaMode();<br />
device.setAntennaMode(AntennaDevice.AntennaMode.INTERNAL);<br />
device.close();</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5543
SDK杂记
2026-06-03T06:47:28Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
com.cloudpos.TerminalSpec<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver><br />
==对于在Q1K/Q2pro上，persist.wp.hw.customerdisplay值可能是size:240x320或者size:272x480，由驱动负责设置。SDK提供获取接口来解析这个属性：<br />
android.util.Size CustomerDisplayDevice.getSize();<br />
cloudpossdkV1.8.2.10_Standard.aar以上开始支持。<br />
Q1K系列，需要bootloader0857+支持 #40099<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/><br />
<br />
com.cloudpos.customerdisplay<br />
CustomerDisplayDevice device = (CustomerDisplayDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);<br />
device.open();<br />
<br />
device.close();<br />
<br />
==logcat打包接口==<br />
需要权限<br />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /><br />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" /><br />
<br />
接口实现<br />
ILogDevice device = LogDeviceImpl.getInstance(context);<br />
示例代码：<br />
public void test() {<br />
if(th null || th.getState() Thread.State.TERMINATED){<br />
th = new Thread(new Runnable() {<br />
@Override<br />
public void run() {<br />
boolean result ;<br />
ILogDevice logDevice = LogDeviceImpl.getInstance(mContext);<br />
// result = logDevice.packageLog(1, "/sdcard/test/1_logs.zip");<br />
// Logger.debug("run 1_logs result (%s)", result);<br />
<br />
result = logDevice.packageLogcats(3, "/sdcard/test/3_logcats.zip");<br />
Logger.debug("run 3_logcats result (%s)", result);<br />
long endTime = System.currentTimeMillis();<br />
long startTime = endTime - 12 * 60 * 60 * 1000;<br />
result = logDevice.packageLogcats(startTime, endTime, "/sdcard/test/11_hours_logcats.zip");<br />
Logger.debug("run 11_hours_logcats result (%s)", result);<br />
}<br />
});<br />
th.start();<br />
}<br />
}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5542
SDK杂记
2026-06-03T06:39:20Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
com.cloudpos.TerminalSpec<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver><br />
==对于在Q1K/Q2pro上，persist.wp.hw.customerdisplay值可能是size:240x320或者size:272x480，由驱动负责设置。SDK提供获取接口来解析这个属性：<br />
android.util.Size CustomerDisplayDevice.getSize();<br />
cloudpossdkV1.8.2.10_Standard.aar以上开始支持。<br />
Q1K系列，需要bootloader0857+支持 #40099<br />
<br />
<uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/><br />
<br />
com.cloudpos.customerdisplay<br />
CustomerDisplayDevice device = (CustomerDisplayDevice) POSTerminal.getInstance(context).getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);<br />
device.open();<br />
<br />
device.close();</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5541
Firmware
2026-06-03T06:01:20Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[SDK杂记]]<br />
<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android-0603.zip Next指纹新的SDKnbbiometrics-scan-and-extract-sample-android-0603.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5540
SDK杂记
2026-06-03T05:32:47Z
<p>Mahong: </p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）<br />
==主动查询终端是否越界的接口（电子围栏相关）==<br />
cloudpossdkV1.8.2.10开始支持, TmsAgent-v5.4.50.3以上开始支持。<br />
com.cloudpos.TerminalSpec<br />
/** * Requests a geofence status check by sending a broadcast to the Terminal. * * <p> * When this method is invoked, Terminal performs a geofence validation immediately. * The result is delivered asynchronously via broadcast intents. This method does not * return the result directly. * </p> * * <p><b>Broadcast Result Actions:</b></p> * <ul> * <li> * Device is out of the geofence: * com.coudpos.ACTION_LOCATION_OUT_OF_BOUND * </li> * <li> * Device has re-entered the geofence after being out of bounds: * com.coudpos.ACTION_LOCATION_IN_OF_BOUND * </li> * <li> * Geofence feature is not enabled on the device: * com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED * </li> * </ul> * * <p><b>Implementation Details:</b></p> * <ul> * <li>Uses Android broadcast mechanism with action-based filtering</li> * <li>Caller must register a {@link android.content.BroadcastReceiver} to receive results</li> * <li>Result is typically returned shortly after the request is triggered</li> * </ul> * * <p><b>Notes:</b></p> * <ul> * <li>Ensure Terminal is registered before invoking this method</li> * </ul><br />
*/<br />
requestGeofenceBroadcast()<br />
//Sample code:<br />
TerminalSpec terminalSpec = POSTerminal.getInstance(context).getTerminalSpec();<br />
terminalSpec.requestGeofenceBroadcast();<br />
<br />
广播接收：<br />
- com.coudpos.ACTION_LOCATION_OUT_OF_BOUND — 终端出围栏<br />
- com.coudpos.ACTION_LOCATION_IN_OF_BOUND — 终端入围栏<br />
- com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED — 围栏未启用<br />
<receiver<br />
android:name="com.cloudpos.api.receiver.LocationReceiver"<br />
android:enabled="true"<br />
android:exported="true"><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_OUT_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_IN_OF_BOUND" /><br />
</intent-filter><br />
<intent-filter><br />
<action android:name="com.coudpos.ACTION_LOCATION_GEOFENCE_DISABLED" /><br />
</intent-filter><br />
</receiver></div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=SDK%E6%9D%82%E8%AE%B0&diff=5539
SDK杂记
2026-06-03T05:24:52Z
<p>Mahong: Created page with "==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress== cloudpossdkV1.8.1.5开始支持 com.cloudpos.hsm.HSMDevice HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context) .getDevice(POSTerminal.DEVICE_NAME_HSM); hsm.open(); // 单字段CSR（原接口） X500Principal subject1 = new X500Principal("CN=www.test.com"); byte[] csr1 = hsm.gene..."</p>
<hr />
<div>==在生成CSR的时候，可以输入证书的常用域，包括：countryName, stateOrProvinceName, localityName, organizationName, organizationUnitName, commonName和emailAddress==<br />
cloudpossdkV1.8.1.5开始支持<br />
com.cloudpos.hsm.HSMDevice<br />
<br />
HSMDevice hsm = (HSMDevice) POSTerminal.getInstance(context)<br />
.getDevice(POSTerminal.DEVICE_NAME_HSM);<br />
hsm.open();<br />
<br />
// 单字段CSR（原接口）<br />
X500Principal subject1 = new X500Principal("CN=www.test.com");<br />
byte[] csr1 = hsm.generateCSR("terminal", subject1);<br />
<br />
// 多字段CSR（#40841新支持CN/O/OU/C/ST/L）<br />
X500Principal subject2 = new X500Principal(<br />
"CN=pay.test.com,O=TestPayCorp,OU=Security Dept,C=CN,ST=Guangdong,L=Shenzhen");<br />
byte[] csr2 = hsm.generateCSR("terminal", subject2);<br />
<br />
hsm.close();<br />
<br />
权限：CLOUDPOS_SAFE_MODULE<br />
前置条件：HSM需存在公私钥对（例如：terminal别名）</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5538
Firmware
2026-06-03T05:20:36Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[SDK杂记]]<br />
<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/NBBiometrics_ANF_SDK_3_0_0_0311_2.zip Next指纹新的SDK]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5537
Firmware
2026-05-28T02:32:07Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/NBBiometrics_ANF_SDK_3_0_0_0311_2.zip Next指纹新的SDK]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5536
Firmware
2026-05-28T02:18:54Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/NBBiometrics_ANF_SDK_3_0_0_0311_2.zip Next指纹新的SDK]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
[https://ftp.wizarpos.com/sdk/techsupport/software/bluetoothtransactiondemo.zip 蓝牙发送交易的demo 源码，用来测试OPC的蓝牙协议] <br />
[https://ftp.wizarpos.com/sdk/techsupport/software/bluetooth-transactiontest.apk 蓝牙发送交易的demo APK，用来测试OPC的蓝牙协议]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5535
Firmware
2026-05-28T02:11:22Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/NBBiometrics_ANF_SDK_3_0_0_0311_2.zip Next指纹新的SDK]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Chinese_Document&diff=5534
Chinese Document
2026-05-27T08:18:54Z
<p>Mahong: /* 文档 */</p>
<hr />
<div>==文档==<br />
* [https://ftp.wizarpos.com/advanceSDK/支付接口操作文档.pdf 支付接口操作文档.pdf]<br />
* [https://ftp.wizarpos.com/payment/慧银支付应用集成协议V2.3.10.pdf 慧银支付应用集成协议V2.3.10.pdf]<br />
<br />
==FAQ==<br />
* 取消预授权应该传递什么参数? 是TransIndexCode吗？<br />
不是， TransIndexCode每个交易都是唯一的，由三方应用自己保证唯一性，包括消费、撤销、预授权、预授权增加，预授权完成等交易。需要做撤销、增加、完成等交易，原交易的TransIndexCode送入OriTransIndexCode，对于其他的原交易数据送了都是Ori数据 TraceNum->OriTraceNum<br />
TransID->OriTransId<br />
InvoiceNum->OriInvoiceNum<br />
RRN->OriRrn<br />
* 预授权的金额，到发起预授权扣款的时间大概是多长时间？<br />
一般是实时的，预授权是冻结，预授权完成是解冻，可以理解为消费交易，实时扣款。 预授权和预授权完成可以不是同时进行的，例如住酒店，今天预授权500元，明天离开酒店预授权完成400元，钱是预授权完成的时候扣的。<br />
* 取消预授权：<br />
撤销Reversal<br />
* 预授权preauth发送请求消息后，等待一定时间后用户未刷卡会返回cancel，如果刷卡会立刻收到应答<br />
* 退款refund，需要刷卡<br />
* 但是退款有的版本是：发送refund的时候，如果订单已经完结，不用刷卡，会立刻成功。如果订单不存在，会等待1分钟后返回超时。<br />
* 撤销，预授权完成不用刷卡<br />
* 用户购物花了两元，我们发现算错了要退1元<br />
这个场景可以用预授权2块，预授权完成1块实现，或者消费2块，消费撤销1块<br />
* 撤销Reversal是不是只能撤销已经刷卡的预授权，因为这时有transID<br />
如果用户未刷卡，这个预授权应如何取消， 可以使用协议数据CTRL: 0xC1 indicate Cancel Request<br />
* 终端交易不允许并发，不过再等待刷卡界面可以接受串口过来交易<br />
* 预授权完成之后不能在追加了，相当于已经完成一笔扣款了，所以要明确预授权完整之前进行预授权增加; 完成之后在想增加扣款，除非重新刷卡，重新发预授权和预授权完成; 或者发一笔刷卡消费。 预授权增加可以发多次，完成只能发一次。<br />
* 结算【settle】，每天指定时间，执行一次吗？是的。<br />
* 测试结算时，不用传金额, 是应该把未结算的交易都自动结算吗？是的，不用传金额。<br />
* 二维码支付，是扫手机上的二维码支付，不会在POS机上显示二维码。手机是被扫。<br />
* 币种跟最小单位参考: [https://en.wikipedia.org/wiki/ISO_4217 en] [https://zh.wikipedia.org/wiki/ISO_4217 zh]<br />
* transAmount传入的都是整数字符串，具体金额是多少，要看上面的最小单位，比如单位是2， 那么金额有两个小数点。<br />
* refund可以多次调用吗，比如扣了10元，分三次退了2，6，2? 离线支付是允许的，要看具体的支付通道，大部分都支持这种形式的退款。</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Core_Protocol&diff=5533
Core Protocol
2026-05-27T08:18:21Z
<p>Mahong: </p>
<hr />
<div>Regardless of the connection method used, data must be sent and received in accordance with this payment protocol document.<br />
* [https://ftp.wizarpos.com/payment/WIZARPOSPaymentAppIntegrationProtocolV2.3.10.pdf WIZARPOSPaymentAppIntegrationProtocolV2.3.10.pdf]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5532
Payment Apps
2026-05-27T08:14:50Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.9_2605251.apk Payment Emulator2.3.9]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_APP_V2.9.1-global-release.apk PayWizard_V2.9.1]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5531
Payment Apps
2026-05-27T08:12:47Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.9_2605251.apk Payment Emulator2.3.9]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Firmware&diff=5530
Firmware
2026-05-22T08:51:00Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==固件相关==<br />
[[FAQ杂记]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/SOPofupdatefirmwareofQ3R_NB(D22).pdf 把Q3从D22上拆下来，切换固件的spec]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/PINPadDeviceTR31keyusage.pdf PINPadDeviceTR31_keyusage.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/A400-M-V8.pdf 亚略特指纹A400 spec]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip 亚略特指纹SDK-Aratek_BMApi_SPISDKv3.17.2.2_2025.03.14.zip]<br />
<br />
[https://github.com/SmartPOSSamples/nextBiometricsSDKDemo Next指纹demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/NBBiometrics_ANF_SDK_3_0_0_0311_2.zip Next指纹新的SDK]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wifi802.1x-cert-demo.mp4 Connecting POS to an 802.1x Wifi SSID]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/IssueAPPRootCertificateProcess_forTrustedAPK.pdf 为特定APK签发app根证书并注入到终端过程，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/经纬度距离换算.png 经纬度距离换算.png]<br />
<br />
[[电池相关属性值含义]]<br />
<br />
[[Release Notes]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2firmwareswitchmode.pdf 切换固件(eng-user/user-eng)Q2 Firmware Switch Mode between eng and user]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarPOSTerminalCertificateGuide_en.pdf 终端证书介绍TerminalCertificateGuide]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2安卓6系列.xls Q2安卓6主板PCB的对应关系]<br />
<br />
[[怎么调试动画效果]]<br />
<br />
[[触发原因内部详细解释]]<br />
<br />
[[系统日志关键字]]<br />
<br />
[[How to reset transport key/master key]]<br />
<br />
[[How to silence install、update、delete]]<br />
<br />
[[JNI API and C API (Deprecated)]] <br />
<br />
[https://ftp.wizarpos.com/device/java/javadoc_20250617.zip javadoc_20250617.zip] <br />
<br />
[https://ftp.wizarpos.com/emv/javadoc_emv_250120.zip java_doc_emv.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_spainupdatetransportkey.zip javadoc_spainupdatetransportkey.zip] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/javadoc_visiontekupdatetransferkey.zip javadoc_visiontekupdatetransferkey.zip] <br />
<br />
[http://sdkwiki.wizarpos.com/wizarposapi/ Java API Spec] <br />
<br />
[[PINPAD UI设置总结]]<br />
<br />
[[终端发热问题]]<br />
<br />
==各种APK相关==<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/RecoveryOwner-app-release-1.1.apk 清除证书APK（远程注主密钥demo系统的初始化证书，Q2A7,Q2P上已测试）] <br />
<br />
[https://ftp.wizarpos.com/techsupport/software/EnableDisableAppStatus.Play-release-v4.0.2-r20241125142958-q1_platform.apk 默认隐藏playstore的机器，运行APK可以临时enable，需Admin登录，给需要的客户发]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS_PDA_1.0.6_20250122_release.apk Q3PDA Android NFC测试demo] [https://ftp.wizarpos.com/techsupport/software/LaunchpaySoftPOS-demo.mp4 Q3PDA Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/MobileEmvNFC.apk Q3Mini, Q2P, Q3Pro Android NFC测试demo演示]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nextBiometricsSDKDemo250409.apk Next指纹的测试APK, 用我们git上的项目编译的]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/nbbiometrics-scan-and-extract-sample-android0316.apk Next指纹的测试APK, Q2P/Q2PU平台]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocHighAccuracy-release-v1.0.11-r20250221101958-SetSystemStatus.Location-q1_platform.apk 设置Location mode to High Accuracy（高精度）APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ForceEnableLocDeviceOnly-release-v1.0.11-r20250221145841-SetSystemStatus.Location-q1_platform.apk 设置Location mode to Device Only APK， 安装后自动运行]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/cellularz_948559.apk Cellularz工具，能获取到当前的band 和cellid信息]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.64_Free-464_minAPI24(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具 不支持Android6，可以测试网络速度] [https://ftp.wizarpos.com/techsupport/software/pingtooltestvideo.mp4 测试视频] [https://ftp.wizarpos.com/advanceSDK/ua.com.streamsoft.pingtools_4.52_Free-452_minAPI21(arm64-v8a,armeabi-v7a,x86,x86_64)(nodpi)_apkmirror.com.apk Ping工具，支持Android 6以上，可以测试网络速度] <br />
<br />
<br />
==Key Injection相关==<br />
* 注入密钥时候的Dukpt Counter，底层定义了4 bytes, 数据转换的时候，使用big Endine, 比如实际counter是004F, 注密钥的时候，要转成[0x00, 0x00, 0x00, 0x4F]<br />
<br />
==产品相关==<br />
[https://ftp.wizarpos.com/techsupport/specs/wizarPOSModels.xlsx wizarPOSModels.xlsx]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarpos使用手册2.pdf W1使用手册]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/产品培训_0706.pdf 产品培训_0706(Q3+Q2)]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3各submodel特性.pdf Q3各submodel特性]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Mini.pdf Q3 Mini 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Pro.pdf Q3 Pro 只能发给需要的客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3PDA.pdf Q3PDA.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q2PRO.pdf Q2PRO.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q1K.pdf Q1K.pdf]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/Q3Minicountertop.pdf Q3Minicountertop,typeC口仅用于充电，typeAUSB口可以连接UU线通讯， Q3MINI Android 12版本目前规则：Q3mini-C,SN号0CQ3，为PCBA无需特殊处理<br />
Q3mini-H,SN号为1CQ3，为PCBB，需要特殊固件<br />
在打包工具上下载后，需要单独把hwcfg_facttest-PCBB版本放进去， 后续后升级到Android 14]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/TCETC-D1ModuleR1_1(TCS1).pdf Crossmatch指纹DataSheet]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/wizarposCommissioningApplicationForm.xlsx UPT适配用的申请表]<br />
<br />
[[D22相关]]<br />
<br />
[[D3相关]]<br />
<br />
==应用相关==<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_SelfDiag_V2.0.2.apk Visiontek开发的测试APK]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/VA21_Selfdiag_V2.0.2.zip Visiontek开发的测试应用源码]<br />
<br />
[[设置PIN keypad固定顺序显示]]<br />
<br />
[[手工输入主密钥过程]]<br />
<br />
[[zipalign命令]]<br />
<br />
[[非系统应用怎样设置不能卸载/删除]]<br />
<br />
[[TF卡/U盘怎么配置自动安装应用]]<br />
<br />
[[安装卸载应用定义的错误码]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/corretto-1.8.0_312_simplewithsignaturetool.rar 签名工具包含JRE+signaturetoolv2.5-79(无Java环境者适用)]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/Q2_Secure_Application_Development_Guidance.pdf Q2_Secure_Application_Development_Guidance.pdf]<br />
<br />
<br />
[[支付相关内部用]]<br />
<br />
===没有在gitbook公开的应用列表===<br />
<br />
[https://github.com/SmartPOSSamples/ModifyAdminPswd.git 修改Admin password,无Icon, 安装后自动后台运行]<br />
<br />
[https://github.com/SmartPOSSamples/PrintTxtCmpHtml.git 打印text,html比较demo]<br />
<br />
[https://github.com/SmartPOSSamples/InitCertAppDemo.git 注入证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/PrintPDFTestDemo.git 打印demo]<br />
<br />
[https://github.com/SmartPOSSamples/QueryCertificatesDemo.git 查询终端证书demo]<br />
<br />
[https://github.com/SmartPOSSamples/APNwithAirplane.git 设置APN，开关飞行模式demo]<br />
<br />
[https://github.com/SmartPOSSamples/CloudPOSCamera.git Camera demo]<br />
<br />
[https://github.com/SmartPOSSamples/UsbMtpAPIDemo Enable MTP demo App]<br />
<br />
[https://github.com/SmartPOSSamples/wakeLockDemo.git WakeLock demo App]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/SberBankHsmDemo.zip SberBankHsmDemo.zip evotor固件检测触发状态，解触发接口demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/mpay_injectkey_example(1).zip MPay注入密钥的sample]<br />
<br />
[https://github.com/SmartPOSSamples/ScanDemo 扫码demo]<br />
<br />
[https://ftp.wizarpos.com/techsupport/apks/relayDemo.zip 源码relayDemo.zip] [https://ftp.wizarpos.com/techsupport/apks/relayDemo-1.0.apk APKrelayDemo-1.0.apk]通过ext串口连继电器<br />
[https://ftp.wizarpos.com/sdk/advanceSDK/wifiConfigDemo.zip 源码配置wifi的802.1证书代码]<br />
<br />
==其他==<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/H21修改NV67330工具.rar H21修改NV67330工具.rar]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DES计算器.rar DES计算器]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/DukptServerDemo.zip Dukpt算法工具，不能发客户]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/bp-tools-21.05-739-master-4210077.zip bp-tools-21.05-739-master-4210077.zip]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/qpst.win.2.7_installer_00470.6.zip QPST/PDC工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/LTENVReadToolV1.0.1.rar Read NV工具]<br />
<br />
[https://ftp.wizarpos.com/techsupport/software/WI-PD-002产品与物料编码规则.pdf 包括电池SN规则在内的物料编码规则]<br />
<br />
[https://ftp.wizarpos.com/advanceSDK/PDF-Reader.apk 简易PDF reader APK]<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5529
Payment Apps
2026-05-09T03:34:07Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.8_2605091.apk Payment Emulator2.3.8]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5528
Payment Apps
2026-05-09T02:14:11Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.7_2605082.apk Payment Emulator2.3.7]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5527
Payment Apps
2026-05-08T03:18:30Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.6_2605071.apk Payment Emulator2.3.6]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5526
Payment Apps
2026-05-08T03:18:02Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/paymentPayWizard_Demo_V2.3.6_2605071.apk Payment Emulator2.3.6]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5525
Payment Apps
2026-04-30T06:28:38Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.4_2603251.apk Payment Emulator2.3.4]<br />
* [https://ftp.wizarpos.com/payment/PayWizard_V2.8.6-global-release.apk PayWizard_V2.8.6]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Chinese_Document&diff=5524
Chinese Document
2026-04-13T09:40:19Z
<p>Mahong: </p>
<hr />
<div>==文档==<br />
* [https://ftp.wizarpos.com/advanceSDK/支付接口操作文档.pdf 支付接口操作文档.pdf]<br />
* [https://ftp.wizarpos.com/payment/慧银支付应用集成协议V2.3.6.pdf 慧银支付应用集成协议V2.3.6.pdf]<br />
==FAQ==<br />
* 取消预授权应该传递什么参数? 是TransIndexCode吗？<br />
不是， TransIndexCode每个交易都是唯一的，由三方应用自己保证唯一性，包括消费、撤销、预授权、预授权增加，预授权完成等交易。需要做撤销、增加、完成等交易，原交易的TransIndexCode送入OriTransIndexCode，对于其他的原交易数据送了都是Ori数据 TraceNum->OriTraceNum<br />
TransID->OriTransId<br />
InvoiceNum->OriInvoiceNum<br />
RRN->OriRrn<br />
* 预授权的金额，到发起预授权扣款的时间大概是多长时间？<br />
一般是实时的，预授权是冻结，预授权完成是解冻，可以理解为消费交易，实时扣款。 预授权和预授权完成可以不是同时进行的，例如住酒店，今天预授权500元，明天离开酒店预授权完成400元，钱是预授权完成的时候扣的。<br />
* 取消预授权：<br />
撤销Reversal<br />
* 预授权preauth发送请求消息后，等待一定时间后用户未刷卡会返回cancel，如果刷卡会立刻收到应答<br />
* 退款refund，需要刷卡<br />
* 但是退款有的版本是：发送refund的时候，如果订单已经完结，不用刷卡，会立刻成功。如果订单不存在，会等待1分钟后返回超时。<br />
* 撤销，预授权完成不用刷卡<br />
* 用户购物花了两元，我们发现算错了要退1元<br />
这个场景可以用预授权2块，预授权完成1块实现，或者消费2块，消费撤销1块<br />
* 撤销Reversal是不是只能撤销已经刷卡的预授权，因为这时有transID<br />
如果用户未刷卡，这个预授权应如何取消， 可以使用协议数据CTRL: 0xC1 indicate Cancel Request<br />
* 终端交易不允许并发，不过再等待刷卡界面可以接受串口过来交易<br />
* 预授权完成之后不能在追加了，相当于已经完成一笔扣款了，所以要明确预授权完整之前进行预授权增加; 完成之后在想增加扣款，除非重新刷卡，重新发预授权和预授权完成; 或者发一笔刷卡消费。 预授权增加可以发多次，完成只能发一次。<br />
* 结算【settle】，每天指定时间，执行一次吗？是的。<br />
* 测试结算时，不用传金额, 是应该把未结算的交易都自动结算吗？是的，不用传金额。<br />
* 二维码支付，是扫手机上的二维码支付，不会在POS机上显示二维码。手机是被扫。<br />
* 币种跟最小单位参考: [https://en.wikipedia.org/wiki/ISO_4217 en] [https://zh.wikipedia.org/wiki/ISO_4217 zh]<br />
* transAmount传入的都是整数字符串，具体金额是多少，要看上面的最小单位，比如单位是2， 那么金额有两个小数点。<br />
* refund可以多次调用吗，比如扣了10元，分三次退了2，6，2? 离线支付是允许的，要看具体的支付通道，大部分都支持这种形式的退款。</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Core_Protocol&diff=5523
Core Protocol
2026-04-13T09:38:37Z
<p>Mahong: </p>
<hr />
<div>Regardless of the connection method used, data must be sent and received in accordance with this payment protocol document.<br />
* [https://ftp.wizarpos.com/payment/WIZARPOSPaymentAppIntegrationProtocolV2.3.6.pdf WIZARPOSPaymentAppIntegrationProtocolV2.3.6.pdf]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Core_Protocol&diff=5522
Core Protocol
2026-04-13T09:38:12Z
<p>Mahong: </p>
<hr />
<div>Regardless of the connection method used, data must be sent and received in accordance with this payment protocol document.<br />
* [https://ftp.wizarpos.com/paymentWIZARPOSPaymentAppIntegrationProtocolV2.3.6.pdf WIZARPOSPaymentAppIntegrationProtocolV2.3.6.pdf]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_Apps&diff=5521
Payment Apps
2026-03-27T07:44:57Z
<p>Mahong: </p>
<hr />
<div>The two payment apps need install to terminal firstly. Please provide serial numbers of the debug terminal, WizarPOS will push latest version remotely.<br />
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.3.4_2603251.apk Payment Emulator2.3.4]<br />
* [https://ftp.wizarpos.com/payment/OPC_V2.6.0-global-release.apk PAYwizard2.6.0.apk]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=%E6%8A%80%E6%9C%AF%E6%94%AF%E6%8C%81%E6%B2%9F%E9%80%9A%E6%8C%87%E5%BC%95&diff=5520
技术支持沟通指引
2026-03-25T02:54:25Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==关于客户支付方面的沟通流程==<br />
1. 询问客户是否在终端上开发应用？<br />
<br />
不是：参考[[Local Integration (External Device)]]<br />
<br />
是，转2<br />
<br />
2. 询问客户，是否有支付后台？应用要连自己的支付后台吗？<br />
<br />
不是：参考[[Internal Integration (POS App Development)]]<br />
<br />
是：转3<br />
<br />
3. 询问客户，和自己支付后台的开发已经好了吗？<br />
<br />
不是：提供EMV接口，参考https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec<br />
<br />
是，那么客户需要提供AIDL接口给OPC，OPC适配后，就可以使用客户的支付了<br />
<br />
参考[[Payment App Development]]<br />
<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=%E6%8A%80%E6%9C%AF%E6%94%AF%E6%8C%81%E6%B2%9F%E9%80%9A%E6%8C%87%E5%BC%95&diff=5519
技术支持沟通指引
2026-03-25T02:54:09Z
<p>Mahong: </p>
<hr />
<div>{{#ifeq:{{currentloggeduser}}||<br />
<div style="background-color: #ffcccc;border: 1px dashed red; padding: 10px;"><br />
This content is restricted to authorized users only. Please [[Special:UserLogin|log in]] to access additional information. <br />
</div><br />
|<br />
==关于客户支付方面的沟通流程==<br />
1. 询问客户是否在终端上开发应用？<br />
<br />
不是：参考[[Local Integration (External Device)]]<br />
是，转2<br />
<br />
2. 询问客户，是否有支付后台？应用要连自己的支付后台吗？<br />
<br />
不是：参考[[Internal Integration (POS App Development)]]<br />
是：转3<br />
<br />
3. 询问客户，和自己支付后台的开发已经好了吗？<br />
<br />
不是：提供EMV接口，参考https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec<br />
<br />
是，那么客户需要提供AIDL接口给OPC，OPC适配后，就可以使用客户的支付了<br />
<br />
参考[[Payment App Development]]<br />
<br />
}}</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Local_Integration_(External_Device)&diff=5518
Local Integration (External Device)
2026-03-24T06:47:22Z
<p>Mahong: </p>
<hr />
<div>Suitable for scenarios where no application development on the POS terminal is needed. In this case, the Vendor Machine communicates directly with the PAYWizard on the terminal. The communication between the POS terminal and the Vendor Machine supports serial port, MDB (Multi-Drop Bus), Socket, and other protocols.<br />
Apart from the MDB communication method, all data transmission and reception shall be carried out in accordance with the protocol document: [[Core Protocol]].<br />
* Reference for data packaging and unpacking：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]<br />
* A simple [https://ftp.wizarpos.com/techsupport/ticket/fowchartnoappdevelop.png flow chart]<br />
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/local-integration local-integration]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Local_Integration_(External_Device)&diff=5517
Local Integration (External Device)
2026-03-24T06:47:05Z
<p>Mahong: </p>
<hr />
<div>Suitable for scenarios where no application development on the POS terminal is needed. In this case, the Vendor Machine communicates directly with the PAYWizard on the terminal. The communication between the POS terminal and the Vendor Machine supports serial port, MDB (Multi-Drop Bus), Socket, and other protocols.<br />
Apart from the MDB communication method, all data transmission and reception shall be carried out in accordance with the protocol document: [[Core Protocol]].<br />
* Reference for data packaging and unpacking：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]<br />
* A simple [https://ftp.wizarpos.com/techsupport/ticket/fowchartnoappdevelop.png Serial&SocketDemo240910.zip flow chart]<br />
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/local-integration local-integration]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Local_Integration_(External_Device)&diff=5516
Local Integration (External Device)
2026-03-20T09:54:35Z
<p>Mahong: </p>
<hr />
<div>Suitable for scenarios where no application development on the POS terminal is needed. In this case, the Vendor Machine communicates directly with the PAYWizard on the terminal. The communication between the POS terminal and the Vendor Machine supports serial port, MDB (Multi-Drop Bus), Socket, and other protocols.<br />
Apart from the MDB communication method, all data transmission and reception shall be carried out in accordance with the protocol document: [[Core Protocol]].<br />
* Reference for data packaging and unpacking：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]<br />
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/local-integration local-integration]</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Internal_Integration_(POS_App_Development)&diff=5515
Internal Integration (POS App Development)
2026-03-20T09:40:03Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing normal applications on the terminal. The application can call the AIDL interface provided by the PAYWizard application to perform different types of transactions. In this mode, PAYWizard does not communicate with the Vendor Machine; the self-developed application is responsible for communicating with the Vendor Machine.<br />
<br />
Here is a demo app that calls the PAYWizard AIDL interface: [https://github.com/SmartPOSSamples/PayMentAIDLDemo PayMentAIDLDemo]<br />
<br />
Please send and receive data according to this protocal document:[[Core Protocol]]<br />
<br />
[https://ftp.wizarpos.com/techsupport/ticket/flowchartofdevelopnormalapp.png Here is a flowchart]<br />
<br />
[https://ftp.wizarpos.com/payment/PayMentAidlDemo_release_V1.0.6_20260114.apk PayMentAidlDemo_release_V1.0.6_20260114]<br />
<br />
See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/internal-integration internal-integration]<br />
<br />
====Best practice for payment in D22(D3)/Q3(Q2)====<br />
For developing applications on the D22.<br />
* Install [https://ftp.wizarpos.com/payment/AccessoryAgentHostService-master-release-v1.0.30-r20251208115422-q1_platform.apk the new accessory agent] on D22(D3)/Q3(Q2)<br />
* Install initconnectionmode on D22/Q3, configure master and slave. This step is usually pre-initialized at the factory and does not require further configuration by the customer.<br />
* Install PAYwizard app on D22/Q3<br />
* Set protocal of PAYwizard to DEFAULT on D22, and set the payment package name to com.wizarpos.opc<br />
* Set protocal of PAYwizard to USB ACCESSORY on Q3, and set the payment package name to com.wizarpos.paywizard.demo</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Internal_Integration_(POS_App_Development)&diff=5514
Internal Integration (POS App Development)
2026-03-20T09:39:23Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing normal applications on the terminal. The application can call the AIDL interface provided by the PAYWizard application to perform different types of transactions. In this mode, PAYWizard does not communicate with the Vendor Machine; the self-developed application is responsible for communicating with the Vendor Machine.<br />
<br />
Here is a demo app that calls the PAYWizard AIDL interface: [https://github.com/SmartPOSSamples/PayMentAIDLDemo PayMentAIDLDemo]<br />
<br />
Please send and receive data according to this protocal document:[[Core Protocol]]<br />
<br />
[https://github.com/techsupport/ticket/flowchartofdevelopnormalapp.png Here is a flowchart]<br />
<br />
[https://ftp.wizarpos.com/payment/PayMentAidlDemo_release_V1.0.6_20260114.apk PayMentAidlDemo_release_V1.0.6_20260114]<br />
<br />
See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/internal-integration internal-integration]<br />
<br />
====Best practice for payment in D22(D3)/Q3(Q2)====<br />
For developing applications on the D22.<br />
* Install [https://ftp.wizarpos.com/payment/AccessoryAgentHostService-master-release-v1.0.30-r20251208115422-q1_platform.apk the new accessory agent] on D22(D3)/Q3(Q2)<br />
* Install initconnectionmode on D22/Q3, configure master and slave. This step is usually pre-initialized at the factory and does not require further configuration by the customer.<br />
* Install PAYwizard app on D22/Q3<br />
* Set protocal of PAYwizard to DEFAULT on D22, and set the payment package name to com.wizarpos.opc<br />
* Set protocal of PAYwizard to USB ACCESSORY on Q3, and set the payment package name to com.wizarpos.paywizard.demo</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App_Development&diff=5513
Payment App Development
2026-03-20T09:13:17Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the PAYwizard to call. <br />
<br />
In the payment app, should include two implement：<br />
<br />
1. Please refer to [https://github.com/SmartPOSSamples/AidlServiceDemo AidlServiceDemo which provided AIDL to PAYwizard app]. The package name of this payment app demo is: com.wizarpos.aidlservicedemo.<br />
<br />
[https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf Here is the description of the scheme].<br />
<br />
2. Call EMV kernel interface to implement the payment, please refer to [https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec EMV SPEC].<br />
<br />
[https://ftp.wizarpos.com/techsupport/ticket/flowchartofpaymentappdevelop.png Here is a flowchart].</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=File:Flowchartofpaymentdevelop.png&diff=5512
File:Flowchartofpaymentdevelop.png
2026-03-20T09:08:03Z
<p>Mahong: </p>
<hr />
<div></div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App_Development&diff=5511
Payment App Development
2026-03-20T09:05:27Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the PAYwizard to call. <br />
<br />
In the payment app, should include two implement：<br />
<br />
1. Please refer to [https://github.com/SmartPOSSamples/AidlServiceDemo AidlServiceDemo which provided AIDL to PAYwizard app]. The package name of this payment app demo is: com.wizarpos.aidlservicedemo.<br />
<br />
[https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf Here is the description of the scheme].<br />
<br />
2. Call EMV kernel interface to implement the payment, please refer to [https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec EMV SPEC].<br />
<br />
Here is a flowchart:</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App_Development&diff=5510
Payment App Development
2026-03-20T08:50:26Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the PAYwizard to call. <br />
<br />
In the payment app, should include two implement：<br />
<br />
1. Please refer to [https://github.com/SmartPOSSamples/AidlServiceDemo AidlServiceDemo which provided AIDL to PAYwizard app]. The package name of this payment app demo is: com.wizarpos.aidlservicedemo.<br />
<br />
[https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf Here is the description of the scheme].<br />
<br />
2. Call EMV kernel interface to implement the payment, please refer to [https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec EMV SPEC].</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App_Development&diff=5509
Payment App Development
2026-03-20T08:49:29Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the PAYwizard to call. <br />
<br />
In the payment app, should include two implement：<br />
<br />
1. Please refer to [https://github.com/SmartPOSSamples/AidlServiceDemo AidlServiceDemo which provided AIDL to PAYwizard app]. The package name of this payment app demo is: com.wizarpos.aidlservicedemo.<br />
<br />
And a description: [https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf Description of the scheme].<br />
<br />
2. Call EMV kernel interface to implement the payment, please refer to [https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec EMV SPEC].</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Payment_App_Development&diff=5508
Payment App Development
2026-03-20T08:44:18Z
<p>Mahong: </p>
<hr />
<div>It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the PAYwizard to call. <br />
<br />
In the payment app, should include two implement：<br />
<br />
1. Please refer to [https://github.com/SmartPOSSamples/AidlServiceDemo AidlServiceDemo which provided AIDL to PAYwizard app].<br />
<br />
Here is a manual:[https://ftp.wizarpos.com/techsupport/ticket/WIZARPOSPaymentAppAIDLManualV1.0.5.pdf AIDLManualV1.0.5.pdf]. <br />
<br />
And a description: [https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf Description of the scheme].<br />
<br />
2. Call EMV kernel interface to implement the payment, please refer to [https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/emv-develop-spec EMV SPEC].</div>
Mahong
http://sdkwiki.wizarpos.com/index.php?title=Chinese_Document&diff=5507
Chinese Document
2026-03-20T02:57:00Z
<p>Mahong: </p>
<hr />
<div>==文档==<br />
* [https://ftp.wizarpos.com/advanceSDK/支付接口操作文档.pdf 支付接口操作文档.pdf]<br />
* [https://ftp.wizarpos.com/payment/慧银支付应用集成协议V2.3.4.pdf 慧银支付应用集成协议V2.3.4.pdf]<br />
==FAQ==<br />
* 取消预授权应该传递什么参数? 是TransIndexCode吗？<br />
不是， TransIndexCode每个交易都是唯一的，由三方应用自己保证唯一性，包括消费、撤销、预授权、预授权增加，预授权完成等交易。需要做撤销、增加、完成等交易，原交易的TransIndexCode送入OriTransIndexCode，对于其他的原交易数据送了都是Ori数据 TraceNum->OriTraceNum<br />
TransID->OriTransId<br />
InvoiceNum->OriInvoiceNum<br />
RRN->OriRrn<br />
* 预授权的金额，到发起预授权扣款的时间大概是多长时间？<br />
一般是实时的，预授权是冻结，预授权完成是解冻，可以理解为消费交易，实时扣款。 预授权和预授权完成可以不是同时进行的，例如住酒店，今天预授权500元，明天离开酒店预授权完成400元，钱是预授权完成的时候扣的。<br />
* 取消预授权：<br />
撤销Reversal<br />
* 预授权preauth发送请求消息后，等待一定时间后用户未刷卡会返回cancel，如果刷卡会立刻收到应答<br />
* 退款refund，需要刷卡<br />
* 但是退款有的版本是：发送refund的时候，如果订单已经完结，不用刷卡，会立刻成功。如果订单不存在，会等待1分钟后返回超时。<br />
* 撤销，预授权完成不用刷卡<br />
* 用户购物花了两元，我们发现算错了要退1元<br />
这个场景可以用预授权2块，预授权完成1块实现，或者消费2块，消费撤销1块<br />
* 撤销Reversal是不是只能撤销已经刷卡的预授权，因为这时有transID<br />
如果用户未刷卡，这个预授权应如何取消， 可以使用协议数据CTRL: 0xC1 indicate Cancel Request<br />
* 终端交易不允许并发，不过再等待刷卡界面可以接受串口过来交易<br />
* 预授权完成之后不能在追加了，相当于已经完成一笔扣款了，所以要明确预授权完整之前进行预授权增加; 完成之后在想增加扣款，除非重新刷卡，重新发预授权和预授权完成; 或者发一笔刷卡消费。 预授权增加可以发多次，完成只能发一次。<br />
* 结算【settle】，每天指定时间，执行一次吗？是的。<br />
* 测试结算时，不用传金额, 是应该把未结算的交易都自动结算吗？是的，不用传金额。<br />
* 二维码支付，是扫手机上的二维码支付，不会在POS机上显示二维码。手机是被扫。<br />
* 币种跟最小单位参考: [https://en.wikipedia.org/wiki/ISO_4217 en] [https://zh.wikipedia.org/wiki/ISO_4217 zh]<br />
* transAmount传入的都是整数字符串，具体金额是多少，要看上面的最小单位，比如单位是2， 那么金额有两个小数点。<br />
* refund可以多次调用吗，比如扣了10元，分三次退了2，6，2? 离线支付是允许的，要看具体的支付通道，大部分都支持这种形式的退款。</div>
Mahong