资源接口列表 (关闭订单)
需要授权
商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付;系统下单后, 用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。
请求参数:
POST请求地址:
环境 |
http请求地址 |
正式环境 |
https://openrealm.duolabao.com/v1/cancel |
公共请求参数:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
customerOpenId |
String |
是 |
32 |
商户openId |
10001114596730086163709 |
shopNum |
String |
是 |
32 |
店铺编号 |
10001214641783052104486 |
requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
315080832507485 |
请求头:
请求头 |
示例值 |
描述 |
timestamp |
102202020202 |
时间戳 |
token |
44B74C2B0BDA30F8C949FC9F20FA5CB123E179E7 |
根据密钥和算法生成的结果 |
accessToken |
3rdsfaij43209dfaojf |
从授权系统获得的accessToken值 |
accessKey |
fe02aa7e8f3249fe86c93774b7103d9945f80 |
用户的公钥 |
请求示例:
-
1
|
{
|
2
|
customerOpenId: "10001114815354961923264",
|
3
|
requestNum: "10021114975797623122666",
|
4
|
shopNum: "10001214815357451132294"
|
5
|
}
|
返回参数JSON格式:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
result |
String |
是 |
32 |
success表示成功,fail表示失败,error表示异常 |
success |
orderNum |
String |
否 |
32 |
订单编号 |
10001214641783052104486 |
cancelAmount |
String |
是 |
32 |
取消金额 |
40.00 |
errorCode |
String |
是 |
32 |
错误码 |
customerNotExist,orderNotExist,shopNotExist |
errorMsg |
String |
是 |
32 |
错误信息 |
商户信息不存在,商户下订单信息不存在,商户下店铺不存在 |
响应示例:
-
1
|
{
|
2
|
"data": {
|
3
|
"cancelAmount": "40.0",
|
4
|
"orderNum": "10021014975797623156608"
|
5
|
},
|
6
|
"result": "success"
|
7
|
}
|
错误响应示例:
-
1
|
{
|
2
|
"error": {
|
3
|
"errorCode": "customerNumNotExist",
|
4
|
"errorMsg":"customerNum not exist"
|
5
|
},
|
6
|
"result": "fail"
|
7
|
}
|
异常示例:
-
1
|
{
|
2
|
"error": {
|
3
|
"errorCode": "systemError",
|
4
|
"errorMsg":"错误描述"
|
5
|
},
|
6
|
"result": "error"
|
7
|
}
|