商户支付宝报备

功能概述

商户通过此接口为子商户进行支付宝报备。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
partnerId 服务商编号 varchar(9) 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
merchantId 商户编号 varchar(9) 商户在首信易系统唯一身份标识,商户可登录商户后台查看 M
requestId 支付宝报备订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已报备成功或失败的订单,商户平台不能以相同订单号再次提交 M
distributorNo 渠道号/PID号 varchar(20) 支付宝渠道号 M
merchantShortName 商户简称 varchar(20) 展示给消费者的商户名称 M
name 联系人姓名 varchar(128) 联系人姓名,若不填写,默认为入网时的contactName O
idCardNo 联系人身份证号 varchar(18) 联系人身份证号,若不填写,默认为空,若提交报备请求后提示主体信息不完整可以填写该参数后重新报备。(该参数仅主体为企业报备支付宝时有效) O
mobile 联系人手机号 varchar(20) 联系人电话,若不填写,默认为入网时的contactPhone O
email 联系人邮箱 varchar(128) 电子邮箱,若不填写,默认为入网时的contactEmail O
tag 联系人业务标识 固定值 商户联系人的职责: M
02 异议处理接口人
06 商户关键联系人
11 数据反馈接口人
08 服务联动接口人
type 联系人类型 固定值 LEGAL_PERSON 法人 M
CONTROLLER 实际控制人
AGENT 代理人
OTHER 其他
servicePhone 客服电话 varchar(20) 商户客服电话 M
indirectLevel 间连商户等级 固定值 拟申请的间连商户等级,具体申请结果以支付宝结果为准 O
INDIRECT_LEVEL_M1 M1等级
INDIRECT_LEVEL_M2 M2等级
INDIRECT_LEVEL_M3 M3等级
INDIRECT_LEVEL_M4 M4等级
若不填写,默认为M3等级
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "channelType": "cup.alipay.offline", "distributorNo": "2088341044805470", "email": "tes***.com", "hmac": "QDHlHrk9DRyfqdYwbGKlL7YqDNAogbtkvzV5B+1tjXn4Dfif6a YRrGmHjkK6WZiJpVzbsTtgbBYfPSyntF6IzeIGzZcpT+psWIvgv9rOV zfXkQ9gJLBZywVOJzySXu+tnQ4tgTw2TutTjgME5d+JVf5cD7EjlW+R WQ8FG/cuM8KSzWOkuqbq5O66fq4gbYZIs1xaWTNq4OJOsFOEIXm3BlH Mv9rOlEkwo+tE+07mKwT5pNWt8u6jstBoBoGRcpoJd4l8vVz2CqBFYd LtWxgx2DM4f5/ZmZn48m+yePbdUd0xmJ2GGJeH9GTyUn9vXpuiICtIQ VaGVXbt0sqG/92gqQ==", "indirectLevel": "INDIRECT_LEVEL_M3", "merchantId": "89***33", "merchantShortName": "测试", "mobile": "188***8888", "name": "首信易***子商户", "partnerId": "89***09", "requestId": "16***954", "servicePhone": "188888888", "tag": "02", "type": "LEGAL_PERSON" }

请求返回参数列表

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

参数示例

{ "mchId": "2088610130633818", "merchantId": "897302333", "partnerId": "898652209", "reportSerialNo": "89730233314", "requestId": "1653033579954", "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjy IqO3s6vlZXRGTrTTDdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5xtIQJC+h kCutapw/KWOHsGDhi4M71veSjB4GhGOTd8uaaIeLe8PB8iD8ykibeTO1 sr+5CPUU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kdh0NhRbsoIgYlE5XN PPb9wHYMMSzVC+UNuC2QEoBsTm/vfwMNsCL3j3j4CFt/nQFvXtGz1CVg l8PMmeq+4HFaCBNxrtFmQ1ikXry87LQebe1w2JxSi5J7flU1mIQUytBA +pP+ahVghKg==", "status": "SUCCESS" }