# 交易退款(/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) | 必填 | 单位元 示例:1000.85 |
| hmMerchantId | 商户mid | String(64) | 必填 | 商户mid |
返回结果
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| tradeNo | 校益宝原始交易单号 | String(64) | 是 | 校益宝原始交易单号 |
| outTradeNo | 外部交易单号 | String(64) | 是 | 第三方平台交易单号 |
| outRefundNo | 外部退款交易号 | String(64) | 是 | 第三方退款交易号 |
| refundStatus | 退款状态 | String(10) | 是 | refunding:退款处理中;succ:退款成功;fail 退款失败 |