跳转至

请求分账

请求方式 body 编码 接口地址
POST application/json UTF-8 集测：https://mchapitest.shengpay.com/sharing/applySharing
生产：https://mchapi.shengpay.com/sharing/applySharing

接口描述

主要用于服务平台帮助特约商户完成订单收单成功后的资金分配。

请求参数

变量名 类型 必填 示例值 描述
mchId String(10) Y 30057906 商户号
mchSharingNo String(64) Y 202008300806125346 商户分账单号,平台商系统内部的分账单号，在平台商系统内部唯一
transactionId String(64) Y M20221203828280742564376576 盛付通支付订单号
totalAmount int Y 分账总金额,分账接收方列表分账金额之和，单位分
notifyUrl String(256) N 通知地址
devId String(64) N 开发者账号,分账接收方类型有C时必传
receivers String(1024) Y [{
"amount": 1,
"description": "test1",
"receiverId": "5578578",
"receiverType": "B"
},
{
"amount": 1,
"description": "test1",
"receiverId": "75858863",
"receiverType": "B"
}]		 分账接收方列表(JSON字符串)，不超过5项
receiverType String(10) Y B 分账接收方类型,B商户，C钱包会员
receiverId String(64) Y 30057908 分账接收方标识,接收方类型是B时，是商户号
接收方类型是C时，是钱包会员unionId
amount int Y 10 分账金额,单位分
description String(64) Y 分账描述
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
    "mchId": "88021534",
    "mchSharingNo": "1634807502",
    "receivers": "[{\"amount\":200,\"description\":\"test1\",\"receiverId\":\"88021534\",\"receiverType\":\"B\"}]",
    "totalAmount": 200,
    "transactionId": "M20201016348523693586163952",
    "nonceStr": "nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy",
    "signType": "RSA",
    "sign": "VJwA2kXDnLiC8bH7Ywzc/fktd5zITLi9d5dobzaf3PCKy7hMecg1zqQz9X9GhqLMj5e2dOeDI2mrF06EJZdugcD+5BW2MA+MK32eMuwoRAh510HSusN2HaE4ser99rLJSvMPn5bEqNdDX83XixGePa4iyFiV0YdOfDu0T6VgDBFwbO0St73j0NxgPrIVM/tTmax1jwsAUl60BG4N+LKZxQYH0whsUOE9jgAjhcX8BD0GC3BMzNaEZyrn6noWvA6Ir95f/ZXww07rp8vPPzn99LtNzBFczx3k3H9o4e4K5BL+d+bzULMm9VvWrSObBri+wMy+VB978wGVftobFUkn/Q=="
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
mchId String(10) N 商户号
mchSharingNo String(64) N 平台商分账分账单号
transactionId String(64) N 盛付通支付订单号
sharingNo String(64) N 盛付通分账单号
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名

响应参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
    "resultCode": "SUCCESS",
    "returnCode": "SUCCESS",
    "returnMsg": "OK",
    "mchId": "88021534",
    "mchSharingNo": "1634807502",
    "transactionId": "M20201016348523693586163952",
    "sharingNo": "S657993611963006976",
    "sign": "XyIoxGodrNZqsPE6xut9Yd0Pq5sk1VBkKAb7McrBgRtJr7R83u3n5ckTZByn4rxXUglViO3EYA8sYCWl54nNQf+5AVluJIZu5BmO6rZLxtgcCE2ismw3nqTX880RK/E+HtFHnpBqyf14ua5+MQ1gvt0r+klql7/+Osu3QF9LtGk=",
    "signType": "RSA",
    "nonceStr": "iuwYIztuezXtzoJmRfsDZKhsFTxOuznj"
}

错误码

错误码 描述 解决方案
SIGN_ERROR 签名错误 验证签名算法
PARAMS_ERROR 参数问题 请检查参数值是否符合
SYSTEM_ERROR 系统错误 系统异常，请调用分账查询接口确认业务结果
NO_AUTH 无此接口权限 请申请此接口权限
NO_SHARING_AUTH 无分账权限 请先开通分账
RECEIVER_INVALID 分账接收方非法 分账接收方在分账之前需要进行添加
NOT_ENOUGH 可分账余额不足 分账金额不能大于订单剩余可分金额，请调整分账金额
DUPLICATE_ORDER 重复的订单 请检查分账单号是否重复，在平台商系统内部唯一
ORDER_NOT_EXIST 订单不存在 请检查transactionId是否正确
ORDER_NOT_READY 订单未结算 订单未结算，暂时无法分账
NOT_SHARING_ORDER 非分账订单 不是分账订单，无法分账，下单时请用分账的合适参数
ORDER_STATUS_ABNORMAL 订单状态异常 订单所在状态下不允许进行分账操作，请先确认订单状态
RATIO_AMOUNT_OVERDUE 超出分账比例上限 分给他人的金额超过分账比例限制
SHARING_PERIOD_OVERDUE 订单已超过可分账周期 订单超过可分账周期，请确认订单时间
Back to top