订单退款接口

说明:用户有退款请求,可调此接口
如不想调退款接口,请联系富友商务,在指导下在富友平台自行开通【退款】权限
可自行富友平台进行退款(支持微信或支付宝退款,其他支付不支持)
请注意:支付时间与退款时间最少间隔2分钟(原因:银行清结算数据需要同步)
请求方式:HTTP,POST BODY,JSON 形式递交给富友系统

#

流程:退款支持【全额退】或【部分退】

#

且每次产生的退款流水号(refund_order_id)只可退款一次,不能一笔退款流水号重复请求多次,
在富友系统退款流水号(refund_order_id)是唯一索引有防并发操作,如一笔退款流水号(refund_order_id)重复请求多次会激活防并发操作,交易会被拦截.
如商户出现部分退款,比如支付10元,按部分退款分2笔退款。每笔5元退款,退款产生的手续费富友会按照【比例】计算手续费

#

以下列表是部分退款的说明:
退款流水号 退款金额(分) 支付流水号 手续费
123456 500 111F1111 5
123457 500 111F1111 5

请求地址

生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]

接口输入

变量名称 字段 长度 说明 是否可必填 样例
商户代码 mchnt_cd MAX(15) 商户在富友入网时生成的商户号 必填 0001000F0040992
报文体 message MAX 报文体(密文) 必填 ADp7YzySKDrGI4UG6JcPwMVW3.....

请求message报文体

变量名称 字段 长度 说明 是否可必填 样例
商户代码 mchnt_cd MAX(15) 商户在富友入网时生成的商户号 必填 0001000F0040992
退款日期 refund_order_date MAX(8) 退款日期是指当前交易发起的日期 必填 格式:20200601
退款订单号 refund_order_id MAX(30) 数字和英文组合,确保唯一性 必填 111111
支付订单日期 pay_order_date MAX(8) 对应客户端支付参数(orderDate) 必填 20200508
支付订单号 pay_order_id MAX(30) 对应客户端支付参数(orderId) 必填 16110211240374534607
后台接受地址 back_notify_url MAX(200) 异步接受通知地址 必填 www.1111111.com
退款金额 refund_amt MAX(30) 退款金额,单位:分 必填 1
版本号 ver MAX(5) 版本控制,目前是1.0.0版本 必填 1.0.0

接口输出

变量名称 字段 长度 说明 是否可必填 说明
商户代码 mchnt_cd MAX(15) 商户在富友入网时生成的商户号 必填 0001000F0040992
应答码 resp_code MAX(4) 接口通讯应答码 必填 应答码不能当成订单状态码
应答描述 resp_desc MAX(200) 应答描述 必填
报文体 message MAX 报文体 必填 ADp7YzySKDrGI4UG6JcPwMVW3.....

响应message报文体

变量名称 字段 长度 说明 是否可必填 样例
商户号码 mchnt_cd MAX(15) 商户在富友入网时生成的商户号 必填 0001000F0040992
退款日期 refund_order_date MAX(8) 退款日期 必填 20200601
退款流水号 refund_order_id MAX(30) 数字和英文组合,确保唯一性 必填
支付订单日期 pay_order_date MAX(8) 对应客户端支付参数(orderDate) 必填 20200509
支付订单号 pay_order_id MAX(30) 对应客户端支付参数(orderId) 必填 16110211240374534607
退款金额 refund_amt MAX(12) 退款金额,单位:分 必填 1200分
退款状态 refund_st MAX(4) 退款交易状态 必填 详情请看(应答描述/订单状态列表)

results matching ""

    No results matching ""