资金退回接口

当资金支付一段时间后，由于收款方一直没有收钱（比如抢红包），可以通过退款接口将资金退换给付款方。支付宝将会按照退款规则将支付款按原路退到付款方帐号上。
交易超过约定时间（签约时设置的可退款时间）的订单无法进行退款。支付宝退款支持单笔交易分多次退回，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交，要采用原来的退款单号。总退款金额不能超过（用户实际支付金额-已领红包）的金额。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/fund/trans/refund' \ --header 'Content-Type: application/json' \ --data-raw '{ "business_params": "{\"MERCHANT_PAYER_ID\":\"1234567890\",\"MERCHANT_PAYER_PHONE:\"15012341234\"}", "order_id": "20190703110075000006530004756875", "out_request_no": "2018999960760005838333", "passback_params": "{\"merchantBizType\":\"peerPay\"}", "refund_amount": "8.88", "remark": "红包超时退回" }'

{ "order_id": "20881030507841230156", "out_request_no": "2019063050784123", "refund_amount": "8.88", "refund_order_id": "2088000000300210312", "status": "SUCCESS", "refund_date": {} }

请求参数

Body 参数application/json

business_params

string

可选

JSON格式，传递业务扩展参数，使用前请与支付宝工程师联系！

示例值:

{"MERCHANT_PAYER_ID":"1234567890","MERCHANT_PAYER_PHONE:"15012341234"}

order_id

string

可选

发红包时支付宝返回的支付宝订单号order_id。

示例值:

20190703110075000006530004756875

out_request_no

string

可选

标识一次资金退回请求，一笔资金退回失败后重新提交，要采用原来的资金退回单号。总退款金额不能超过用户实际支付金额。

示例值:

2018999960760005838333

passback_params

string

可选

公用回传参数，如果请求时传递了该参数，则异步通知商户时会回传该参数。

示例值:

{"merchantBizType":"peerPay"}

refund_amount

string

可选

需要退款的金额，该金额不能大于订单金额,单位为元，支持两位小数

示例值:

8.88

remark

string

资金退回备注

可选

示例值:

红包超时退回

示例

返回响应

🟢200common response

application/json

Body

order_id

string

可选

发红包时支付宝返回的支付宝订单号order_id。

示例值:

20881030507841230156

out_request_no

string

可选

标识一次资金退回请求，一笔资金退回失败后重新提交，要采用原来的资金退回单号。总退款金额不能超过用户实际支付金额。

示例值:

2019063050784123

refund_amount

string

可选

本次退款的金额，单位为元，支持两位小数

示例值:

8.88

refund_order_id

string

可选

退款的支付宝系统内部单据id

示例值:

2088000000300210312

status

string

可选

SUCCESS：退款成功

示例值:

SUCCESS

refund_date

string

退款资金退回

可选

示例值:

{}

🔴500请求失败