商户银联报备

功能概述

商户通过此接口为子商户进行银联报备。

接口地址

https://apis.5upay.com/serviceprovider/report/cupApiReport

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
partnerId 服务商编号 varchar(9) 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
merchantId 商户编号 varchar(9) 商户在首信易系统唯一身份标识,商户可登录商户后台查看 M
requestId 银联报备订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已报备成功或失败的订单,商户平台不能以相同订单号再次提交 M
distributorNo 渠道号 varchar(20) 银联渠道号，平台商户接入模式必传，用平台报备的银联商户号 O
prodFunc 产品功能套餐 固定值 0102 银联侧无跳转标准版 M
0103 银联侧无跳转token版
0104 在线网关
0106 云闪付收银台(云闪付及手机闪付直通模式)
0109 在线网关支付(仅网银)
0118 POS+二维码(主扫)
0122 商户侧无跳转标准版
0123 商户侧无跳转token版
0124 车主生活
0125 大湾区出行
0136 云闪付收银台
0137 云闪付协议支付
1001 B2C
1101 B2B
1601 无卡快捷
levelRates 价格套餐 固定值 LOW_RATE 价格套餐 1 C
HIGH_RATE 价格套餐 2
distributorNo为空时,该参数必传。distributorNo不为空时,该参数内的值不生效
specTransTpChnl 非标交易类型及渠道 varchar(20) 共需补足20位数字,根据非标交易类型及渠道列表顺序,确定每一位的值,对应位开通为1,不开通为0。 C
distributorNo为空且levelRates为LOW_RATE时。distributorNo不为空时,该参数内的值不生效
notifyUrl 异步通知地址 varchar(200) 服务器通知:当报备状态为终态后首信易服务器会向该地址发送通知,该地址可以带参数,如:http://www.5upay.com/callback.action?test=test M
filePaths 材料内容路径 Array 填写文件的sftp路径,需将文件上传到sftp.文件名称须以《材料类型取值》的材料代码命名:最大不超过10M，格式限制为jpg,jpeg,png,pdf C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M
非标交易类型及渠道列表
第一位 线上消费业务
第二位 线下消费业务
第三位 订购及实时代收业务
第四位 批量代收业务
第五位 贷记业务
第六位 二维码业务
第七位 预留
第八位 预留
第九位 预留
第十位 预留
第十一位 预留
第十二位 预留
第十三位 预留
第十四位 预留
第十五位 预留
第十六位 预留
第十七位 预留
第十八位 预留
第十九位 预留
第二十位 预留

参数示例

{ "levelRates": "LOW_RATE", "filePaths": [ "/serviceprovider/unionMeterial_1", "/serviceprovider/unionMeterial_2" ], "hmac": "304502201be14243f4fc5dbe19b52249ce3b80ec727898bb53f6 7113c3766af0804b4a10022100d2ec7cd6bc9133c8ef40a35a94dc3c8 ab160786b4cfb87a073238d0d5364ae0b", "merchantId": "89***9", "notifyUrl": "https://qa-sdk.5upay.com/onlinepay/notify_V3", "partnerId": "89***13", "prodFunc": "0101", "requestId": "165***333", "specTransTpChnl": "00000100000000000000" }

同步参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
requestId 银联报备订单号 同请求参数
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
reportStatus 报备状态 INIT 处理中
SUCCESS 成功
FAILED 失败
mchId 银联商户号 银联商户号
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果，验签过程请参考解密流程

参数示例

{ "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjyIq O3s6vlZXRGTrTTDdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5xtIQJC+hkCut apw/KWOHsGDhi4M71veSjB4GhGOTd8uaaIeLe8PB8iD8ykibeTO1sr+5CP UU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kdh0NhRbsoIgYlE5XNPPb9wHYM MSzVC+UNuC2QEoBsTm/vfwMNsCL3j3j4CFt/nQFvXtGz1CVgl8PMmeq+4H FaCBNxrtFmQ1ikXry87LQebe1w2JxSi5J7flU1mIQUytBA+pP+ahVghKg==", "mchId": "81***SSY", "merchantId": "89***84", "partnerId": "89***13", "reportStatus": "SUCCESS", "requestId": "165***74331", "status": "SUCCESS" }

异步参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
requestId 银联报备订单号 同请求参数
reportStatus 报备状态 INIT 处理中
SUCCESS 成功
FAILED 失败
mchId 银联商户号 银联商户号
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果，验签过程请参考解密流程

参数示例

{ "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjyIq O3s6vlZXRGTrTTDdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5xtIQJC+hkCut apw/KWOHsGDhi4M71veSjB4GhGOTd8uaaIeLe8PB8iD8ykibeTO1sr+5CP UU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kdh0NhRbsoIgYlE5XNPPb9wHYM MSzVC+UNuC2QEoBsTm/vfwMNsCL3j3j4CFt/nQFvXtGz1CVgl8PMmeq+4H FaCBNxrtFmQ1ikXry87LQebe1w2JxSi5J7flU1mIQUytBA+pP+ahVghKg==", "mchId": "816***SSY", "merchantId": "89***84", "partnerId": "89***13", "reportStatus": "SUCCESS", "requestId": "1653***74331" }