智能终端APP接入-汇付天下

智能终端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接口汇总。

支付类接口

管理类接口

数据类接口

硬件类接口

通知类接口

系统查询类接口