申请退款
curl --location 'https://open-apisix.iwosai.com/optimus/core/aftersale/applyRefund' \
--header 'Authorization: 2025082700005615 9dc8e516b699b9fb2ca84d47fd4a7464' \
--header 'Content-Type: application/json' \
--data '{"appid":"2025082700005615","seller":{"merchantId":"1c904b2d-f056-4afa-a819-0328a4774320","merchantUserId":"6ce169d1-1289-4e98-b4a3-ea8b6145046f","role":"super_admin"},"requestId":"DJK1111111121","requestSource":"EXTERN","orderID":{"sn":"7274029209751766","signature":"o9xRPkAsxuiESPIY6NOk"},"refundInfo":{"applyAmount":1,"type":2,"refundReason":"退回"}}'
入参说明（JSON 格式）
入参整体结构
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| appid |
应用id |
String |
Y |
收钱吧分配的应用id |
202507xxxxxxx |
| seller |
卖家信息 |
Object |
Y |
|
卖家信息 |
| orderID |
订单信息 |
Object |
Y |
|
|
| refundInfo |
申请退款信息不能为空 |
Object |
|
|
|
| requestId |
退款请求id |
String |
|
|
|
| requestSource |
退款来源 |
String |
Y |
EXTERN |
|
| bizExtended |
拓展参数 |
Map |
N |
自定义信息，如示例为指定账单退款 |
{"mallBillIds":["12312"]} |
seller 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| merchantId |
商户Id |
String |
Y |
固定值 |
|
| merchantUserId |
商户userId |
String |
Y |
固定值 |
|
| role |
角色 |
String |
Y |
固定值 |
super_admin |
orderID 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| sn |
单号 |
String |
Y |
固定值 |
前置操作后拿到 |
| signature |
密码 |
String |
Y |
固定值 |
前置操作后拿到 |
refundInfo 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| applyAmount |
金额 |
Long |
Y |
|
|
| type |
退款类型 |
Byte |
Y |
1 商品 2金额 |
|
| items |
退款明细 |
List |
N |
商品必填 |
|
| refundReason |
退款原因 |
String |
Y |
|
refundInfo. items字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
示例 |
| spuId |
spu |
String |
Y |
|
|
| skuId |
sku |
String |
Y |
|
|
| title |
标题 |
String |
Y |
|
|
| img |
商品图片 |
String |
Y |
|
|
| quantity |
数量 |
String |
Y |
|
|
| type |
退款类型 |
Byte |
N |
0 正常商品
1 自定义商品 |
出参说明（JSON 格式）
出参整体结构
| 参数 |
参数名称 |
类型 |
描述 |
示例 |
| success |
请求状态 |
Boolean |
true：成功；false：失败 |
TRUE |
| code |
状态码 |
String |
0000：成功；其他为异常码 |
"0000" |
| msg |
状态描述 |
String |
请求结果的描述信息 |
"处理成功" |
| data |
订单数据 |
Object |
结果数据 |
出参字段结构
data 字段明细
| 参数 |
参数名称 |
类型 |
是否必传 |
描述 |
| ticketSn |
退款单号 |
String |
|
|
| ticketSignature |
单号密码 |
String |
|