申请退款
基本信息
| 接口名称： | 申请退款 | 状 态： | 已完成 | 接口路径： | POST /api/refund | 更新时间： | 2025-03-17 23:56:26 |
| Mock地址： | https://apimock.e-buychina.com/mock/713/api/refund | ||
请求参数
Headers:
| 参数名称 | 参数值 | 是否必填 |
| Content-Type | application/json | 是 |
Body:
| 参数名称 | 类型 | 必填 | 默认值 | 备注 | 其他信息 |
| uuid | string | 是 | 请求序列号 | 最大长度：50 最小长度：1 Mock：@now('yyyyMMdd')-@string('lower',32) | |
| appId | string | 是 | 请求AppId | 最大长度：50 最小长度：1 Mock：@natural | |
| action | string | 是 | 交易类型 | 最大长度：50 最小长度：1 Mock：refund | |
| timestamp | number | 是 | 请求时间戳 | Mock：@timestamp | |
| signType | string | 是 | 签名类型 | 最大长度：20 最小长度：1 Mock：sha256 | |
| sign | string | 是 | 签名值 | 最大长度：500 最小长度：1 Mock：@natural | |
| lang | string | 是 | 语言 | 最大长度：50 最小长度：1 Mock：zh_CN | |
| content | object | 是 | 请求报文 | ||
| outTradeNo | string | 是 | 下单时原外部订单号 | 最大长度：32 最小长度：1 Mock：@string | |
| refundTradeNo | string | 是 | 退款交易编号，格式：YYYYMMDD+随机数 | 最大长度：32 最小长度：1 Mock：@string | |
| tradeTime | string | 否 | 交易时间,格式YYYYMMDD，不填默认当天 | 最大长度：8 Mock：@string | |
| goodsDetail | object | 否 | 退产品信息 | ||
| goodsId | string | 是 | 商品ID，外部编号 | 最大长度：32 最小长度：1 Mock：@string | |
| goodsName | string | 否 | 商品名称 | 最大长度：50 Mock：@string | |
| goodsCode | string | 否 | 商品编码，内部编号 | 最大长度：32 Mock：@string | |
| goodsNum | number | 是 | 数量 | Mock：@integer | |
| refundMethod | array | 否 | 长度只能小于等于1，自定义退款方式和退款金额，此字段存在将不执行refundAmount | ||
| assetType | string | 是 | 资产类型,枚举。cash电子现金支付 | 最大长度：20 最小长度：1 Mock：@string | |
| refundAmount | integer | 否 | 具体资产类型的退款金额 | Mock：@integer |
返回数据
| 参数名称 | 类型 | 必填 | 默认值 | 备注 | 其他信息 |
| uuid | string | 是 | 请求序列号 | 最大长度：50 最小长度：1 Mock：@now('yyyyMMdd')-@string('lower',32) | |
| success | boolean | 是 | 交易成功与否 | Mock：@boolean | |
| action | string | 是 | 交易类型 | 最大长度：50 最小长度：1 Mock：refund | |
| timestamp | number | 是 | 返回时间戳 | Mock：@timestamp | |
| errorCode | string | 是 | 错误码 | 最大长度：50 Mock：@word | |
| errorMessage | string | 是 | 错误描述 | 最大长度：50 Mock：@csentence | |
| signType | string | 否 | 签名类型 | 最大长度：20 Mock：sha256 | |
| sign | string | 否 | 签名值 | 最大长度：500 Mock：@natural | |
| content | object | 是 | 返回报文 | ||
| outTradeNo | string | 是 | 流水号 | 最大长度：64 最小长度：1 Mock：@string | |
| refundTime | string | 是 | 退款时间 | 最大长度：19 最小长度：1 Mock：@date | |
| refundAmount | string | 是 | 退款金额 | 最大长度：11 最小长度：1 Mock：@integer | |
| cardRefund | object | 是 | 卡退款明细 | ||
| refundAmount | string | 是 | 退款金额 | 最大长度：11 最小长度：1 | |
| refundStatus | string | 是 | 退款状态 | 最大长度：32 最小长度：1 | |
| useList | array | 否 | |||
| code | string | 是 | |||
| errorCode | string | 是 | |||
| errorMsg | string | 是 | |||
| paidAmount | string | 是 | |||
| useRule | string | 是 | |||
| fromGoodsIds | string | 是 | |||
| forGoodsIds | string | 是 | |||
| couponRefund | object | 是 | 券退款明细 | ||
| refundAmount | string | 是 | 退款金额 | 最大长度：11 最小长度：1 | |
| refundStatus | string | 是 | 退款状态 | 最大长度：32 最小长度：1 | |
| useList | array | 否 | |||
| code | string | 是 | |||
| errorCode | string | 是 | |||
| errorMsg | string | 是 | |||
| paidAmount | string | 是 | |||
| useRule | string | 是 | |||
| fromGoodsIds | string | 是 | |||
| forGoodsIds | string | 是 | |||
| pointsRefund | object | 是 | 积分退款明细 | ||
| refundAmount | string | 是 | 退款金额 | 最大长度：11 最小长度：1 | |
| refundStatus | string | 是 | 退款状态 | 最大长度：32 最小长度：1 | |
| useList | array | 否 | |||
| code | string | 是 | |||
| errorCode | string | 是 | |||
| errorMsg | string | 是 | |||
| paidAmount | string | 是 | |||
| useRule | string | 是 | |||
| fromGoodsIds | string | 是 | |||
| forGoodsIds | string | 是 | |||
| cashRefund | object | 是 | 电子现金退款明细 | ||
| refundAmount | string | 是 | 退款金额 | 最大长度：11 最小长度：1 | |
| refundStatus | string | 是 | 退款状态 | 最大长度：32 最小长度：1 |
备注
退款请求可以选择整单退或者单资产退款，refundMethod的长度不支持大于1。优惠券不支持部分退款。 |
变更历史
| 变更日期 | 变更内容 |
| 2025-03-17 |
No Comments