终端类
产品介绍
智收银(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. 通联渠道身份证报备
通联核心产品文档中心
-
+
首页
2.4. 辅助功能接口
#### ### [1.1.1. 通讯握手]() **接口介绍:** 该接口用于探测链路是否正常。由远端商户收银系统主动发起握手请求,最终到达目的POS终端,目的POS机在收到握手请求指令后,立即返回成功应答,完成握手操作,默认超时8秒。 **接口** **URL** **:** 同支付接口URL **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"CFFFFFFFF","CASH_ID":"HT000081","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"48d339096c7f1097a86a17f32c5eda3d","APP_PACKAGE_NM":"","APP_CLASS_NM":"","CUST_DATA":""} ** **返回参数:** ** {"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"CFFFFFFFF","RSP_CODE":"Y0000","RSP_DATA":"","RSP_DESC":"** **云****MIS** **服务调用成功** **","ClOUD_MIS_TRX_SSN":"300348158808948736","SIGN_DATA":"48D339096C7F1097A86A17F32C5EDA3D"}** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串( **通讯握手交易时也必须上送,赋值为空,参考入参示例** ) | | CASH_ID | 必填 | 请求、返回 | 收银机款台号 | | STORE_ID | 必填 | 请求、返回 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | 非必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | ### [1.1.2. 重打印]() **接口介绍:** 该接口主要实现重打印当日成功完成未结算的支付交易,聚合银行卡与扫码支付。 **接口** **URL** **:** 同支付接口URL **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"900100010","CUST_DATA":"{\"BUSINESS_ID\":\"900100010\",\"AMOUNT\":\"000000000010\",\"ORDER_NO\":\"2222222222\",\"ORIG_TRACE_NO\":\"000800\"}","CASH_ID":"HT000085","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"9746da823ccda081cac93364838eb863","APP_PACKAGE_NM":"","APP_CLASS_NM":""}** **返回参数:** **{"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"100100003","RSP_CODE":"Y0000","RSP_DATA":"{\"CARDNO\":\"6212142400000000105\",\"REJCODE_CN\":\"** **交易成功** **\",\"MERCH_ID\":\"990605055336000\",\"TRANS_CHANNEL\":\"006\",\"BATCH_NO\":\"000022\",\"TIME\":\"110423\",\"REJCODE\":\"00\",\"SIGN\":\"2fb7f59b74c2b97b74d570aa089fc32e\",\"DATE\":\"0302\",\"TER_ID\":\"10000085\",\"ORDER_NO\":\"2222222222\",\"CARD_FEE\":\"000000000000\",\"AMOUNT\":\"000000000010\",\"ISS_NO\":\"** **中国工商** **\",\"REF_NO\":\"110337041229\",\"TRACE_NO\":\"000800\",\"PRINT_FLAG\":\"1\",\"CARDTYPE\":\"001\",\"BUSINESS_ID\":\"100100003\",\"TRANS_TICKET_NO\":\"112003370001041229\",\"AUTH_NO\":\"932870\",\"MERCH_NAME\":\"** **进贤门店** **_** **测试** **3\",\"EXP_DATE\":\"2907\",\"CARD_TYPE_IDENTY\":\"1\",\"ISS_NAME\":\"** **中国工商银行** ** \",\"USDK_VERSION_CODE\":\"S-LANDIA8-I00V5.0200108\",\"OPER_NO\":\"01|** **操作员** **1\",\"WILD_CARD_SIGN\":\"0\",\"TRANSTYPE\":\"005\",\"SIGN_FLAG\":\"0\"}","RSP_DESC":"** **云****MIS** **服务调用成功** **","ClOUD_MIS_TRX_SSN":"286820340603027456","SIGN_DATA":"10788378A41CDA2C9087CBF1AE6D89B9"}** **接口字段注释:** | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | -------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | ORIG_TRACE_NO | 必填 | 请求 | 原始流水号 | | TRANS_CHECK | 非必填 | 请求 | 交易唯一标识 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | API_VERSION | 非必填 | 请求 | API版本号 | | BUS_ EXTPARA | 非必填 | 请求 | 业务扩展字段,用于特定功能,详见附录2 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | CUPS | 非必填 | 返回 | 卡组织或钱包机构 | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | TRANS_CHANNEL | 非必填 | 返回 | 交易渠道 | | BATCH_NO | 必填 | 返回 | 批次号 | | TRACE_NO | 必填 | 返回 | 凭证号 | | TRANS_TICKET_NO | 必填 | 返回 | 交易单号 | | REF_NO | 必填 | 返回 | 系统参考号 | | AMOUNT | 必填 | 返回 | 支付金额,十二位长度(单位:分) | | DATE | 必填 | 返回 | 支付日期 | | TIME | 必填 | 返回 | 支付时间 | | PRINT_FLAG | 非必填 | 返回 | 是否打印小票(1:打印,0:未打印) | | CARDNO | 非必填 | 返回 | 卡号 | | EXP_DATE | 非必填 | 返回 | 有效期 | | CARDBACK | 非必填 | 返回 | 卡片回收标志 | | TRANS_CHECK | 非必填 | 返回 | 交易唯一标识 | | ISS_NO | 非必填 | 返回 | 发卡行行号 | | ISS_NAME | 非必填 | 返回 | 发卡行名称 | | AUTH_NO | 非必填 | 返回 | 授权码 | | CARD_TYPE_IDENTY | 非必填 | 返回 | 借贷记卡标识0:借记 1:贷记 | | WILD_CARD_SIGN | 非必填 | 返回 | 内外卡标识0:内卡 1:外卡 | | ORIG_TRACE_NO | 非必填 | 返回 | 原始流水号 | | ORIG_REF_NO | 非必填 | 返回 | 原系统参考号 | | EXP_DATE | 非必填 | 返回 | 有效期 | | PRT_COMMON | 非必填 | 返回 | 打印内容公共部分(仅用于简易终端版) | | PRT_CARDHOLDER | 非必填 | 返回 | 打印内容持卡人联部分(仅用于简易终端版) | | PRT_MERCHANT | 非必填 | 返回 | 打印内容商户联部分(仅用于简易终端版) | | CARDTYPE | 非必填 | 返回 | 卡类型 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.3. 支付查询 – ]()扫码 **接口介绍:** 该接口用于订单扫码支付未出小票或未返回交易结果时使用,仅支持扫码支付。 **接口** **URL** **:** **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"600300003","CUST_DATA":"{\"BUSINESS_ID\":\"600300003\"}","CASH_ID":"HT000085","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"024a9f0f011ecf0f27b88cb3cc2cd81a","APP_PACKAGE_NM":"","APP_CLASS_NM":""}** **返回参数:** ** {"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"600300003","RSP_CODE":"Y0000","RSP_DATA":"{\"REJCODE_CN\":\"** **交易成功** **\",\"CUPS\":\"WXP\",\"MERCH_ID\":\"990605055336000\",\"TRANS_CHANNEL\":\"006\",\"BATCH_NO\":\"000023\",\"TIME\":\"140152\",\"REJCODE\":\"00\",\"SIGN\":\"db2cf46b425655fedea2d07828f7ddd8\",\"DATE\":\"0303\",\"TER_ID\":\"10000085\",\"ORDER_NO\":\"222222222\",\"CARD_FEE\":\"000000000000\",\"AMOUNT\":\"000000000001\",\"REF_NO\":\"9357793739\",\"TRACE_NO\":\"112003370001041245\",\"PRINT_FLAG\":\"1\",\"CARDTYPE\":\"100\",\"BUSINESS_ID\":\"100300003\",\"TRANS_TICKET_NO\":\"112003370001041245\",\"MERCH_NAME\":\"** **进贤门店** **_** **测试** **3\",\"CARD_TYPE_IDENTY\":\"1\",\"USDK_VERSION_CODE\":\"S-LANDIA8-I00V5.0200108\",\"OPER_NO\":\"01|** **操作员** **1\",\"WILD_CARD_SIGN\":\"0\",\"TRANSTYPE\":\"005\",\"SIGN_FLAG\":\"0\"}","RSP_DESC":"** **云****MIS** **服务调用成功** **","ClOUD_MIS_TRX_SSN":"287222982818922496","SIGN_DATA":"649B5395C0F7E5A10AA53CE50621D598"}** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | -------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | ORDER_NO | 必填 | 返回 | 订单编号 | | CUPS | 必填 | 返回 | 支付类型渠道,银行卡为空(ALP:支付宝 WXP:微信支付) | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | TRANS_CHANNEL | 必填 | 返回 | 交易渠道(006:收银宝) | | BATCH_NO | 必填 | 返回 | 批次号 | | TRACE_NO | 必填 | 返回 | 凭证号(扫码支付为非必填) | | TRANS_TICKET_NO | 必填 | 返回 | 交易单号 | | AMOUNT | 必填 | 返回 | 支付金额,十二位长度(单位:分) | | REF_NO | 必填 | 返回 | 系统参考号 | | DATE | 必填 | 返回 | 支付日期 | | TIME | 必填 | 返回 | 支付时间 | | PRINT_FLAG | 必填 | 返回 | 是否打印小票(1:打印,0:未打印) | | CARD_FEE | 非必填 | 返回 | 手续费,十二位长度(单位:分) | | PRT_COMMON | 非必填 | 返回 | 打印内容公共部分(仅用于简易终端版) | | PRT_CARDHOLDER | 非必填 | 返回 | 打印内容持卡人联部分(仅用于简易终端版) | | PRT_MERCHANT | 非必填 | 返回 | 打印内容商户联部分(仅用于简易终端版) | | CARDNO | 非必填 | 返回 | 卡号(银行卡交易时返回卡号;扫码交易返回OPENID或USERID) | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.4. 支付查询 – ]()订单 **接口介绍:** 该接口用于订单支付结果的查询, **使用该接口终端需关闭订单冲正功能** 。 **注** :简易终端版返回的业务编码不是原交易的业务编码,并且简易终端版返回的小票内容中不区分微信、支付宝,统一定义为扫码。 **接口** **URL** **:** **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"600000002","CASH_ID":"kt008","STORE_ID":"md008","APP_ID":"11d2ee0d82abb7ef78dea6efee6b67a0","SIGN_DATA":"1e3ee26ef3fe7e0b309a4b9c32ea9adb","APP_PACKAGE_NM":"","APP_CLASS_NM":"","CUST_DATA":"{\"BUSINESS_ID\":\"600000002\",\"AMOUNT\":\"000000000010\",\"ORDER_NO\":\"112233\"}"}** **返回参数:** ** {"APP_ID":"11d2ee0d82abb7ef78dea6efee6b67a0","BUSINESS_ID":"100100002","RSP_CODE":"Y0000","RSP_DATA":"{\"CARDNO\":\"621485****1636\",\"REJCODE_CN\":\"** **交易成功** **\",\"MERCH_ID\":\"178290007631122\",\"TRANS_CHANNEL\":\"006\",\"BATCH_NO\":\"000006\",\"TIME\":\"194447\",\"ORIG_DATE\":\"0512\",\"REJCODE\":\"00\",\"SIGN\":\"528595e7845ff4dfbe58fbc93e436cdf\",\"DATE\":\"0512\",\"TER_ID\":\"00000008\",\"ORDER_NO\":\"112233\",\"CARD_FEE\":\"000000000000\",\"AMOUNT\":\"000000000001\",\"ISS_NO\":\"** **招商银行** **\",\"REF_NO\":\"136771065201\",\"TRACE_NO\":\"000185\",\"PRINT_FLAG\":\"1\",\"BUSINESS_ID\":\"100100002\",\"TRANS_TICKET_NO\":\"112036770001065201\",\"MERCH_NAME\":\"** **雪茄的店** **6\",\"CARD_TYPE_IDENTY\":\"0\",\"ISS_NAME\":\"** **招商银行** **\",\"USDK_VERSION_CODE\":\"S-PAXA930-I00V5.0200512\",\"OPER_NO\":\"01|** **操作员** **1\",\"WILD_CARD_SIGN\":\"0\",\"TRANSTYPE\":\"005\",\"SIGN_FLAG\":\"0\"}","RSP_DESC":"** **云****MIS** **服务调用成功** **","ClOUD_MIS_TRX_SSN":"312676481123876864","SIGN_DATA":"0EDB73A87B74A7EF1301C4CBA90351C3"}** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | ----------------------- | ---------------- | --------------------------------------------- | -------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | ORDER_NO | 必填 | 请求 | 订单编号 | | ORIG_DATE | 必填 | 请求 | 原交易日期 | | BUS_INFOTRANS_CHECK | 非必填非必填 | 请求请求 | 扩展字段(详见附录,仅使用 IS_PRINT 字段)交易唯一标识 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | ORDER_NO | 必填 | 返回 | 订单编号 | | CUPS | 必填 | 返回 | 卡组织,银行卡为空(ALP:支付宝 WXP:微信支付) | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | TRANS_CHANNEL | 非必填 | 返回 | 交易渠道(006:收银宝) | | BATCH_NO | 必填 | 返回 | 批次号 | | TRACE_NO | 必填 | 返回 | 凭证号(扫码支付为非必填) | | TRANS_TICKET_NO | 必填 | 返回 | 交易单号 | | AMOUNT | 必填 | 返回 | 支付金额,十二位长度(单位:分) | | REF_NO | 必填 | 返回 | 系统参考号 | | DATE | 必填 | 返回 | 交易日期(非原交易) | | TIME | 必填 | 返回 | 交易时间(非原交易) | | PRINT_FLAG | 非必填 | 返回 | 是否打印小票(1:打印,0:未打印) | | CARD_FEE | 非必填 | 返回 | 手续费,十二位长度(单位:分) | | DISC_AMOUNT | 非必填 | 返回 | 优惠金额 | | ACTUALLY_AMOUNT | 非必填 | 返回 | 实付金额 | | EXP_DATE | 非必填 | 返回 | 有效期 | | AUTH_NO | 非必填 | 返回 | 授权码 | | CARDNO | 非必填 | 返回 | 银行卡交易时返回卡号;扫码交易返回OPENID或USERID | | CARD_TYPE_IDENTY | 非必填 | 返回 | 借贷记卡标识(银行卡)0:借记 1:贷记 | | WILD_CARD_SIGN | 非必填 | 返回 | 内外卡标识(银行卡)0:内卡 1:外卡 | | TRANS_CHECK | 非必填 | 返回 | 交易唯一标识 | | MEMO | 非必填 | 返回 | 备注信息 | | SIGN | 非必填 | 返回 | 签名 | | PRT_COMMON | 非必填 | 返回 | 打印内容公共部分(仅用于简易终端版) | | PRT_CARDHOLDER | 非必填 | 返回 | 打印内容持卡人联部分(仅用于简易终端版) | | PRT_MERCHANT | 非必填 | 返回 | 打印内容商户联部分(仅用于简易终端版) | | CARDTYPE | 非必填 | 返回 | 卡类型 | | ISS_NO | 非必填 | 返回 | 发卡行行号 | | ISS_NAME | 非必填 | 返回 | 发卡行名称 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.5. 当日交易明细查询打印]() **接口介绍:** 该接口用于当日交易明细查询及打印(智能终端USDK打印)。 **注** :简易终端版不支持该交易。 **接口** **URL** **:** **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"CFFFFFFFE","CASH_ID":"HT000085","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"db6d90c0b3bde55f2a2b1fcef2c48820","CUST_DATA":"{\"BUSINESS_ID\":\"CFFFFFFFE\",\"AMOUNT\":\"000000000010\",\"ORDER_NO\":\"2222222222\"}"}** **返回参数:** ** {"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"CFFFFFFFE","RSP_CODE":"E0030","RSP_DATA":"{\"REJCODE\":\"X3\",\"REJCODE_CN\":\"** **终端无交易记录** **\",\"BUSINESS_ID\":\"CFFFFFFFE\",\"MERCH_ID\":\"990605055336000\",\"TER_ID\":\"10000085\",\"MERCH_NAME\":\"** **进贤门店** **_** **测试** **3\"}","RSP_DESC":"** **查询失败** **","ClOUD_MIS_TRX_SSN":"388368403833815040","SIGN_DATA":"3C07A270F1B67D8266221E2D07E9524C"}** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | -------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | ORIG_TRACE_NO | 非必填 | 请求 | 原交易流水号 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | TRANS_LIST | 非必填 | 返回 | 当日交易明细 | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.6. 当日交易汇总查询打印]() **接口介绍:** 该接口用于当日交易汇总查询及打印(智能终端USDK打印)。 **注** :简易终端版不支持该交易。 **接口** **URL** **:** **接口出入参示例:** **请求参数:** **{"BUSINESS_ID":"CFFFFFFFD","CASH_ID":"HT000085","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"ca94c3823de9be110c39f36872f94161","CUST_DATA":"{\"BUSINESS_ID\":\"CFFFFFFFD\",\"AMOUNT\":\"000000000010\",\"ORDER_NO\":\"2222222222\"}"}** **返回参数:** ** {"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"CFFFFFFFD","RSP_CODE":"E0030","RSP_DATA":"{\"REJCODE\":\"X3\",\"REJCODE_CN\":\"** **终端无交易记录** **\",\"BUSINESS_ID\":\"CFFFFFFFD\",\"MERCH_ID\":\"990605055336000\",\"TER_ID\":\"10000085\",\"MERCH_NAME\":\"** **进贤门店** **_** **测试** **3\"}","RSP_DESC":"** **查询失败** **","ClOUD_MIS_TRX_SSN":"388369573809750016","SIGN_DATA":"2510DF14FDE5F9D0ACBC4F7CFABA1303"}** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | -------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | ORIG_TRACE_NO | 非必填 | 请求 | 原交易流水号 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | TRANS_LIST | 非必填 | 返回 | 当日交易汇总 | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.7. 打印指定内容]() **接口介绍:** 该接口用于商户打印自定义内容(实际调用USDK-指定打印内容接口)。 **注** :简易终端版不支持该交易。 **接口** **URL** **:** **接口出入参示例:** **自定义内容:** {"PRINT_APPEND_PAGE":"1","PRINT_VERSION":"1","BUSINESS_ID":"900300003","PRINT_APPEND_CONTENT":"[{\"PRINT_APPEND_TEXT\":\"交易订单号:20190327040652247\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"订单实收:200\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"订单总价:250\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"会员折扣:0\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"优惠券:50\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"商家优惠:0\",\"PRINT_APPEND_PIC\":\"\"},{\"PRINT_APPEND_TEXT\":\"下单时间:2019-03-27 08:06:00\",\"PRINT_APPEND_PIC\":\"\"}]"} **请求参数:** {"BUSINESS_ID":"900300003","CASH_ID":"HT000085","STORE_ID":"0001","APP_ID":"22edd04a19dd4bae815f20a9ab052adf","SIGN_DATA":"ce80e25cca90570f40785892050adf6f","CUST_DATA":"{\"PRINT_APPEND_PAGE\":\"1\",\"PRINT_VERSION\":\"1\",\"BUSINESS_ID\":\"900300003\",\"PRINT_APPEND_CONTENT\":\"[{\\\"PRINT_APPEND_TEXT\\\":\\\"交易订单号:20190327040652247\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"订单实收:200\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"订单总价:250\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"会员折扣:0\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"优惠券:50\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"商家优惠:0\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"},{\\\"PRINT_APPEND_TEXT\\\":\\\"下单时间:2019-03-27 08:06:00\\\",\\\"PRINT_APPEND_PIC\\\":\\\"\\\"}]\"}"} **返回参数:** {"APP_ID":"22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID":"900300003","RSP_CODE":"Y0000","RSP_DATA":"{\"REJCODE_CN\":\"交易成功\",\"PRINT_FLAG\":\"1\",\"MERCH_ID\":\"990605055336000\",\"TRANS_CHANNEL\":\"006\",\"BUSINESS_ID\":\"900300003\",\"MERCH_NAME\":\"进贤门店_测试3\",\"REJCODE\":\"00\",\"USDK_VERSION_CODE\":\"S-PAXA920-I00V5.0210722\",\"OPER_NO\":\"01|操作员1\",\"SIGN\":\"25216a8758d181f8eac4fafe3f9957a5\",\"BUS_INFO\":{},\"TER_ID\":\"10000085\",\"SIGN_FLAG\":\"0\"}","RSP_DESC":"云MIS服务调用成功","ClOUD_MIS_TRX_SSN":"511261075895746560","SIGN_DATA":"E7F84A6CF9EF8F1BEA1345E70CD4EAF4"} **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | ---------------------- | ---------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | PRINT_APPEND_PAGE | 必填 | 请求 | 需要打印的联数 | | PRINT_VERSION | 必填 | 请求 | 0 –USDK 2.4.8前 (默认)1 –USDK 2.4.8及后版本为0是只允许对打印字体进行统一设置 无需 PRINT_APPEND_CONTENT 参数 | | PRINT_APPEND_CONTENT | List | 请求 | 每一组打印后换行 | | PRINT_APPEND_TEXT | 必填 | 请求 | 需要打印的文字注意:字数过多自行添加换行符(\n) | | PRINT_APPEND_PIC | 必填 | 请求 | 需要打印的图片(Bitmap格式)图片转换成字符串的形式进行传递 | | PRINT_APPEND_BOLD | 必填 | 请求 | true -打印粗体false –不打印粗体 默认 | | PRINT_APPEND_SIZE | 必填 | 请求 | 16 – 小字体24 - 中字体 默认32 – 大字体 | | PRINT_APPEND_LOCATE | 必填 | 请求 | 0 – 左对齐 默认1 - 行中开始-左对齐2 – 右对齐3 – 行居中4 – 左对齐居中5 – 右对齐居中 | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | MERCH_NAME | 必填 | 返回 | 商户名称 | | MERCH_ID | 必填 | 返回 | 商户编号 | | TER_ID | 必填 | 返回 | 终端编号 | | PRINT_FLAG | 非必填 | 返回 | 打印标记 | | USDK_VERSION_CODE | 非必填 | 返回 | USDK版本号 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 | | | | | | | | ### [1.1.8. 日志远程获取(无需商户对接)]() **接口介绍:** 该接口用于获取指定日期的云MIS APP日志,由云MIS管理平台界面发起,无需商户操作。 **接口** **URL** **:** **接口出入参示例:** **请求参数:** **返回参数:** **无需返回** **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | --------------------- | | APP_ID | 必填 | 请求 | 应用分配ID | | BUSINESS_ID | 必填 | 请求 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | LOG_DATE | 必填 | 请求 | 日志文件日期 | | MERCH_ID | 必填 | 请求 | 商户编号 | | TER_ID | 必填 | 请求 | 终端编号 | | CASH_ID | 非必填 | 请求 | 收银机款台号 | | STORE_ID | 非必填 | 请求 | 商户分店号 | | ClOUD_MIS_TRX_SSN | 非必填 | 请求 | 云MIS系统唯一流水号 | ### [1.1.9. 读卡信息]() **接口介绍:** 该接口用于获取指定读卡信息。 **注意** **:所有银行卡片均是刷卡** **,**** M1****卡是挥卡。** **接口** **URL** **:** **接口出入参示例:** **请求参数:** {"BUSINESS_ID":"900300001","CASH_ID":"KT10450107","STORE_ID":"MD0002","APP_ID":"11d2ee0d82abb7ef78dea6efee6b67a0","SIGN_DATA":"d55c7687df7c6049490b96ab2fd8790f","APP_PACKAGE_NM":"","APP_CLASS_NM":"","CUST_DATA":"{\"BUSINESS_ID\":\"900300001\",\"AMOUNT\":\"000000000001\",\"ORDER_NO\":\"2222222222\"}"} **返回参数:** {"APP_ID":"11d2ee0d82abb7ef78dea6efee6b67a0","BUSINESS_ID":"900300001","RSP_CODE":"Y0000","RSP_DATA":"{\"CARDNO\":\"8698890000000000041\",\"REJCODE_CN\":\"交易成功\",\"PRINT_FLAG\":\"0\",\"MERCH_ID\":\"178290007631122\",\"TRANS_CHANNEL\":\"006\",\"BUSINESS_ID\":\"900300001\",\"MERCH_NAME\":\"雪茄人广店\",\"REJCODE\":\"00\",\"USDK_VERSION_CODE\":\"S-LANDIA8-I00V5.0220802\",\"OPER_NO\":\"01|操作员1\",\"SIGN\":\"42fd5e8377d60c8898e2154220180b6f\",\"BUS_INFO\":{},\"TER_ID\":\"10450107\",\"SIGN_FLAG\":\"0\"}","RSP_DESC":"云MIS服务调用成功","ClOUD_MIS_TRX_SSN":"609066491576320000","SIGN_DATA":"648C7619F7DA04945039F3248BFABE3C"} **接口字段注释:** JSON格式的String字符串 | **参数名称** | **必填** | **请求** **/** **返回** | **注释** | | -------------------- | ---------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | APP_ID | 必填 | 请求、返回 | 应用分配ID | | BUSINESS_ID | 必填 | 请求、返回 | 业务类型 | | CUST_DATA | | 必填 | 请求 | 具体的支付请求数据,JSON格式字符串 | | BUSINESS_ID | 必填 | 请求 | 同业务类型 | | VALIDATE_INFO | 必填 | 请求 | **此项当读取****M1****卡** **参考****[附录2](https://aipboss.allinpay.com/know/devhelp/home.php?id=896#_%E9%99%84%E5%BD%952%EF%BC%8C%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B5%E8%AF%B4%E6%98%8E)**必填如下参数KEY_TYPESECRET_KEYBLOCK_NO | | CASH_ID | 必填 | 请求 | 收银机款台号 | | STORE_ID | 必填 | 请求 | 商户分店号 | | SIGN_DATA | 必填 | 请求、返回 | 计算方法参照附录1 | | APP_PACKAGE_NM | 非必填 | 请求 | 指定APP包名 | | APP_CLASS_NM | 非必填 | 请求 | 指定类名 | | RSP_CODE | 必填 | 返回 | 云MIS系统服务调用返回码, 支付返回代码请参考RSP_DATA里支付结果字段 | | RSP_DATA | | 必填 | 返回 | 透传支付产品给云MIS的响应JSON字符串 | | | BUSINESS_ID | 必填 | 返回 | 业务类型 | | CARDNO | 必填 | 返回 | 卡号 | | SN | 必填 | 返回 | 设备序列号 | | MODEL | 必填 | 返回 | 设备型号 | | VENDOR | 必填 | 返回 | 设备品牌 | | VERSIONCODE | 必填 | 返回 | 驱动版本号 | | CERTIFICATION | 必填 | 返回 | 入网许可证号 | | REJCODE | 必填 | 返回 | 交易返回码 | | REJCODE_CN | 必填 | 返回 | 交易返回码注释 | | CVN | 非必填 | 返回 | 通联86开头的预付费卡CVN值 | | MERCH_NAME | 非必填 | 返回 | 商户名称 | | MERCH_ID | 非必填 | 返回 | 商户编号 | | TER_ID | 非必填 | 返回 | 终端编号 | | PRINT_FLAG | 非必填 | 返回 | 打印标记 | | SIGN | 非必填 | 返回 | 签名 | | USDK_VERSION_CODE | 非必填 | 返回 | USDK版本号 | | RSP_DESC | 非必填 | 返回 | 交易级返回描述 | | ClOUD_MIS_TRX_SSN | 必填 | 返回 | 交易成功返回,云MIS系统唯一流水号,用于查询或对账 |
顾俊gujun1
2025年3月4日 14:31
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期