跳转至

分账回退

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

接口描述

仅对订单进行退款时，如果订单已经分账，可以先调用此接口将指定的金额从分账接收方回退给平台商户，然后再退款。 回退以原分账请求为依据，可以对分账接收方的金额进行多次回退，只要满足累计回退不超过该请求中分给接收方的金额。

请求参数

变量名 类型 必填 示例值 描述
mchId String(10) Y 30057906 商户号
mchSharingNo String(64) Y 202008300806125346 商户分账单号
mchReturnNo String(64) Y 202008300806125349 平台商系统内部的回退单号，在平台商系统内部唯一
notifyUrl String(256) N 通知地址
returnReceiverType String(16) Y B 回退方类型,B商户，C钱包会员
returnReceiverId String(64) Y 44541649 回退方类型是B时，是商户号
回退方类型是C时，是钱包会员unionId
returnAmount int Y 10 回退金额,单位分
returnDescription String(64) Y 回退描述,
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
    "mchId": "88021534",
    "mchReturnNo": "1634808076",
    "mchSharingNo": "1627883616",
    "returnAmount": 10,
    "returnDescription": "test",
    "returnReceiverId": "88021534",
    "returnReceiverType": "B",
    "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 商户分账单号
mchReturnNo String(64) N 商户回退单号
returnNo 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": "1627883616",
    "mchReturnNo": "1634808076",
    "returnNo": "R657996019342508032",
    "sign": "XyIoxGodrNZqsPE6xut9Yd0Pq5sk1VBkKAb7McrBgRtJr7R83u3n5ckTZByn4rxXUglViO3EYA8sYCWl54nNQf+5AVluJIZu5BmO6rZLxtgcCE2ismw3nqTX880RK/E+HtFHnpBqyf14ua5+MQ1gvt0r+klql7/+Osu3QF9LtGk=",
    "signType": "RSA",
    "nonceStr": "iuwYIztuezXtzoJmRfsDZKhsFTxOuznj"
}

错误码

错误码 描述 解决方案
SIGN_ERROR 签名错误 验证签名算法
PARAMS_ERROR 参数问题 请检查参数值是否符合
SYSTEM_ERROR 系统错误 系统异常，请调用回退查询接口确认业务结果
NO_AUTH 无此接口权限 请申请此接口权限
ORDER_NOT_EXIST 订单不存在 请确认分账单号是否存在
DUPLICATE_ORDER 重复的订单 请检查回退单号是否重复，在平台商系统内部唯一
NOT_ALLOW_RETURN 原分账订单不允许回退 请确认单号对应的分账状态
RETURN_OVERDUE 回退金额超限 回退金额大于从接收方回退的金额
Back to top