# 交易退款(/trade/refund)
对于微信和支付宝支付方式,可以调用此接口进行退款,可以分多次退款,但总金额不可超过交易总金额,发起退款返回结果不代表成功,最终是否成功会以异步通知形式告知,参考交易通知参数
参数名 | 字段名 | 格式 | 必填 | 说明 |
---|---|---|---|---|
mid | 商户id | Long(20) | 是 | 商户进件成功后由蝉鸣分配的商户唯一ID |
outRefundNo | 退款编号 | String(64) | 是 | 退款唯一标识 |
outTradeNo | 原始外部交易编号 | String(64) | 是 | 交易创建时传入的外部交易号 |
refundAmount | 退款金额 | Money | 是 | 不可超过交易总金额 |
refundReason | 退款原因 | String(100) | 是 | 退款原因 |
deviceIp | 设备ip | String(20) | 是 | 退款设备ip |
民生中投通道
参数名 | 字段名 | 格式 | 必填 | 说明 |
---|---|---|---|---|
splitBunch | 手续费对象 | Object数组 | 特殊 | 手续费数组 |
splitBunch对象
参数名 | 字段名 | 格式 | 必填 | 说明 |
---|---|---|---|---|
amount | 到账金额 | String(30) | 特殊 | 民生中投通道必填 计算公式 退费金额/交易金额*手续费 BigDecimal cusRateCost = refundAmount.divide(transAmount, 8, RoundingMode.HALF_UP).multiply(schoolFee).setScale(2, RoundingMode.HALF_UP); |
hmMerchantId | mid | String(64) | 特殊 | 商户mid |
返回结果
参数名 | 字段名 | 格式 | 必填 | 说明 |
---|---|---|---|---|
tradeNo | 校益宝原始交易单号 | String(64) | 是 | 校益宝原始交易单号 |
outTradeNo | 外部交易单号 | String(64) | 是 | 第三方平台交易单号 |
outRefundNo | 外部退款交易号 | String(64) | 是 | 第三方退款交易号 |
refundStatus | 退款状态 | String(10) | 是 | refunding:退款处理中;succ:退款成功;fail 退款失败 |