订单退款接口
说明:如用户有退款请求,可以通过此接口发送请求
退款接口支持部分退款和全额退款
支付交易和退款交易间隔5分钟以上
(比如:张三,15.54分微信付款了1000元,然后发现多买了商品,申请部分退款,请过五分钟之后发起退款)银行与通道及富友清结算需要时间
商户端系统通过JSON形式递交给富友系统,递交的方式必须为post,
生产环境为https协议,测试环境为https协议。
生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]
接口输入
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 比如:0001000F0040992 |
报文体 | message | MAX | 报文体(密文) | 必填 | OsxV9TKk5NzbD................ |
请求message报文体
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
退款日期 | refund_order_date | MAX(8) | 退款交易发起的日期 | 必填 | 格式:20200601 |
退款流水号 | refund_order_id | MAX(30) | 退款交易流水号,商户生成。唯一。 | 必填 | 111111 |
支付订单日期 | pay_order_date | MAX(8) | 同订单支付接口的订单日期 | 必填 | 20200508 |
支付订单号 | pay_order_id | MAX(30) | 同订单支付接口的订单号 | 必填 | 16110211240374534607 |
退款金额 | refund_amt | MAX(12) | 退款金额:整数,单位:分 | 必填 | 支持部分退款,比如:原交易10分退款可以退1分,或者10分 |
版本号 | ver | MAX(5) | 版本控制,目前是1.0.0版本 | 必填 | 1.0.0 |
接口输出
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 说明 |
---|---|---|---|---|---|
商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
应答码 | resp_code | MAX(4) | 接口通讯应答码 | 必填 | 应答码不能当成订单状态码 |
应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | |
报文体 | message | MAX | 报文密文体 | 必填 |
响应message报文体
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
退款日期 | refund_order_date | MAX(8) | 同上 | 必填 | 20200601 |
退款流水号 | refund_order_id | MAX(30) | 同上 | 必填 | |
支付订单日期 | pay_order_date | MAX(8) | 同上 | 必填 | 20200509 |
支付订单号 | pay_order_id | MAX(30) | 同上 | 必填 | 16110211240374534607 |
退款金额 | refund_amt | MAX(12) | 同上 | 必填 | 1200分,单位:分 |
退款状态 | refund_st | MAX(4) | 退款交易状态 | 必填 | 详情看订单状态列表 |
退款富友日期 | refund_fas_date | MAX(8) | 退款富友日期(订单分账退款用) | 必填 | 20200601 |
退款富友流水号 | refund_fas_ssn | MAX(12) | 退款富友流水号(订单分账退款用) | 必填 |