统一收单交易退款接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/refund
alipay.trade
交易超过约定时间（签约时设置的可退款时间）的订单无法进行退款。
支付宝退款支持单笔交易分多次退款，多次退款需要提交原支付订单的订单号和设置不同的退款请求号。一笔退款失败后重新提交，要保证重试时退款请求号不能变更，防止该笔交易重复退款。
同一笔交易累计提交的退款金额不能超过原始交易总金额。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/refund' \
--header 'Content-Type: application/json' \
--data-raw '{
"goods_detail": [
{
"alipay_goods_id": "string",
"body": "string",
"categories_tree": "string",
"goods_category": "string",
"goods_id": "string",
"goods_name": "string",
"out_item_id": "string",
"out_sku_id": "string",
"price": "string",
"quantity": 0,
"show_url": "string"
}
],
"operator_id": "OP001",
"org_pid": "2088101117952222",
"out_request_no": "HZ01RF001",
"out_trade_no": "20150320010101001",
"refund_advance_account": "loginname@alitest.com",
"refund_advance_account_type": "loginName",
"refund_amount": "200.12",
"refund_currency": "USD",
"refund_goods_detail": [
{
"goods_id": "apple-01",
"out_item_id": "outItem_01",
"out_sku_id": "outSku_01",
"refund_amount": "19.50"
}
],
"refund_reason": "正常退款",
"refund_royalty_parameters": [
{
"amount": "string",
"amount_percentage": 0,
"desc": "string",
"royalty_scene": "string",
"royalty_type": "string",
"trans_in": "string",
"trans_in_name": "string",
"trans_in_type": "string",
"trans_out": "string",
"trans_out_type": "string"
}
],
"store_id": "NJ_S_001",
"terminal_id": "NJ_T_001",
"trade_no": "2014112611001004680073956707",
"query_options": "refund_detail_item_list"
}'响应示例响应示例
200 - 示例 1
{
"refund_preset_paytool_list": {
"assert_type_code": "HEMA",
"amount": "12.21"
},
"buyer_logon_id": "159****5620",
"buyer_open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5",
"buyer_user_id": "2088101117955611",
"fund_change": "Y",
"has_deposit_back": "true",
"open_id": "2088102122524333",
"out_trade_no": "6823789339978248",
"present_refund_buyer_amount": "88.88",
"present_refund_discount_amount": "88.88",
"present_refund_mdiscount_amount": "88.88",
"refund_charge_amount": "8.88",
"refund_charge_info_list": [
{
"charge_type": "string",
"refund_charge_fee": "string",
"refund_sub_fee_detail_list": [
{
"refund_charge_fee": "string",
"switch_fee_rate": "string"
}
],
"switch_fee_rate": "string"
}
],
"refund_currency": "USD",
"refund_detail_item_list": [
{
"amount": "string",
"bank_code": "string",
"fund_channel": "string",
"fund_type": "string",
"real_amount": "string"
}
],
"refund_fee": "88.88",
"refund_hyb_amount": "10.24",
"refund_settlement_id": "2018101610032004620239146945",
"send_back_fee": "1.8",
"store_name": "望湘园联洋店",
"trade_no": "2013112011001004330000121536",
"gmt_refund_pay": {}
}请求参数
Body 参数application/json