3. 订单关闭接口

简要描述

• 商户支付-订单关闭

请求URL

• {domain}/open-api/payment/close

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	mandatory	string	application/json

请求体参数

参数名	必选	类型	说明
appId	是	string	应用APPID
param	是	string	参数体
sign	是	string	签名

param参数

参数名	必填	类型	长度限制	示例	说明
mchOrderId	否	string	1-32	-	商户订单id, 格式：字母+数字，1-32位 (mchOrderId 和 transactionId 传其中之一)
transactionId	否	string	1-32	-	交易编号 (mchOrderId 和 transactionId 传其中之一)
countryCode	是	string	-	-	国家编码 (PH, ID, MY, TH)
timestamp	是	long			当前时间戳

请求示例

请求体

{
   "appId": "733b887a4a784708bb369524db5b6ded",
   "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
   "param": "{\"mchOrderId\": \"10e051066810618100\",\"countryCode\":\"PH\",\"timestamp\":\"1677133173758\"}"
}

如何构造请求体

---

响应参数

参数名	类型	说明
code	integer	响应码
message	string	响应信息
data	Object	数据

data参数

参数名	类型	说明
mchOrderId	string	商户订单号
transactionId	string	交易编号
channelCode	string	收单渠道Code
status	string	状态 (CLOSED)
closedTime	string	关闭时间

响应示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "mchOrderId": "10e051066810618100",
        "transactionId": "CU510579106014826496",
        "channelCode": "PH_QRPH_DYNAMIC",
        "status": "CLOSED",
        "closedTime": "2024-07-09T15:37:52+08:00"
    }
}

响应码集合

失败返回示例

{
    "code": 21010,
    "message": "transaction not found",
    "data": null
}