订单退款请求接口
说明:用户有退款请求,可调此接口
请注意:支付时间与退款时间最少间隔2分钟(原因:银行清结算数据需要同步)
请求方式:HTTP,POST BODY,JSON 形式递交给富友系统
请求地址
生产地址:[详情请咨询富友对接群]
测试地址:[详情请咨询富友对接群]
接口输入
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
退款日期 | refund_order_date | MAX(8) | 退款申请日期 | 必填 | 20200514 |
退款订单号 | refund_order_id | MAX(30) | 退款订单号 | 必填 | 流水号唯一,请求一次退款,产生一笔退款记录,表示退款记录 |
源支付订单日期 | pay_order_date | MAX(8) | 支付请求的日期 | 必填 | 20200513 |
源支付订单号 | pay_order_id | MAX(30) | 支付订单号 | 必填 | 支付交易的请求的流水号 |
异步接受退款通知地址 | back_notify_url | MAX(200) | 异步接受通知地址 | 必填 | |
退款金额 | refund_amt | MAX(12) | 退款金额 单位为分 | 必填 | |
版本 | ver | MAX(5) | 版本控制,目前是1.0.0版本 | 必填 | 1.0.0 |
签名 | sign | MAX | 参数按照ASCII码从小到大排序同上 | 必填 | . |
接口输出
说明:同步返回JSON报文
变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 |
---|---|---|---|---|---|
商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 |
应答码 | resp_code | MAX(4) | 如接口正常,返回0000,如接口参数校验失败,出现其他错误码,详情看错误码列表 | 0000 | |
应答描述 | resp_desc | MAX(1000) | 应答描述 | ||
退款日期 | refund_order_date | MAX(8) | 退款申请流水号 | 必填 | |
退款订单号 | refund_order_id | MAX(30) | 商户的退款号码,需要商户生成,确保唯一性 | 必填 | |
源支付日期 | pay_order_date | MAX(8) | YYYYMMDD | 必填 | 20200509 |
源支付订单号 | pay_order_id | MAX(30) | 商户的订单号码,需要商户生成,确保唯一性 | 必填 | 16110211240374534607 |
退款金额 | refund_amt | MAX(12) | 退款金额 | 必填 | 1200分,单位:分 |
退款状态 | refund_st | MAX(1) | 1退款成功2退款处理中3退款失败 | 必填 | |
退款类型 | refund_type | MAX(1) | 1线上退款2线下退款 | 必填 | 1 |
签名 | sign | 同上 | . |