通用场景
用于交易创建后，用户在一定时间内未进行支付，可调用该接口直接将未付款的交易进行关闭。
公共请求参数
业务请求参数
以下参数 二选一 传入
trade_nostring(64)
【描述】该交易在支付宝系统中的交易流水号。最短 16 位，最长 64 位。和out_trade_no不能同时为空，如果同时传了 out_trade_no和 trade_no，则以 trade_no为准。
【示例值】2013112611001004680073956707
out_trade_nostring(64)
【描述】订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 trade_no,out_trade_no如果同时存在优先取trade_no
【示例值】hz0120131127001
operator_id可选string(28)
【描述】商家操作员编号 id，由商家自定义。
【示例值】yx01
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.close&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"trade_no":"2013112611001004680073956707",
"out_trade_no":"hz0120131127001",
"operator_id":"yx01"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
trade_no特殊可选string(64)
【描述】支付宝交易号
【示例值】2013112111001004500000675971
out_trade_no特殊可选string(64)
【描述】创建交易传入的商户订单号
【示例值】yx_001
响应示例
正常示例
异常示例
{
"alipay_trade_close_response": {
"code": "10000",
"msg": "success",
"trade_no": "2013112111001004500000675971",
"out_trade_no": "yx_001"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| acq.invalid_parameter | 参数无效 | 检查请求参数，修改后重新发起请求 |
| acq.reason_illegal_status | 交易状态异常 | 确认交易状态，非待支付状态下不支持关单操作 |
| acq.reason_trade_status_invalid | 交易状态异常 | 确认交易状态，非待支付状态下不支持关单操作 |
| acq.system_error | 系统异常 | 重新发起请求 |
| acq.trade_not_exist | 交易不存在 | 检查传入的交易号和外部订单号是否正确，修改后再重新发起 |
| acq.trade_status_error | 交易状态不合法 | 检查当前交易的状态是不是等待买家付款，只有等待买家付款状态下才能发起交易关闭。 |
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| tradestatus.trade_closed | 交易关闭 | 1 |
| tradestatus.trade_success | 交易成功 | 0 |
触发通知示例
https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=rsa2&sign=wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey=&trade_no=null&app_id=null&out_trade_no=null&out_biz_no=null&buyer_logon_id=null&seller_id=null&seller_email=null&trade_status=null&total_amount=null&refund_fee=null&subject=null&body=null&gmt_create=null&gmt_payment=null&gmt_refund=null&gmt_close=null&fund_bill_list=null&receipt_amount=null&invoice_amount=null&buyer_pay_amount=null&point_amount=null&buyer_id=null