资源接口列表 (关闭订单)

需要授权

商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付;系统下单后, 用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。

请求参数:

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 错误信息 商户信息不存在,商户下订单信息不存在,商户下店铺不存在

响应示例:

  • JSON示例
  • 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 }