智能終端APP接入

最近更新時間：2022.12.27

本文檔主要描述了匯付數據智能POS標準第三方接入的規范，其中調用方式主要為SDK調用。

接入流程

開發機申請

開始接入前，需申請聯調開發測試終端，所有聯調均在生產環境進行調試。業務方聯系對應匯付業務對接人員，匯付業務會內部申請專用聯調開發機提供給對接方。聯調開發機中會有明確圖標表示為開發機，僅開發機可自行安裝app進行調試且開發機不可用于真實商戶收款。

測試商戶

終端調試需使用調試商戶，生產環境聯調中，客戶可自行準備生產環境測試商戶。如客戶無法準備測試商戶，可咨詢相關運營協助提供開發聯調商戶。

上架發布

當客戶聯調完成后，需進行應用上架匯付應用市場進行生產驗證。客戶將最終確定的app包進行簽名打包，打包時必須包含V1簽名。并將app包郵件發送匯付運營，提供相關app功能說明及版本說明，提供推送終端編號。

接入流程圖

總體思路如下： 基于POS智能終端安裝三方app，通過引入SDK并調用SDK接口，決定收銀臺展現頁面。

接入說明

SDK文件下載

當前版本：V1.0.3

Androidx版本點我下載

Android support版本點我下載

SDK引入

把SDK文件放入三方APP的libs文件夾下并在 文件中引入，代碼如下：build.gradle

android {
  ...
  ...
  ...
  repositories {
    flatDir { dirs 'libs' }
  }
}
dependencies {
  ...
  ...
  ...
  implementation(name: 'pnr_mis_sdk_V1.0.3', ext: 'aar')
  implementation 'com.google.code.gson:gson:2.8.2'
  implementation 'com.jakewharton.timber:timber:4.7.1'
  implementation 'com.google.zxing:core:3.4.0'
  ...
  ...
  ...
}復制代碼復制失敗復制成功

SDK初始化

在 Application 的 onCreate（） 方法中調用 PnrDevice.getInstance（this）.init（）;

SDK調用

Androidx版本demo下載

Android support版本demo下載

日志規范

1. 每天的日志寫入同一個文件并以當天日期{yyyyMMdd}命名;

2. 日志寫入終端本地路徑： mtms/log/outapp/{ APP應用包名} /{yyyyMMdd}.log;

3. 應用內日志保留時間為15天,過期日志應及時刪除。

   注：在SDK中已經集成了日志保存邏輯，只需要使用Timber輸出日志即可完成日志寫入。

API接口匯總

以下為調用的api接口匯總。

支付類接口

管理類接口

數據類接口

硬件類接口

通知類接口

系統查詢類接口