订单退款接口

说明:如用户有退款请求,可以通过此接口发送请求
退款接口支持部分退款和全额退款
支付交易和退款交易间隔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
分账退款参数 refund_bill_params MAX(512) 传分账退款信息 非必填 注意是JSON字符串,不是JSON对象。
分账退款参数格式说明如下 如果不传参数,则按退款金额比例回退分账金额。 如果传参数。则按传的参数回退分账金额 refund_bill_params="[{"trans_in": "分账入账方编号", "amount": 分账金额,单位是分, "desc": "分账描述必填最多64位"}]"

接口输出

变量名称 字段 长度 说明 是否可必填 说明
商户代码 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) 退款富友流水号(订单分账退款用) 必填
分账退款参数 refund_bill_params MAX(512) 传分账退款信息 非必填 注意是JSON字符串,不是JSON对象。
分账退款参数格式说明如下 refund_bill_params="[{"trans_in": "分账入账方编号", "amount": 分账金额,单位是分, "state": "INIT"}]"
state是分账回退状态。SUCCESS=成功 FAIL=处理失败 PROCESSING=处理中 INIT=初始状态

results matching ""

    No results matching ""