代收退款
调用地址
使用HTTP协议，POST方式提交。
测试环境：https://test.wsmsd.cn/sit/api/v3/rfd/refund_front/refund
生产环境：https://s2.lakala.com/api/v3/rfd/refund_front/refund
请求报文
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| merchant_no | 商户号 | M | String(15) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(8) | 拉卡拉分配的终端号 |
| out_trade_no | 商户请求流水号 | M | String(32) | 商户系统唯一 |
| refund_amount | 退款金额 | M | String(12) | 单位分，整数数字型字符 |
| refund_reason | 退货原因 | C | String(32) | |
| origin_log_no | 拉卡拉对账单流水号 | C | String(14) | 正交易返回的拉卡拉对账单流水号 |
| origin_out_trade_no | 原商户交易流水号 | C | String(32) | origin_out_trade_no、origin_log_no、origin_trade_no至少一个必填（调用收银台下单接口拉起交易后发起退款时至少要传两个，同时存在时优先级顺序如下：origin_trade_no、origin_log_no、origin_out_trade_no |
| origin_trade_no | 原交易拉卡拉交易订单号 | C | String(32) | origin_out_trade_no、origin_log_no、origin_trade_no至少一个必填（调用收银台下单接口拉起交易后发起退款时至少要传两个，同时存在时优先级顺序如下：origin_trade_no、origin_log_no、origin_out_trade_no |
| location_info | 地址位置信息 | M | Object | 地址位置信息 |
| refund_acc_mode | 退货账户模式 | C | String(2) | 00退货账户余额 05商户余额 06终端余额 30终点账户 |
| notify_url | 后台通知地址 | C | String(128) | 交易结果通知地址 |
| refund_amt_sts | 退货资金状态 | C | String(2) | 00 分账前，01 分账后；分账交易部分退货的情况，需要前端上送交易的分账状态。分账核心，处理部分退货时，根据这个判断，按分账前规则处理，还是分账后规则处理 |
响应报文
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| trade_state | 交易状态 | M | tring(16) | INIT-初始化（查单确认最终结果）；SUCCESS-交易成功；FAIL-交易失败；DEAL-交易处理中/未知（查单确认最终结果）；PROCESSING-交易已受理（过段时间查单确认最终结果）；TIMEOUT-超时未知（查单确认最终结果）；EXCEPTION-异常（失败）； |
| refund_type | 退货模式 | M | String(2) | |
| merchant_no | 商户号 | M | String(20) | 拉卡拉分配的商户号 |
| out_trade_no | 商户请求流水号 | M | String(32) | 请求中的商户请求流水号 |
| trade_no | 拉卡拉交易流水号 | M | String(32) | 拉卡拉交易流水号 |
| log_no | 拉卡拉对账单流水号 | M | String(14) | tradeNo的后14位 |
| acc_trade_no | 账户端交易订单号 | C | String(32) | 账户端交易流水号 |
| account_type | 钱包类型 | C | String(32) | 微信：WECHAT支付宝：ALIPAY银联：UQRCODEPAY翼支付:BESTPAY苏宁易付宝:SUNING |
| total_amount | 交易金额 | M | String(12) | 单位分，整数数字型字符串 |
| refund_amount | 申请退款金额 | M | String(12) | 单位分，整数数字型字符串 |
| payer_amount | 实际退款金额 | M | String(12) | 单位分，整数数字型字符串 |
| trade_time | 退款时间 | C | String(14) | 实际退款时间。yyyyMMddHHmmss |
| origin_log_no | 原拉卡拉对账单流水号 | C | String(14) | 如果请求中携带，则返回 |
| origin_trade_no | 原拉卡拉交易流水号 | C | String(32) | 如果请求中携带，则返回 |
| origin_out_trade_no | 原商户请求流水号 | C | String(32) | 如果请求中携带，则返回 |
| up_iss_add_data | 单品营销附加数据 | C | String(8000) | 扫码交易， 参与单品营销优惠时返回 |
| up_coupon_info | 银联优惠信息 | String(500) | 扫码交易， 参与单品营销优惠时返回 出资方例如：[{“fundchannel”:”BOC”,”amount”:”18”}] | |
| trade_info | 出资方信息 | C | String(512) | 扫码交易， 数字货币中行返回示例说明：[{“fundchannel”:”BOC”,”amount”:”18”}] |
| channel_ret_desc | 返回描述信息 | M | String | code#msg：RFD00000#成功、RFD11112#网络请求超时 |
请求报文：
{
"req_data": {
"merchant_no": "822290059430CQR",
"term_no": "A9318757",
"out_trade_no": "TK20250123132019001",
"refund_amount": "1",
"refund_reason": "退款",
"origin_trade_no": "2025012366200XXXXX0035",
"refund_acc_mode": "00",
"notify_url": "http://run.mocky.io/v3/b02c9448-20a2-4ff6-a678-38ecab30161d",
"refund_amt_sts": "00",
"location_info": {
"request_ip": "192.168.23.165",
"location": ""
}
},
"version": "3.0",
"req_time": "20250123132019"
}复制响应报文：
{
"code": "000000",
"msg": "通讯成功",
"resp_time": "20250123132020",
"resp_data": {
"trade_state": "PROCESSING",
"refund_type": "ALL",
"merchant_no": "822290059430CQR",
"out_trade_no": "TK20250123132019001",
"trade_no": "2025012211011000XXXXXXXXXX020001",
"log_no": "311200XXXXX001",
"account_type": "ALIPAY",
"total_amount": "1",
"refund_amount": "1",
"payer_amount": "1",
"trade_time": "20250123132020",
"origin_trade_no": "2025012366200XXXXX0035",
"origin_out_trade_no": "A931875720250123131956698XXXXXXR",
"origin_log_no": "66200XXXXX0035",
"channel_ret_desc": "RFD00000#分账系统处理中"
}
}复制The End