支付宝

统一收单交易关闭接口

开发环境

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 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"notify_url":"http://api.test.alipay.net/atinterface/receive_notify.htm",
	"trade_no":"2013112611001004680073956707",
	"out_trade_no":"HZ0120131127001",
	"operator_id":"YX01"
}'

响应示例

200 - 成功示例

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

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

notify_url

string

必需

支付宝服务器主动通知商户服务器里指定的页面http/https路径。在body参数中传递

trade_no

string

必需

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

out_trade_no

string

必需

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

operator_id

string

可选

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

示例

返回响应

🟢200成功

application/json

Body

trade_no

string

支付宝交易号

必需

out_trade_no

string

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

必需

🟠400请求有误

修改于 2023-11-23 02:59:27

统一收单交易退款查询

支付宝订单信息同步接口