终端类
产品介绍
智收银(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. 通联渠道身份证报备
通联核心产品文档中心
-
+
首页
1.4 常见问题
#### 无论任何情况遇到问题首先核对智收银、USDK、设备服务、pos 固件版本。在一切都是最新的情况下 在上报总部研发进行解决: 1.智收银、USDK 更新渠道(a.自更新;b.通联应用商店); 2.设备服务更新渠道(a.通过 usdk 主界面 检查设备服务更新 b.通联应用商店); 3.POS 固件版本更新渠道:联系当地厂商分公司并提供序列号由他们配置后进行升级; 注意:更新前记得先进行结算 | 序号 | 问题描述 | 解决方案 | | ------ | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | 终端产品在线文档地址: | [https://aipboss.allinpay.com/know/devhelp/main.php?pid=69](https://aipboss.allinpay.com/know/devhelp/main.php?pid=69) | | 1 | 分公司和商户合作开发 app 调用 usdk 支付准备材料 | 去终端产品文档中心中“8.1 智能终端”和“8.2 厂商服务”下载最新的 usdk 和对应厂商服务,以及 1.1 节参照接口文档进行调用 | | 2 | 在和商户对接什么情况下使用签名 apk、release 版本 apk | 1.通联产权的机器使用签名 apk,其更新遵循常用规则2.非通联产权机器使用 release 版本 apk,其更新由使用方自行定义 | | 3 | 如何使用 MIS 方式进行对接 | 1.设置-功能控制-无线 MIS 打开 可参考终端产品文档中心 8.8.1 节 USDK_WEB.html (仅支持同一局域网下调用)2..通过云 MIS 对接 具体可参见终端产品 云 MIS 在线文档 | | 4 | 原快速预授权开关在哪?如何开通? | 1.设置 - 打印参数 - 条码打印 - 二维码打印(即快速预授权) | | 5 | 如何获取 USDK 日志 | 获取日志有 2 种方案:1.设置-远程诊断-日志上传 提供商户号进行查询2.http://usdk 显示 IP:9801/log(前提是:设置-功能控制-无线 MIS 开关打开 log 解压密码 allinpay_log)l | | 6 | 身份验证支持厂商有哪些?如何开通使用? | 身份证开通渠道:通联 和 厂商 可在业务管理 - 身份验证 - 选择渠道1.通联渠道 提供商户号 、 终端号、 序列号 通联总部报备(可微盘下载报备模板:智收银和 usdk - 通联渠道身份证报备) (支持机型:联迪:A7、A8、A8S 、F8 百富:A930 、A910 升腾 :K9 新大陆:N910 、N910Pro、N850、N920、X5(带金融设备))2.厂商渠道 提供序列号给当地厂商开通 | | 7 | 如何使用订单支付 | 设置-业务管理-订单支付 开关打开 | | 8 | 末笔查询功能是什么 | 末笔查询是针对扫码交易来说,其作用是为了获取超时扫码交易的交易结果 | | 9 | 95-报产品未开通 | 联系后台确认该商户终端是否开通此交易 | | 10 | POS 打印不出票 | 1.pos 电量低,降压保护故不打票。保持电量充足。2.终端对于没有收到后台明确成功交易的响应码不会打印 | | 11 | 撤销交易退货交易冲正交易 | 撤销交易:对原交易金额全部进行退回,限制当前批结前可操作,是手动发起;退货交易:对原交易金额部分或全部进行退回,是手动发起冲正交易:对该笔原交易返回超时,发卡方无法确认记账结果,下一笔银行卡交易发起前自动发起的。 | | 12 | 交易报 MAC/A0/XH 解析工作秘钥相关错误 | 是密钥出问题,需要重新联机初始化(接受主密钥)就好,可能导致该情况出现原因:1.同一商户号和终端号在其他机器上初始化2.usdk 设置中 外置密码键盘(设置-输密参数) 打开3.选择外置存储秘钥时,外置多个接口的时候联机初始化4.机器受到强制拆机或者撞击会启动保护机制清楚相关密钥 | | 13 | 40-不支持该交易 | 1.确认后台该交易类型是否开通2.确认后台商户信息中【受理渠道】是否选中 | | 14 | 扫码预授权/银行卡预授权,不做完成或撤销,多久退款到账? | 扫码:默认是 30 天银行卡:根据各发卡行可能不太一样 | | 15 | 智收银 USDK 支持外卡有哪些? | 都支持,前提是厂商服务以及 usdk 版本为新的版本,部分厂商固件可能也涉及到升级 | | 16 | 横屏机器 C10 说明 | 1.C10 的主密钥是存放在密码键盘中,对于不支持电子签名的密码键盘需要关闭电子签名,否则交易过不了2.C10 在联机初始化过程中 只允许插入一个 usb 接口 否则秘钥无法下发成功 | | 17 | 对于预授权完成 扫二维码 报 AUTH_NO 错 | 一般是授权码不合法 正常应该是 6 位 | | 18 | 非接交易报 CB | 该商户后台未开通双免 | | 19 | 商户修改名称如何同步 | 有 3 种方式:1.签到2.智收银 我的-下载功能-参数同步3.usdk-业务管理-下载参数-参数同步 | | 20 | 95 sub_mch_id 与 sub_appid 不匹配 | 商户的公众号配置问题 联系运营 检查配置 | | 21 | 无效商户或终端状态不可用 无效交易 | 联系业务以及运营人员检查商户、终端状态是否正常 | | 22 | 无效商户 | 银联返回的,一般是银行卡非接免密免签 确认该商户是否报备银联 | | 23 | FF83=不支持该功能 | 1.usdk 未正常安装,卸载重新安装2.后台未开通该功能 | | 24 | 挥卡或插卡报 57-不允许降价交易 | 卡片本身问题咨询发卡行 | | 25 | 订单扫码功能在哪里打开,扫的什么样的码? | 智收银首页“设置”里点开业务管理,再打开订单支付,智收银首页“我的”里点开功能控制,打开“订单扫码”开关,扫的码是由业务代号、金额、订单号组成的 json 串生成的二维码,具体规则见接口文档 6.7 节 | | 26 | 交易报错-16711690 怎么处理 | 密码键盘异常,依次处理方案:重启--> 刷固件--> 换机 | | 27 | 259 号文交易拒绝问题 | 1.devicetype 不符合 259 号文要求 --终端类型不对或者没有2.tusn 序列号错误 tusn 序列号不对或者没有3.encryptrandnum 不符合 259 号文要求 终端随机数不对或者没有4.secrettext 不符合 259 号文要求 序列号密文数据不对或者没有 | | 28 | 30-格式错 | 1.重新下载主密钥即联机初始化 | | 29 | S01 -扫描字符串非请求类型 | 智收银 - 我的 - 功能控制 - 订单扫码 开关关闭PS:如果是仅仅扫码获取订单号该开关无需打开 | | 30 | -16711690 | 百富密码键盘异常.解决方案依次为:重启 刷固件 换机 | | 31 | 95-转加密失败 | 1.重新签到 同步 pinkey | | 32 | -6000-请检查网络后重新交易 | 检查终端网络是否正常。 | | 33 | 终端上提示:返回码 + 密码错误次数超限 | 银行卡交易密码输错次数大于发卡行的规定,卡片已被发卡行锁定,需要联系发卡行 | | 34 | 终端上提示:03 或者 97 | 商户号或终端号未在后台登记,检查 pos 设置的商户号和终端号是否匹配 | | 35 | 微信扫码交易弹出提示输密界面后,不想继续输密,点返回会提示“支付结果确认中,第 N 次,请稍候”,如何避免一直在这个界面等待 | 目前接口如果不想等太久 末笔的次数不要设置太大。建议 3 次 | | 36 | 终端序列号跟收银宝后台不一致 | 终端重新初始化 | | 37 | 终端入库了,但是应用商店不能搜索到应用 | 检查一下终端上的系统时间是否太旧,设置到最新年月日时间试试 | | 38 | 95 报文格式错误:11175 | 运营平台配置问题,英文名称中包含中文字符 | | 39 | 分公司想要安装 USDK 怎么安装,远程推送还是发安装包给商户自己装? | 通联采购的都是出厂预装的,没有的话,在线文档下载安装 | | 40 | 95-支付码错误,非数字 | 一般发生在百富机器 是因为 扫码激活码 没激活 解决方案:pos 上计算器打开依次输入 !7777= 即可激活 | | 41 | 金融宝交易 台胞证和港澳的是否可支持 | 不支持,只支持身份证渠道 | 42 95:8351-5 对应多个结算 ID 微信进件出错,商户 MCC 商户类别对应多个微信结算 ID
顾俊gujun1
2025年3月3日 15:32
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期