统一收单交易关闭接口

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/trade/close

用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/close' \
--header 'Content-Type: application/json' \
--data-raw '{
    "notify_url": "string",
    "operator_id": "YX01",
    "out_trade_no": "HZ0120131127001",
    "trade_no": "2013112611001004680073956707"
}'

响应示例

200 - 示例 1

{
    "out_trade_no": "YX_001",
    "trade_no": "2013112111001004500000675971"
}

请求参数

Body 参数application/json

notify_url

string

通知地址

可选

operator_id

string

可选

商家操作员编号 id，由商家自定义。

示例值:

YX01

out_trade_no

string

可选

订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 trade_no,out_trade_no如果同时存在优先取trade_no

示例值:

HZ0120131127001

trade_no

string

可选

该交易在支付宝系统中的交易流水号。最短 16 位，最长 64 位。和out_trade_no不能同时为空，如果同时传了 out_trade_no和 trade_no，则以 trade_no为准。

示例值:

2013112611001004680073956707

示例

返回响应

🟢200common response

application/json

Body

out_trade_no

string

可选

创建交易传入的商户订单号

示例值:

YX_001

trade_no

string

支付宝交易号

可选

示例值:

2013112111001004500000675971

🔴500请求失败

修改于 2023-11-20 03:25:32

统一收单交易撤销接口

查询对账单下载地址