代理商接口列表 (部分退款)
需要授权
当交易发生之后一段时间内，由于商户的原因需要部分退款时，商户可通过该退款接口将需退款金额退还给交易者，哆啦宝将在收到退款请求并且验证成功之后，按照部分退款规则将需退款金额按原路退至交易者。交易时间不在系统退款周期内的订单将无法提交退款。部分退款支持单笔交易分多次退款(最多两次),累计退款金额不能超过用户实际支付金额。
请求参数：
POST请求地址：
| 环境 |
http请求地址 |
| 正式环境 |
https://openapi.duolabao.com/v1/agent/order/refund/part |
公共请求参数：
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| agentNum |
String |
是 |
32 |
代理商编号 |
10001114495558121971726 |
| customerNum |
String |
是 |
32 |
商户号 |
10001114596730086163709 |
| shopNum |
String |
是 |
32 |
店铺编号 |
10001214641783052104486 |
| requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
2014072300007148 |
| refundPartAmount |
String |
是 |
32 |
退款金额 |
0.01 |
| refundRequestNum |
String |
否 |
32 |
退款请求流水号 |
10081115470042926650008 |
请求示例：
-
|
1
|
{
|
|
2
|
"agentNum": "10001114495558121971726",
|
|
3
|
"customerNum": "10001114596730086163709",
|
|
4
|
"shopNum": "10001214513673242442196",
|
|
5
|
"requestNum": "315080832507485",
|
|
6
|
"refundPartAmount": "0.01"
|
|
7
|
"refundRequestNum": "10081115470042926650008"
|
|
8
|
}
|
返回参数JSON格式：
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| result |
String |
是 |
32 |
success表示成功，fail表示失败，error表示异常 |
success |
| orderNum |
String |
是 |
32 |
订单编号 |
10021014497548368512422 |
| refundRequestNum |
String |
否 |
32 |
退款请求流水号 |
10081115470042926650008 |
| bankRequestNum |
String |
否 |
32 |
退款请求银行流水号 |
112072300007148 |
| refundAmount |
String |
是 |
15,2 |
退款金额 |
10.05 |
| errorCode |
String |
否 |
32 |
错误码 |
shopNumNotExist |
| errorMsg |
String |
否 |
32 |
错误信息 |
shopNum not exist |
响应示例：
-
|
1
|
{
|
|
2
|
"data": {
|
|
3
|
"orderNum": "10021014497548368512422",
|
|
4
|
"refundRequestNum": "10081115470042926650008",
|
|
5
|
"bankRequestNum": "112072300007148",
|
|
6
|
"refundAmount": "10.05"
|
|
7
|
},
|
|
8
|
"result": "success"
|
|
9
|
}
|
错误响应示例：
-
|
1
|
{
|
|
2
|
"error": {
|
|
3
|
"errorCode": "shopNumNotExist",
|
|
4
|
"errorMsg":"shopNum not exist"
|
|
5
|
},
|
|
6
|
"result": "fail"
|
|
7
|
}
|
异常示例：
-
|
1
|
{
|
|
2
|
"error": {
|
|
3
|
"errorCode": "systemError",
|
|
4
|
"errorMsg":"错误描述"
|
|
5
|
},
|
|
6
|
"result": "error"
|
|
7
|
}
|
错误码解释：
| 错误码 |
错误描述 |
解决方案 |
| paramsError |
requestNum must be specified |
参数不正确 |
| customerNotExist |
customer not exist |
商户不存在 |
| shopNotExist |
requestNum invalid |
流水号无效，请确认流水号 |
| orderNotExist |
order not exist |
订单不存在 |
| orderHasNotPayRecord |
order has not pay record |
订单无支付记录 |
| accountStatusError |
account status error |
账户状态错误 |
| settleProcess |
settle process |
结算处理中 |
| notEnoughBlance |
not enough blance |
账户余额不足 |
| accountOutRepeat |
account out repeat |
重复出账 |
| orderIsRefund |
order is refund |
订单已退款 |
| orderNotRefunding |
order not refunding |
订单不是退款中状态 |
| refundAmountOut |
refund amount out |
金额超过可退金额 |
| refundCountOut |
refund count out |
超过退款次数 |
| refundTimeOut |
refund time out |
退款日期已过 |
| refundAmountError |
refund amount error |
退款金额有误 |
| orderNotComplete |
order not complete |
订单未完成 |