Table of Contents
10.11 支付宝退款回调【未执行，需三方/真实联调】
POST /tieup/api/v1/webhooks/refunds/alipay
Content-Type: application/x-www-form-urlencoded
请求参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
trade_no |
string | 否 | 支付宝交易号 |
out_trade_no |
string | 否 | 本地订单号或商户订单号 |
out_biz_no |
string | 否 | 商户退款请求号 |
refund_fee |
string | 否 | 退款金额 |
refund_status |
string | 否 | 支付宝退款状态 |
sign |
string | 是 | 支付宝回调签名 |
sign_type |
string | 否 | 签名类型 |
查询参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
account_code |
string | 否 | 支付账号代码；多支付宝账号时建议携带，便于验签前定位账号 |
payment_account_id |
integer | 否 | 支付账号 ID；多支付宝账号时可替代 account_code |
请求体示例：
trade_no=2026061722000000001&out_trade_no=TO202606170001&out_biz_no=RF202606170001&refund_fee=29.90&refund_status=REFUND_SUCCESS&sign=alipay_sign
响应字段：
| 字段 | 类型 | 说明 |
|---|---|---|
success |
text | 支付宝要求的成功确认文本；成功只返回纯文本 success |
响应示例：
success
说明：
- 由支付宝支付平台调用，不面向 APP。
- 写入
tieup_payment_notify_log.notify_type = refund，同步tieup_refund_record.status。 - 支付宝退款回调成功响应不是通用 JSON，而是纯文本
success；处理失败返回纯文本fail且 HTTP 状态码为 500。 - 当前微信、支付宝主动退款请求已在退款补偿入口中封装；本接口负责第三方退款回调闭环，真实退款发起、回调成功/失败和重复回调仍需使用沙盒或正式支付渠道联调。