订单退款

描述

对订单发起退款。

路径

/optimus/core/aftersale/applyRefund

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
seller 卖家信息 Object Y 固定值 见测试参数
orderID 订单信息 Object Y 前置操作后拿到
refundInfo 申请退款信息 Object Y
requestId 退款请求id String Y ${AppCode}+id 最大 40
requestSource 退款来源 String Y 自定义 EXTERN

seller 字段明细

参数 参数名称 类型 是否必传 描述 示例
merchantId 商户Id String Y 固定值 见测试参数
merchantUserId 商户userId String Y 固定值 见测试参数
role 角色 String Y 固定值 见测试参数

orderID 字段明细

参数 参数名称 类型 是否必传 描述
sn 订单编号 String Y 前置操作后拿到
signature 订单密码 String Y 前置操作后拿到

refundInfo 字段明细

参数 参数名称 类型 是否必传 描述 示例
applyAmount 金额 Long Y
type 退款类型 Byte Y 1 商品 2 金额
items 退款明细 List\ N 商品必填 商品退款自动计算应退金额
refundReason 退款原因 String Y
externExtend 外部拓展参数 Map\ N 自定义 回调会推送

refundInfo.items 字段明细

参数 参数名称 类型 是否必传
spuId spu String Y
skuId sku String Y
title 标题 String Y
curPrice 现价 Long Y
quantity 数量 String Y

出参说明（JSON 格式）

出参整体结构

参数 参数名称 类型 描述 示例
success 请求状态 Boolean true：成功；false：失败 TRUE
code 状态码 String 0000：成功；其他为异常码 "0000"
msg 状态描述 String 请求结果的描述信息 "处理成功"
data 订单数据 Object 结果数据

出参字段结构

data 字段明细

参数 参数名称 类型
ticketSn 退款单号 String
ticketSignature 退款单号签名 String

示例

{
    "appid": "2025082700005615",
    "seller": {
        "merchantId": "1c904b2d-f056-4afa-a819-0328a4774320",
        "merchantUserId": "6ce169d1-1289-4e98-b4a3-ea8b6145046f",
        "role": "super_admin"
    },
    "orderID": {
        "sn": "7274425403705112",
        "signature": "c-T5kPjLxxdmYicfNXKj"
    },
    "refundInfo": {
        "applyAmount": 1,
        "type": 2,
        "refundReason": "备注"
    },
    "requestId": "DWTY26032500552686210496",
    "requestSource": "EXTERN"
}

results matching ""

    No results matching ""