商户微信报备

功能概述

商户通过此接口为二级商户进行微信报备。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
partnerId 服务商编号 varchar(9) 二级商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
merchantId 商户编号 varchar(9) 商户在首信易系统唯一身份标识,商户可登录商户后台查看 M
requestId 微信报备订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已报备成功或失败的订单,商户平台不能以相同订单号再次提交 M
channelType 通道类型 固定值 cup.wechat.online 银联微信线上 M
cup.wechat.offline 银联微信线下
distributorNo 渠道号/PID号 varchar(50) 微信渠道号 M
merchantShortName 商户简称 varchar(20) 展示给消费者的商户名称 M
servicePhone 客服电话 varchar(20) 在支付详情页展示给消费者 M
contact 联系人姓名 varchar(10) 联系人姓名,若不填写,默认为入网时的联系人姓名 O
contactPhone 联系人电话 varchar(11) 联系人电话,若不填写,默认为入网时的联系人手机号 O
contactEmail 联系人邮箱 varchar(30) 电子邮箱,若不填写,默认为入网时的联系人邮箱 O
merchantRemark 商户备注 varchar(30) 备注 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "channelType": "cup.wechat.offline", "contact": "测试", "contactEmail": "tes***.com", "contactPhone": "188***8888", "distributorNo": "432210348", "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgkn oyjyIqO3s6vlZXRGTrTTDdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5 xtIQJC+hkCutapw/KWOHsGDhi4M71veSjB4GhGOTd8uaaIeLe8PB 8iD8ykibeTO1sr+5CPUU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kd h0NhRbsoIgYlE5XNPPb9wHYMMSzVC+UNuC2QEoBsTm/vfwMNsCL3 j3j4CFt/nQFvXtGz1CVgl8PMmeq+4HFaCBNxrtFmQ1ikXry87LQe be1w2JxSi5J7flU1mIQUytBA+pP+ahVghKg==", "merchantId": "897302333", "merchantRemark": "备注", "merchantShortName": "二级商户", "partnerId": "898652209", "requestId": "1653033238541", "servicePhone": "1888888888" }

请求返回参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
requestId 微信报备订单号 同请求参数
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
reportSerialNo 报备序列号 商户每次报备,均有对应的唯一报备序列号
mchId 微信商户号 微信商户号
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "mchId": "51***034", "merchantId": "89***33", "partnerId": "89***209", "reportSerialNo": "89***3322", "requestId": "165***541", "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgkno yjyIqO3s6vlZXRGTrTTDdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5xt IQJC+hkCutapw/KWOHsGDhi4M71veSjB4GhGOTd8uaaIeLe8PB8iD 8ykibeTO1sr+5CPUU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kdh0Nh RbsoIgYlE5XNPPb9wHYMMSzVC+UNuC2QEoBsTm/vfwMNsCL3j3j4C Ft/nQFvXtGz1CVgl8PMmeq+4HFaCBNxrtFmQ1ikXry87LQebe1w2J xSi5J7flU1mIQUytBA+pP+ahVghKg==", "status": "SUCCESS" }