# 交易退款(/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 退款失败