主题
关闭支付订单
POST /api/pay/close
需要公共签名参数。订单必须属于当前商户应用。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| payOrderId | string | 二选一 | 平台支付订单号,优先使用 |
| mchOrderNo | string | 二选一 | 商户订单号 |
关闭规则
- 状态 0:尚未进入渠道支付,直接关闭本地订单。
- 状态 1:请求原渠道关闭,只有渠道明确确认后才置为关闭。
- 状态 6:重复关闭按成功返回。
- 其他状态:拒绝关闭;已支付订单应走退款流程。
渠道结果未知或订单同时被支付成功回调更新时,关闭可能报错,应重新查询。接口错误不等于渠道已关闭。
响应 data
| 字段 | 类型 | 说明 |
|---|---|---|
| payOrderId、mchOrderNo | string | 支付订单标识 |
| state | integer | 成功关闭为 6 |
| channelState | string | CONFIRM_SUCCESS |
| channelOrderNo | string / null | 本次关闭返回的渠道订单号,可能为空 |
| errMsg | string / null | 错误描述 |
json
{
"code": 0,
"data": {
"payOrderId": "P_DEMO", "mchOrderNo": "ORDER_DEMO", "state": 6,
"channelState": "CONFIRM_SUCCESS", "channelOrderNo": null, "errMsg": null
},
"sign": "对data计算的签名"
}