终端类
智收银（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 订单人脸支付
1.8 用户主扫 -普通收款/订单
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. 通联渠道身份证报备
通联核心产品文档中心
-
+
附录一
#### 附录一 BUS_INFO：该字段可包含多个子节点，以嵌套 json 方式上送至 USDK，具体定义如下： | **子参数名称** | **必填** | **注释** | **格式** | | ---------------------- | ---------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | **BUS_INFO** | **C** | **业务扩展结构** | “BUS_INFO”:{“SUB_MERCHANT”:{…},“SUB_MERCHANT_LIST”:[{ },{ },…]“SUB_ACCT”:[{ },{ },…],“IS_PRINT”: “0”} | BUS_INFO 子节点： | SUB_MERCHANT | C | 子商户号 | “SUB_MERCHANT”:{“MID”:“821290054110001”,“NAME”:“测试商户”（可选）} | | ---------------------- | ------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SUB_MERCHANT_LIST | C | 子商户列表 | “SUB_MERCHANT_LIST”:[{“MID”:“821290054110001”,“NAME”:“测试商户”（可选）}，… ] | | GB_QR_CONTENT| C | 国补二维码信息打印 | {“TYPE”:“0”(0-普通 1- 电动车),“MID”:“821290054110001”,“TID”:“10000006”,“TDATE”:“250916”} | | SUB_ACCT | C | 交易分账功能子账户 | “SUB_ACCT”:[{“MODE”:“1”,“MID”:“5506510541102N4”“AMT”:“30”,“RATIO”:“10”,}，… ]说明：1. MODE 取值为 1，代表按比例分账，AMT 字段可不出现。MODE 字段为 2 时，代表按金额分账，RATIO 字段可不出现。1. 选择按比例分账时，RATIO 字段整数部分最长为 2 位，可带 2 位小数，如 30.45 代表 30.45%；选择按金额分账时,AMT 字段为数字，可带 2 位小数，最长 12 位，以元为单位，如 30.55 表示 30.55 元。1. 交易报文中可包含多个分账账户，一个或多个分账账户用中括号[ ]括起来，分账账户之间用逗号分隔，多个分账账户所表示的金额之和需等于原始交易金额。 | | IS_PRINT | C | 是否打印 | 0：不打印；1：打印注：目前只针对（900100004/600000002）接口 | | ORDER_INFO | C | 订单信息 | 订单查询返回的业务信息 | | **TRANS_INFO** | **C** | **交易扩展结构** | | | | C | 暂无 | | | **PARA_INFO** | | **参数型扩展结构** | | | | | 暂无 | | VALIDATE_INFO：该字段可包含多个子节点，以嵌套 json 方式上送至 USDK，具体定义如下： | **子参数名称** | **必填** | **注释** | **格式** | | ---------------------- | ---------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | VALIDATE_INFO | **C** | **验证拓展字段** | “VALIDATE_INFO”:{“INPUT_PAN”:“xxxxxxxxx”“ID_CARD_NO”:“xxxxxxxxx”“ID_CARD_NAME”:“xxxxxxxxx”“SUPP_CARD_TYPE”:“x”， “MERCH_ID”:”990xxx”“TER_ID”:”123232xx”} | VALIDATE_INFO 子节点（有就传入没有无需传入）： | INPUT_PAN | C | 输入指定银行卡号 | | | ---------------- | --- | -------------------------- | -------------------------------------------------------------------------- | | ID_TYPE | C | 证件类型 | 0-身份证(默认) 1-户口簿 2-护照 3-军官证 4-士兵证 5-港澳居民来往内地通行证 6-台湾同胞来往内地通行证 7-临时身份证 8-外国是居留证 9 警官证 11-营业执照 12-组织机构代码 13-税务登记证 14-统一社会信用代码证 15-外国护照 16-出入境通行证 17-旅行证 20-港澳居民居住证 21-台湾居民居住证 X 其他证件 | ID_CARD_NO | C | 证件号码 | | | ID_CARD_NAME | C | 姓名 | | | VAL_CARD_TYPE | C | 是否需要验证借贷记 | 0. 否(默认)1. 是 | | SUPP_CARD_TYPE | C | 支持卡种 | 0. 借贷记（默认）1. 借记卡 1. 贷记卡该字段有值的话 VAL_CARD_TYPE 必须传值 | | VAL_FAIL_NEXT | C | 验证失败是否允许继续交易 | 0. 否 （默认）1. 是 | | KEY_TYPE | | 密钥类型 | 0-keyA 1-keyB | | SECRET_KEY | | 密钥 | | | BLOCK_NO | | 块号 | 取值 0-63 | | MERCH_ID | | 商户号 | 该字段用于验证请求商户号和 USDK 配置商户号是否一致 | | TER_ID | | 终端号 | 该字段用于验证请求终端号和 USDk 配置终端号是否一致 | PAGE_APPEND_CONTENT：该字段可包含多个子节点，以 json 方式上送至 USDK，具体定义如下： | **子参数名称** | **必填** | **注释** | **格式** | | ---------------------- | ---------------- | -------------------------- | -------------------------------------------------------------------------------------------------- | | PAGE_APPEND_CONTENT | **C** | **自定义打印字段** | “PAGE_APPEND_CONTENT”:{“MERCHANT_PAGE”:“xx”,“CARD_HOLDER_PAGE”:“xx,“THIRD_PAGE”:“xx} | PAGE_APPEND_CONTENT 子节点（有就传入没有无需传入）： (以下针对 WORD/QR_CODE 字段支持标签化传入，标签以英文字符 $ 开头 ^ 结束。如系统参考号：$20^ 表示) | MERCHANT_PAGE | C | 商户联 | WORD：打印文字，如需要打印多行以\n 换行处理 QR_CODE：需要打印的二维码以字符串形式传入 PICTURE：打印图片，图片需要先压缩后转成字节数组，再 BASE64 编码成字符串传入该联以嵌套 json 方式传递[{“WORD”:”XXX”,“QR_CODE”:”XX”, “PICTURE”:”XX”,“LOCATION”:”XX”},…….]LOCATION 取值说明：1. 左对齐 2 -右对齐 3- 居中（默认） | | ------------------ | --- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | CARD_HOLDER_PAGE | C | 持卡人联 | 同上 | | THIRD_PAGE | C | 第三联 | 同上 | UNIFORM_VALIDATE_INFO：该字段可包含多个子节点，以嵌套 json 方式上送至 USDK，具体定义如下： | **子参数名称** | **必填** | **注释** | **格式** | | ---------------------- | ---------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | VALIDATE_INFO | **C** | **验证拓展字段** | “VALIDATE_INFO”:{“INPUT_PAN”:“xxxxxxxxx”“ID_CARD_NO”:“xxxxxxxxx”“ID_CARD_NAME”:“xxxxxxxxx”“SUPP_CARD_TYPE”:“x”} | VALIDATE_INFO 子节点（有就传入没有无需传入）： | INPUT_PAN | C | 输入指定银行卡号 | | | ---------------- | --- | -------------------------- | -------------------------------------------------------------------------- | | ID_TYPE | C | 证件类型 | 0-身份证(默认) 1-户口簿 2-护照 3-军官证 4-士兵证 5-港澳居民来往内地通行证 6-台湾同胞来往内地通行证 7-临时身份证 8-外国是居留证 9 警官证 11-营业执照 12-组织机构代码 13-税务登记证 14-统一社会信用代码证 15-外国护照 16-出入境通行证 17-旅行证 20-港澳居民居住证 21-台湾居民居住证 X 其他证件 | ID_CARD_NO | C | 证件号码 | | | ID_CARD_NAME | C | 姓名 | | | VAL_CARD_TYPE | C | 是否需要验证借贷记 | 0. 否(默认)1. 是 | | SUPP_CARD_TYPE | C | 支持卡种 | 0. 借贷记（默认）1. 借记卡 1. 贷记卡该字段有值的话 VAL_CARD_TYPE 必须传值 | | VAL_FAIL_NEXT | C | 验证失败是否允许继续交易 | 0. 否 （默认）1. 是 | | KEY_TYPE | | 密钥类型 | 0-keyA1-keyB | | SECRET_KEY | | 密钥 | | | BLOCK_NO | | 块号 | 取值 0-63 | MEMO 说明：为兼容老版本 memo 打印，原逻辑保留，新版本 MEMO 打印遵循 | MEMO | C | MEMO 打印 | WORD：打印文字，如需要打印多行以\n 换行处理 QR_CODE：需要打印的二维码以字符串形式传入 PICTURE：打印图片，图片需要先压缩后转成字节数组，再 BASE64 编码成字符串传入该联以嵌套 json 字符串的方式传递 以固定 STANDPT 开头 例如：STANDPT[{“WORD”:”XXX”,“QR_CODE”:”XX”, “PICTURE”:”XX”,“LOCATION”:”XX”},…….]LOCATION 取值说明：0. 左对齐 2 -右对齐 3- 居中（默认） | | ------ | --- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
顾俊gujun1
2026年2月25日 14:02
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Word文件
PDF文档
分享
链接
类型
密码
更新密码
有效期