- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
统一收单交易关闭接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/close
错误码#
公共错误码#
业务错误码#
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ACQ.INVALID_PARAMETER | 参数无效 | 检查请求参数，修改后重新发起请求 |
| 400 | ACQ.REASON_ILLEGAL_STATUS | 交易状态异常 | 确认交易状态，非待支付状态下不支持关单操作 |
| 400 | ACQ.REASON_TRADE_STATUS_INVALID | 交易状态异常 | 确认交易状态，非待支付状态下不支持关单操作 |
| 400 | ACQ.SYSTEM_ERROR | 系统异常 | 重新发起请求 |
| 400 | ACQ.TRADE_NOT_EXIST | 交易不存在 | 检查传入的交易号和外部订单号是否正确，修改后再重新发起 |
| 400 | ACQ.TRADE_STATUS_ERROR | 交易状态不合法 | 检查当前交易的状态是不是等待买家付款，只有等待买家付款状态下才能发起交易关闭。 |
关联异步通知#
触发通知类型#
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| tradeStatus.TRADE_CLOSED | 交易关闭 | 1 |
| tradeStatus.TRADE_SUCCESS | 交易成功 | 0 |
触发通知示例#
请求示例请求示例
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-20 07:37:38