主题
关闭订单
接口描述
- 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；
- 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。
请求URL
/trade/close
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 否 | string | 32 | 接入方交易流水号(与tradeNo不可同时为空) | OUT00000001 |
| tradeNo | 否 | string | 32 | 支付系统交易流水号(与outTradeNo不可同时为空) | 1854100814175592449 |
- 注：outTradeNo与tradeNo不能同时为空
请求报文示例
json
{
"appId": "202415629590370906",
"outTradeNo": "18511110003185972",
"signature": "tWvHHs/6VpUssx9xcMtEPZJf1dk547/z3oyoYU8zds5HByBvfyVmeKtUvswMpNduwJn6ucuAUHWYedRnlt29grrUSk+ed1pvIxcmQP7iySJjq8jyvIvnW4WP0e5pjR4uozakN5X3SmCKa4KN7e7tsHVnE3Oeu9Ksr2X6M/dH7wNyFXZ3yWg1K38hor5SSHFpvznMw0R7bz6XvrcmNcYJNMeZqNT2c9oFUdkj2ZPXkixjcyA7BRgLumi2pC2+5V9d0z+1CW0RZhNGSlkBvrpNT0Ps+gV8HwaKMprwt8Mt1WnH3FP0zP/2yMlUU/DRWm0P7+QyLis7f3GvsJp9Aus6dw==",
"tradeNo": "1855933361479729155",
"transDate": "1731469957306",
"transNonce": "737687a8-5000-47d4-9443-ea7ca8f2e1b4"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | OUT00000001 |
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"outTradeNo": "18511110003185972",
"tradeNo": "1855933361479729155",
"transDate": "1731469957306",
"transNonce": "737687a8-5000-47d4-9443-ea7ca8f2e1b4",
"signature": "tWvHHs/6VpUssx9xcMtEPZJf1dk547/z3oyoYU8zds5HByBvfyVmeKtUvswMpNduwJn6ucuAUHWYedRnlt29grrUSk+ed1pvIxcmQP7iySJjq8jyvIvnW4WP0e5pjR4uozakN5X3SmCKa4KN7e7tsHVnE3Oeu9Ksr2X6M/dH7wNyFXZ3yWg1K38hor5SSHFpvznMw0R7bz6XvrcmNcYJNMeZqNT2c9oFUdkj2ZPXkixjcyA7BRgLumi2pC2+5V9d0z+1CW0RZhNGSlkBvrpNT0Ps+gV8HwaKMprwt8Mt1WnH3FP0zP/2yMlUU/DRWm0P7+QyLis7f3GvsJp9Aus6dw=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述