Cloudtay
Taypay v1

关闭订单接口

Taypay v1 关闭订单接口说明与示例。

关闭订单接口

POST /api/payment/open/v1/order/close
Content-Type: application/json

请求参数

字段类型必填说明
app_idstring商户应用 ID。
merchant_order_nostring商户订单号。
close_reasonstring关闭原因。
close_messagestring关闭原因说明。
timestampinteger秒级时间戳。
noncestring请求随机串。
sign_typestring固定为 HMAC-SHA256
signstring签名值。

请求示例:

{
  "app_id": "your_app_id",
  "merchant_order_no": "M202605220001",
  "close_reason": "merchant_close",
  "close_message": "用户取消支付",
  "timestamp": 1779465680,
  "nonce": "random_close_nonce",
  "sign_type": "HMAC-SHA256",
  "sign": "generate_by_app_secret"
}

响应参数

字段类型说明
codeinteger业务响应码, 0 表示成功。
messagestring响应说明。
dataobject关闭结果。
data.platform_order_nostring平台订单号。
data.statusinteger订单状态码。
data.lifecycle_statusstring订单生命周期状态。

响应示例:

{
  "code": 0,
  "message": "success",
  "data": {
    "merchant_order_no": "M202605220001",
    "platform_order_no": "EP202605220001",
    "status": -1,
    "lifecycle_status": "closed"
  }
}
Copyright © 2026