交易撤销接口
通过此接口发起交易撤销,注意:终态的交易不支持发起撤销请求。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值:order.cancel |
| 版本号 | version | M | String(1,8) | 固定值:1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 原商户订单号 | orderId | M | String(1,40) | 原正向交易订单号 |
| 撤销订单号 | cancelId | M | String(1,40) | 全局保持唯一 |
| 原平台订单号 | transId | C | String(1,40) | |
| 撤销原因 | reason | C | String(1,256) |
请求示例报文
json
{
"appId": "000110011816681",
"funcode": "order.cancel",
"version": "1.0.0",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
"cancelId": "e07DF6CD-3EDa-78Dc-1e2B-aB45EfEA5cFF",
"reason": "test cancel"
}接口同步返回
| 字段名称 | 字段key | 必填 | 类型 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值:order.cancel |
| 版本号 | version | M | String(1,8) | 固定值:1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 原商户订单号 | orderId | M | String(1,40) | |
| 商户撤销订单号 | cancelId | M | String(1,40) | |
| 撤销订单金额 | cancelAmount | M | Number(22) | |
| 撤销状态 | cancelStatus | M | String(4) | 参见 交易状态 |
| 平台撤销订单号 | cancelTransId | M | String(0,64) | |
| 响应时间 | responseTime | M | String(14) | |
| 响应码 | responseCode | M | String(1,16) | 参见 交易响应码 |
| 响应信息 | responseMsg | N | String(1,200) | 参见 交易响应码 |
| 错误码 | errorCode | O | String(1,16) | 请求失败时返回 参见 交易错误码 |
| 错误信息 | errorMsg | O | String(200) | 请求失败时返回 参见 交易错误码 |
返回示例报文
json
{
"appId": "000110011816681",
"cancelId": "e07DF6CD-3EDa-78Dc-1e2B-aB45EfEA5cFF",
"cancelStatus": "success",
"funcode": "order.cancel",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
"responseCode": "success",
"responseMsg": "请求成功",
"responseTime": "20240108100519",
"version": "1.0.0"
}