订单交易退款

业务功能

商户针对某一笔已经成功支付的订单发起退款。

交互模式

请求:后台请求交互模式

返回结果:后台请求交互模式

说明: 支持部份退款;只要未成功的情况下,同一个单号可以发起退款。退到银行卡是非实时的,每个银行的处理速度不同,一般发起退款后1-3个工作日内到账。 当调用退款接口返回未知状态,需要调用退款查询接口查询实际退款状态 。 建议 5 秒调一次查询,调用 10 次后状态仍然未知,请在 3 个工作日后重新查询退款状态,或者使用对账单进行确认。

接口名称:/open/order/refund

请求参数:

字段 类型 必填项 描述
sn string 设备号、虚拟设备号
tradeId string 按条件 交易流水号(可空),tradeId,outTradeId,caseierPayNo 三者必传其一,优先tradeId
outTradeId string 按条件 原交易第三方流水号(可空),tradeId,outTradeId,caseierPayNo 三者必传其一,优先tradeId
caseierPayNo string 按条件 第三方收银号(可空),银行卡为6位凭证号,微信、支付宝为账单中的商户单号;tradeId,outTradeId,caseierPayNo 三者必传其一,优先tradeId
outRefundId string 第三方退款、退货流水号,不长于50位,第三方全局唯一
refundAmount int 退款金额(分)
isSharing bool 原交易是否已分账,如已分帐,传true,不传默认false
receivers json对象 isSharing为true时必传,分账信息:[{merchantId:平台接收人商户ID,amount:分给金额,单位分}]
remark string 备注

响应:

sn string 设备号、虚拟设备号
outRefundId string 第三方退款、退货流水号,不长于50位,第三方全局唯一
refundAmount int 撤销金额(分)
tradeId string 交易流水号
refundId string 退款流水号
mrchntCode string 商户编号
terCode string 终端编号
mrchntName string 商户名称
status int 交易状态:0-退款中 1-退款成功 2-退款失败
remark string 退款备注