终端类
产品介绍
智收银(USDK)
1.1 接口文档
修订记录目录
一.调用方式:
1、APP本地调研
2、HTTP调用
3、AIDL调用
4、串口通讯
5、数据共享
二、接口参数定义
三、交易接口说明
1、收款类
1.1 收款/分期收款 -- 银行卡
1.2 收款/分期收款/用户主扫 -- 扫码支付
1.3 收款/分期收款/预授权 -- 订单支付
1.4 收款/分期收款/预授权-- 订单支付(无查询)
1.5 金融宝
1.6 人脸
1.7 订单人脸支付
2、撤销类
2.1 撤销/分期撤销 -- 银行卡
2.2 撤销/分期撤销 -- 订单支付
2.3 撤销 -- 人脸支付
3、退货类
3.1 退货/分期退货 -- 银行卡
3.2 退货/分期退货 -- 扫码支付
3.3 退货-- 人脸支付
4、查询类
4.1 余额查询
4.2 订单支付结果查询
4.3 交易查询
4.4 订单详情查询
5、授权类
5.1 预授权
5.2 (订单)预授权撤销
5.3 (订单)预授权完成
5.4 (订单)预授权完成撤销
5.5 扫码预授权
5.6 (订单)扫码预授权撤销
5.7 (订单)扫码预授权
5.8 (订单)扫码预授权完成撤销
5.9 人脸预授权
5.10 人脸预授权撤销
5.11 人脸预授权完成
5.12 人脸预授权完成撤销
6、辅助功能
接收终端主密钥
终端签到
终端结算
提取指定交易内容
重打印签购单
身份验证
扫码获取订单请求
一机多商户辅助功能
借贷记验证
7、应用管理
配置 USDK 参数
检查 USDK 更新
获取所有 USDK 参数
设置所有 USDK 参数
8、对外服务
打印指定内容
获取设备信息
扫码获取码值(条形码/二维码)
读卡(银行卡,M1 卡,通联 86 预付费卡)
9、H5轻应用接口
四、AIDL接口文档
1.交易类
单笔交易明细
多笔交易明细
历史交易明细
读取身份证信息
历史交易汇总查询
获取 USDK 参数
设置 USDK 参数
读取银行卡号
清除流水
三要素验证
M1 卡读取
五、数据共享接口说明
1.交易类
交易明细查询(单笔/多笔
历史明细查询
交易汇总
历史交易汇总
清除交易流水
2.参数类
获取 USDK 参数
设置 USDK 参数
语音播报(百度离线)
3.三要素验证
六、钱包机构码参照表
七、业务类型
八、备注
九、附录
附录一
附录二
附录三
1.2 操作手册
1.3 调用示例
1.4 常见问题
云MIS
2.1 接口文档
1. 接口环境
2. 支付类接口
2.1. 基础收款接口
2.2. 授权类收款接口
2.3. 刷脸支付收款接口
2.4. 辅助功能接口
3. 业务编码列表
4. 返回码列表
5. 附录
2.2 操作手册
传统收银
3.1 接口文档
一、调用方式
二、 回调类定义
三、 接口参数定义
四、 卡标志说明
五、 业务类型、交易类型
六、 接口导入文件列表—Android 版本
七、 备注
八、附录
应用商店
4.1 接口文档
1 厂商服务配置
2 系统接口
版本下载以及对接demo
厂商设备服务
厂商设备服务
各厂商智能机出厂预装包
妙收银
应用商店
通联云终端(Cloud)
MIS
传统MIS
智能云 mis
报备
1.刷脸设备白名单申请
2. 通联渠道身份证报备
通联核心产品文档中心
-
+
首页
八、附录
#### # 附录 ### [8.1 ]()附录一 SubAcct:该字段可包含多个子节点,以 json 方式上送(传输中需转义为 string 类型),具体定义如下: | **参数名称** | **必填** | **注释** | **格式** | | -------------------- | ---------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SubAcct | C | 订单交易分账功能子账户信息 | {"MER1": {"MODE":"1","MER": "通联支付 99","MID": "999999999999","AMT": "30","RATIO": "30"},.....}说明:1. MODE 取值为 1,代表按比例分账,AMT 字段可不出现。MODE 字段为 2 时,代表按金额分账,RATIO 字段可不出现。1. 选择按比例分账时,RATIO 字段取值最长为 2 位数字,如 30 代表 30%;选择按金额分账时,AMT 字段为数字,可带小数点,最长 12 位,以元为单位。1. 可包含多个分账账户,格式如上,多个分账账户所表示的金额之和需等于原始交易金额。 | ### 8.2 附录二 SubAcct 字段示例 SubAcct:分账子账户信息: **String****格式(即请求格式):** “{\"MER1\":{\"MODE\":\"2\",\"MER\":\"通联支付 99\",\"MID\":\"999999999999\",\"AMT\":\"0.30\"},\"MER2\":{\"MODE\":\"1\",\"MER\":\"通联支付 88\",\"MID\":\"888888888888\",\"RATIO\":\"0.30\"},\"MER3\":{\"MODE\":\"1\",\"MER\":\"通联支付 66\",\"MID\":\"666666666666\",\"RATIO\":\"0.30\"}}” **Json****格式:** { ``` "MER1": { ``` "MODE":"2", ``` "MER": "通联支付 99", "MID": "999999999999", "AMT": "0.30" }, "MER2": { "MODE":"1", "MER": "通联支付 88", "MID": "888888888888", "RATIO": "0.30" }, "MER3": { "MODE":"1", "MER": "通联支付 66", "MID": "666666666666", "RATIO": "0.30" } ``` } ### 8.3 附录三 网上统一收银参数配置 **注:建议本接口也可直接对接收银宝网上统一收银—统一扫码接口,无需配置,所有逻辑按收银宝统一扫码接口交互即可** **地址:https://aipboss.allinpay.com/know/devhelp/main.php?pid=15&tdsourcetag=s_pcqq_aiomsg** 1, 配置文件(Config.ini,密文存储)存放在 QrPay 目录下,修改参数设置需输入安全密码。    配置文件内容根据实际情况需配置字段说明: 1. MERNAME:商户名称 2. CUSID:商户号 3. APPID:平台分配的 APPID 4. KEY: 5. PRINTER:支持“默认打印机”和“网络打印机”,如果是串口打印,此处必须配置为“默认打印机”,如果是无线网络打印机,此处必须配置为“网络打印机” 6. PRINTIP:网络打印机 IP 地址(PRINTER 为“网络打印机”时,此处不能为空) 7. PRINTIPPORT:网络打印机 IP 端口号(PRINTER 为“网络打印机”时,此处不能为空) 8. COMPORT:即“串口号”,串口打印机端口号(PRINTER 为“默认打印机”时,此处不能为空) 2, md5.dll 需要拷贝到系统目录 C:\Windows\SysWOW64\和 C:\Windows\System32 目录下。 8.4 附录四 收银宝传统和简易终端版本表 **8.4.1 传统终端** | 版本号 | 验收时间 | 厂商 | 适用机型 | 优化内容和新增功能 | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | | V4.0180899 | 2018.08.03 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加了打印联数设置。2.修改了待机界面刷卡请挥卡时退出 3.修改了设置待机界面默认交易的显示错误 4.新增金融宝交易 5.新增扫码主扫功能 | | 2018.08.09 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.生成二维码使用公共目录,防止生成二维码失败 2.新增金融宝功能呢 3.新增扫码主扫功能 | | | | | | | | V4.0180899(MIS 合并版) | 2018.09.04 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.新增 MIS 功能合并 2.在 MIS 功能和传统上都增加订单支付 | | 2018.08.28 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850(0906) | 1.新增 MIS 功能合并 2.在 MIS 功能和传统上都增加订单支付 | | | 2018.09.03 | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | 1.新增 MIS 功能合并 2.在 MIS 功能和传统上都增加订单支付 3.新增金融宝交易 | | | | | | | | | | | | | | V5.0190199(MIS 合并版)-消费外卡 | 2019.01.21 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加外卡功能,2.增加手输卡号功能 3.增加订单支付冲正开关,4.增加银行卡和银联云闪付优惠金额显示打印 5.增加个人签购单联广告信息二维码打印 6.增加扫码预授权类交易类型 | | 2019.01.18 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | | 2018.01.25 | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | | V5.1190399(MIS 合并版)-订单外卡 | 2019.03.19 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加订单类交易外卡功能,2.增加扫码预授权一维码显示快速完成功能 | | 2019.03.15 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | | | | | | | | V5.2190499(MIS 合并版)-金融宝撤销新接口 | 2019.03.28 | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | 1.增加订单类交易外卡功能,2.增加扫码预授权一维码显示快速完成功能 3.新增金融宝撤销新接口 | | 2019.04.02 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | | 2019.04.03(01 联迪 | | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | | | | | | | | | | | | | V5.3190699(MIS 合并版)—国密,85 号文,21 号文 | 2019.06.25 | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | 1.增加国密算法 2.增加交易类型 85 号文基站地址上送 3.增加金融宝,订单消费 21 号文 TUSN 上送 | | 2019.07.02 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | | 2019.06.20 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | | | | | | | | | | | | | V5.4190799(MIS 合并版)—签到状态上送 SIM 卡信息 ICCID,外卡 DCC 查询修改,结算和明细单增加打印版本号 | | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | 1.签到状态上送 SIM 卡信息 ICCID,2.外卡 DCC 查询修改,3.结算和明细单增加打印版本号 | | 2019.07.18 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | | 2019.07.17 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | | | | | | | | | | | | | | V5.5(增加外卡电子签单英文上送 | 2019.10.26 | 新大陆 | GP720,ME31S,SP50,SP60,SP80 | | | 2019.10.12 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1. POS 断电重启后停留在操作员签到界面,需签到后才能交易 2. 修正 QR50 USB 口缓存数据没清理的问题 3. 将管理菜单里 POS 签到和操作员签到合并成一个交易 4. MIS 模式下退货交易按取消键可以直接退出交易 5. 消费入口进行插卡操作,只有银联 62 卡会提示“请挥卡,使用云闪付”,外卡可以正常交易。6.电子签名上送英文格式 7.调整微信主扫时黑白屏二维码的大小,防止图片过大显示不全 8.订单支付支持免签免密 9.99 管理员菜单增加激活功能,MIS 模式下暂不支持激活 | | 2019.10.28 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.修复 46 域参数过长的报错 2.增加是否外置非接参数配置文件 3.修改 mis 重打印没有重打印字样的 bug 4.修改 mis 交易满后,提示先结算 5.电子签名上送英文格式 6.调整微信主扫时黑白屏二维码的大小,防止图片过大显示不全 7.订单支付支持免签免密 8.99 管理员菜单增加激活功能,MIS 模式下暂不支持激活 | | V5.6 | 2019.12.26 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加简易结算单,只统计有效交易。2.MIS 模式下 POS 开机停留在接收指令界面。3.修正针打结算单颜色过淡问题。4.针打签购单增加通联客户号。5.调整 MIS 模式下串口发送字节数限制,提高到 4000 字节。6.修正 CDMA、WCDMA 机型基站定位获取不到的错误。 | | 2020.03.25 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.修复了金融宝撤销磁条卡原交易上送有误的 bug。 | | V5.7 | 2020.01.10 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.金融宝增加输入身份证号码功能(数字和字母),可在参数设置里关闭。2.修正针打参数单颜色过淡问题。3.修正针打扫码签购单重复打印提示信息问题。4.修正扫码预授权完成后出现交易已撤错误。5.扫码预授权完成撤销增加凭证号输入。 | | 2020.04.16 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.增加金融宝手输入身份证。2.增加 MIS 设置不打印。3.增加总计单是否明细打印开关 | | V5.8 | 2020.05.26 | 百富 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加银联国际卡处理。2.修正 MIS 模式下订单查询控件已输入订单号后需再次输入订单号的问题。3.刷卡等待时间 60 秒,60 秒后自动退出交易。4.金融宝强制输入姓名,不能跳过。5.修正公钥错误引起的程序崩溃问题。 | | 2020.06.09 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.增加 mis 可以设置扫码不打印。2.增加银联国际卡。3.修改了 E820MIS 重打结算单故障的 bug | | V5.9 | 2020.08 | 联迪 E5 系列 | E330,E350,E510,E520,E530,E550,E570, | 1.增加待机界面输入金额扫码 。2.增加操作员 01-20。3.增加快捷扫码开关。4.修正扫码打印一联为商户联。5.修复订单扫码支付一联打印成机构联的 bug。 | | 百富 S 系列 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.修复 SP20 外接键盘无法非接的问题 | | V6.0 | 2020.11 | 百富 S 系列 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加对运通连通卡的支持。2.修正 MIS 模式订单支付备注问题。3.修正 MIS 模式订单支付商户号不打印问题。4.增加 TMS 远程更新参数功能。5.热敏扫码签购单可以单独设置联数。6.修改签购单公共部分留白。主版本号修改为 V6.0201199。 | | V6.1 | 2020.12 | 百富 S 系列 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.新增扫码查询功能 | | 2021.01 | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.新增扫码查询功能 2.优化针打签购单要素 3.支持金融宝身份证字母输入 | | V6.2(去 NAC 版本) | 2021.02 | 百富 S 系列 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.扫码查询后撤销判断流水 2.新增去 NAC 功能 | | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.扫码查询后撤销判断流水 2.新增去 NAC 功能 | | 2021.04 | 新大陆 | SP 系列 | 1.新增快速扫码功能 2.新增去 NAC 功能 | | V6.2210799(连通版本) | | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.修复美运外卡非接 9A 日期格式上送不对的 bug。 | | V6.3 | 2021.07 | 新大陆 | SP 系列 | 1.新增快速扫码功能开关 2.新增主被扫开关 | | 2021.05 | 百富 | S 系列 | 1.扫码查询增加手输单号功能。2.MIS 模式增加 9FF8、9FF9 两个 tag。3.简易结算单增加是否打印明细选择。 | | V6.4 | 2021.06 | 百富 | S 系列 | 1.明细单格式调整,只打印有效交易 2.订单支付调整订购人字符长度,可接收 20 个汉字 | | 2021.08 | 新大陆 | SP 系列 | 1.新增对连通内卡的支持 | | 2021.11 | 联迪 | E5 和 E8 系列 | 1.新增对连通内卡的支持 2.参数默认新增对 IP 主备的支持 | | V6.5 | 2022.02 | 百富 S 系列 | S58,S60-S,S78,S80,S90,S500,S800,S900 | 1.增加了 259 号文修改。2.修改了电信默认地址为:101.231.63.129 | | 联迪 | E330,E350,E510,E520,E530,E550,E570,E810,E820,E830,E850 | 1.增加了 259 号文修改。2.修改了电信默认地址为:101.231.63.129 | | V6.7 | 2022.02 | 新大陆 | SP 系列 | 1.增加了 259 号文修改。2.修改了电信默认地址为:101.231.63.129 | **9.4.2 21 年新入围传统终端**| 联迪厂商 | | ------------ | | 版本号 | 验收时间 | 适用机型 | 优化内容和新增功能 | | V210499 | 2021.04.20 | 350G | 1.新增去 NAC 功能 | | | V210599 | 2021.05.27 | 350G | 1.修改预授权小额免密密码错误的问题。 | | V210899 | 2021.08.27 | 350G | 1.增加金融宝交易。<br/>2.增加签到时连接不上可以按确认键进行 wifi 连接。<br/>3.打印浓度增大版本。 | | V200299 | 2021.02.28 | 350G | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | | | | | 新大陆厂商 | | 版本号 | 验收时间 | 适用机型 | 优化内容和新增功能 | | V210699 | 2021.06.22 | SP620 | 1.新增金融宝转账功能(去 NAC 功能) | | V210999 | 2022.09.10 | SP620 | 1. 增加签到时上送状态。<br/>2. 去除 99 管理员的状态上送入口。<br/>3. 修复菜单页,pos 签到,未执行状态上送 | | V211199 | 2022.01.06 | SP620 | 1.新增金融宝转账功能持卡人名称输入长度 | | V200299 | 2021.02.28 | SP620 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | **9.4.3 简易终端**| 版本号 | 验收时间 | 厂商 | 适用机型 | 优化内容和新增功能 | 补充备注 | | ------------ | ------------ | ---------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | V180799 | 2018.08.06 | 优博讯 | Q2000 | 修复撤销 bug,(卡号包含 4600,且 4600 前面没有 00 就会撤销出错) | | | V180799 | 2018.08.06 | 优博讯 | Q3000 | 初版程序 | | | V180799 | 2018.08.06 | 华智融 | C2 | 修复了扫码支付末笔查询后,撤销无法找到原交易的 bug | | | V180899 | 2018.08.14 | 升腾 | Q50 | 修复了未笔查询之后扫码撤销找不到原交易的 bug | | | V180499 | 2018.08.31 | 九思泰达 | Q70 | 初版程序 | | | V190899 | 2019.09.10 | 联迪 | QM90 | 初版程序 | | | V191099 | 2019.10.24 | 天喻 | QR80 | 初版程序 | | | V200699 | 2020.06.04 | 联迪 | QM500 | 初版程序 | | | V200799 | 2020.07.28 | 联迪 | QM30 | 1.增加国密功能。<br/>2.修改待机界面输入金额功能,默认为扫码。<br/>3.修复了冲正无返回的问题。 | | | V200799 | 2020.07.29 | 联迪 | QM50 | 1.增加国密功能。<br/> | | | V200899 | 2020.08.17 | 联迪 | QM600 | 初版程序 | | | | | | | | | | V201299 | 2020.12.27 | 联迪 | QM500 | 1.修改了输入金额字体大小。<br/>2.修改了语音播报。<br/>3.在外面增加了通讯切换设置 | 从这个版本开始,简易终端开始新界面模式 | | | | | | | | | | | | | | | | V210399 | 2021.03.10 | 百富 | QR65 | 1.新增去 NAC 功能 | 从这个版本开始,简易终端支持去 NAC 功能 | | V210399 | 2021.03.30 | 联迪 | QM50 | 1.新增去 NAC 功能 | | | V210499 | 2021.04.20 | 联迪 | QM500 | 1.新增去 NAC 功能 | | | | | | | | | | V210599 | 2021.05.27 | 联迪 | QM50S | 1.增加交易前进行金额播报。<br/>2.优化播报金额速度。 | | | | | | | | | | V1.0210799 | 2021.07.30 | 新大陆 | ME50C | 1.云音响 + 银行卡 + 扫码功能 | | | V210799 | 2021.07.27 | 联迪 | QM50S | 1.增加 SIM 卡信息上送 | | | V210899 | 2021.08.27 | 联迪 | QM50S | 1.增加保存流水之前先进行上送的功能 | | | V211099 | 2021.10.12 | 联迪 | QM50S | 1.修改了扫码不再显示发送。只显示接收中。<br/>2.交易速度优化。<br/>3.主备 ip 切换功能。<br/>4.wifi 搜索汉字乱码修复。<br/>5.增大了播报音量。 | | | V211299 | 2021.12.33 | 联迪 | QM50S | 1.增加了判断模块版本,输入金额语音播报功能 <br/>2.主菜单调整。 | | | V200299 | 2022.02.28 | 联迪 | QM50S | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 联迪 | QM500 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 联迪 | QM600 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 联迪 | QM30 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 百富 | QR65 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 升腾 | S70 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 新大陆 | ME50C | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | | | V200299 | 2022.02.28 | 联迪 | QM50 | 1.增加了 259 号文修改。<br/>2.修改了电信默认地址为:101.231.63.129 | |
顾俊gujun1
2025年3月4日 16:50
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期