商户接口列表 (关闭)

需要授权

只有未支付成功的订单可以关闭,关闭之后的订单无法再支付成功。

请求参数:

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

响应示例:

  • JSON示例
  • 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 请求银行返回失败