POST/afterSales/zfbRefund管理后台

支付宝退款

订单·支付·售后 / 售后· AfterSalesController#zfbRefund

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/afterSales/zfbRefund
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文后端增加退款功能
维护人 / 最后改动liuxu　2024-09-13　最近提交：后端增加退款功能
读写数据表openapi_channel_order、after_sales、order_payment　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.after.AfterSalesController#zfbRefund
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/after/AfterSalesController.java:320
判定依据1 个调用点：dscp-html-manage/src/api/order/orderAfterSales/index.ts

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

参数名	参数值	是否必填	参数类型	描述说明
无

参数名	参数值	是否必填	参数类型	描述说明
无

Body 类型 AfterSalesAddRequest

参数名	参数值	是否必填	参数类型	描述说明
orderId	…	是	Long	订单ID → order_payment.order_id
refundType	…	是	RefundType	售后类型(after.RefundType),1退款，2退款退货 → after_sales.refund_type 1＝退款 2＝退款退货
applyMoney	…	是	Integer	申请退款金额 → after_sales.apply_money
num	…	是	Integer	退货数量 → after_sales.num
logistics	…	是	LogisticsStatus	物流状态(after.LogisticsStatus)，1未发货,2已发货 → after_sales.logistics 1＝未发货 2＝已发货
refundDesc	…	否	String	退款说明 → after_sales.refund_desc
refundPic	…	否	String	退款上传凭证图片 → after_sales.refund_pic

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

data 类型 AlipayTradeRefundResponse

参数名	参数值	是否必填	参数类型	描述说明
未解析到返回结构

{
  "data": null,
  "可能返回": [
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    }
  ]
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：openapi_channel_order、after_sales、order_payment　反查全部引用接口 →

其它依赖：ZfbCardService.manageRefund、SessionMemberService.getSessionId、SessionUserService.getSessionId

逻辑摘要：查询详情（orderService.get）；调用 manageRefund（zfbCardService.manageRefund）；查询详情（afterSalesService.get）；入参与返回值经 BeanUtils 做对象/分页映射

操作日志：after / 支付宝退款

源码内联注释（旧站解析结果）

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

可能抛出的业务码：99999 服务内部错误　错误码字典 →