向个人收银 (C2B 支付)
接口列表
订单关闭

订单关闭

业务方调用此接口将订单进行关闭。 以下四种订单中，可以发起订单关闭请求

  • BEFORE:预下单成功
  • INIT：初始化成功
  • PAYING：支付中
  • WAIT_CONFIRM: 待支付

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/pay/close_order

请求参数

Request
Body 包体
OutOrderId必填
string

外部订单号，即业务系统侧订单

最小长度：6     最大长度：60

请求示例

{
  "OutOrderId": "OUT2022111900000004"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "OutOrderId": "OUT2022111900000004",
      "OrderStatus": "CLOSED"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功需根据 Result 中 OrderStatus 字段为 CLOSED 判断为关单成功
ORDER.RECORD_NOT_EXIST订单不存在需要关闭的订单不存在，请检查订单号是否正确
ORDER.OPERATE_IS_PROCESSING订单存在并发操作当前支付订单同时存在别的请求操作(如退款、关单等)，请稍后重试
FailedOperation.SystemError系统未知异常系统未知异常，请稍后重试
ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数
ORDER.CURRENT_CANNOT_CLOSE无法关单请确认支付订单状态是否允许关单
腾讯微卡收付通接口文档