商户接口列表 (关闭)
需要授权
只有未支付成功的订单可以关闭,关闭之后的订单无法再支付成功。
请求参数:
POST请求地址:
环境 |
http请求地址 |
正式环境 |
https://openapi.duolabao.com/v1/customer/order/close |
公共请求参数:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
customerNum |
String |
是 |
32 |
商户号 |
10001114596730086163709 |
requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
315080832507485 |
bankRequestNum |
String |
主扫订单必填 |
32 |
主扫订单返回的支付流水号 |
10031115009669622861143 |
请求示例:
-
1
|
{
|
2
|
"customerNum": "10001114991390825070154",
|
3
|
"requestNum": "3454354444432",
|
4
|
"bankRequestNum": "10031115009669622861143"
|
5
|
}
|
返回参数JSON格式:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
result |
String |
是 |
32 |
success表示成功,fail表示失败,error表示异常 |
success |
customerNum |
String |
是 |
32 |
商户编号 |
10001114596730086163709 |
requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
3454354444432 |
响应示例:
-
1
|
{
|
2
|
"data": {
|
3
|
"customerNum": "10001114596730086163709",
|
4
|
"requestNum": "10021015009643395281146",
|
5
|
},
|
6
|
"result": "success"
|
7
|
}
|
错误响应示例:
-
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
|
}
|
错误码解释:
错误码 |
错误描述 |
解决方案 |
ORDER_NOT_EXISTS |
order not exists |
订单不存在 |
ORDER_STATUS_NOT_INIT |
order status is not INIT |
订单状态不是INIT |
CUSTOMERNUM_NOT_RIGHT |
customerNum is not right |
商户号不正确 |
CANCELING |
canceling |
订单撤销中 |
CANCEL_ALREADY_SUCCESS |
order already cancel success |
订单已撤销 |
CLOSING |
closing |
订单关闭中 |
CLOSE_ALREADY_SUCCESS |
order already close success |
订单已关闭 |
PAY_NOT_EXISTS |
pay not exist |
支付记录不存在 |
PAY_STATUS_NOT_INIT |
pay status is not INTI |
支付状态不是INIT |
ORDER_NOT_SUPPORT |
order not support |
该订单不支持撤销 |
BANK_NOT_SUPPORT |
bank not support |
该笔交易不支持关闭操作,请联系客服。 |
BANK_ERROR |
bank error |
请求银行报错 |
BANK_FAIL |
bank fail |
请求银行返回失败 |