Skip to content

关闭支付订单 ​

POST /api/pay/close

需要公共签名参数。订单必须属于当前商户应用。

字段类型必填说明
payOrderIdstring二选一平台支付订单号,优先使用
mchOrderNostring二选一商户订单号

关闭规则 ​

  • 状态 0:尚未进入渠道支付,直接关闭本地订单。
  • 状态 1:请求原渠道关闭,只有渠道明确确认后才置为关闭。
  • 状态 6:重复关闭按成功返回。
  • 其他状态:拒绝关闭;已支付订单应走退款流程。

渠道结果未知或订单同时被支付成功回调更新时,关闭可能报错,应重新查询。接口错误不等于渠道已关闭。

响应 data ​

字段类型说明
payOrderId、mchOrderNostring支付订单标识
stateinteger成功关闭为 6
channelStatestringCONFIRM_SUCCESS
channelOrderNostring / null本次关闭返回的渠道订单号,可能为空
errMsgstring / null错误描述
json
{
  "code": 0,
  "data": {
    "payOrderId": "P_DEMO", "mchOrderNo": "ORDER_DEMO", "state": 6,
    "channelState": "CONFIRM_SUCCESS", "channelOrderNo": null, "errMsg": null
  },
  "sign": "对data计算的签名"
}

接口行为以当前 payment 实现为准。示例商户号与密钥均为虚构。