10. 订单、支付与回调 API 10.8 支付宝支付回调【未执行，需三方/真实联调】

Table of Contents

10.8 支付宝支付回调【未执行，需三方/真实联调】

POST /tieup/api/v1/webhooks/payments/alipay
Content-Type: application/x-www-form-urlencoded

请求参数：

参数 类型 必填 说明
trade_no string 否 支付宝交易号
out_trade_no string 否 本地订单号或商户订单号
trade_status string 否 支付宝交易状态，如 TRADE_SUCCESS
sign string 是 支付宝回调签名
sign_type string 否 签名类型

查询参数：

参数 类型 必填 说明
account_code string 否 支付账号代码；多支付宝账号时建议携带，便于验签前定位账号
payment_account_id integer 否 支付账号 ID；多支付宝账号时可替代 account_code

请求体示例：

trade_no=2026061722000000001&out_trade_no=TO202606170001&trade_status=TRADE_SUCCESS&sign=alipay_sign

响应字段：

字段 类型 说明
success text 支付宝要求的成功确认文本；成功只返回纯文本 success

响应示例：

success

说明：

  • 由支付宝支付平台调用，不面向 APP。
  • 写入 tieup_payment_notify_log.notify_type = payment。
  • 支付宝支付回调成功响应不是通用 JSON，而是纯文本 success；处理失败返回纯文本 fail 且 HTTP 状态码为 500。
  • 必须校验签名、金额、订单状态和第三方流水号；重复回调按幂等直接返回成功。