订单退款接口
接口输入
说明:支付成功后,如用户有退款请求,通过JSON形式递交给富友系统,递交的方式必须为post,生产环境为https协议,测试环境为http协议。
生产地址:https://aggpay.fuioupay.com/refund.do
商户测试地址:http://aggpay-test.fuioupay.com/refund.do
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 | 
|---|---|---|---|---|---|
| 商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | |
| 报文体 | message | MAX | 报文体(密文) | 必填 | 2 | 
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 | 
| 后台接受地址 | back_notify_url | MAX(200) | 异步接受通知地址 | 必填 | www.1111111.com | 
| 退款金额 | refund_amt | MAX(30) | 退款金额 | 必填 | 支持部分退款比如:原交易10分退款可以退1分,或者10分 | 
| 版本号 | ver | MAX(5) | 版本控制,目前是1.0.0版本 | 必填 | 1.0.0 | 
接口输出
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 说明 | 
|---|---|---|---|---|---|
| 商户代码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | |
| 应答码 | resp_code | MAX(4) | 接口通讯应答码 | 必填 | 应答码不能当成订单状态码 | 
| 应答描述 | resp_desc | MAX(200) | 应答描述 | 必填 | |
| 报文体 | message | MAX | 报文体 | 必填 | 2 | 
message报文体
| 变量名称 | 字段 | 长度 | 说明 | 是否可必填 | 样例 | 
|---|---|---|---|---|---|
| 商户号码 | mchnt_cd | MAX(15) | 商户在富友入网时生成的商户号 | 必填 | 0001000F0040992 | 
| 退款日期 | refund_order_date | MAX(8) | 退款日期 | 必填 | 20200601 | 
| 退款流水号 | 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(4) | 退款交易状态 | 必填 | 0未支付,1支付成功,2支付失败,3支付超时,4订单关闭 5全额退款 6部分退款 7退款失败 8退款申请成功待处理(线上,对账处理)9退款申请成功(线下,人工处理) |