代收退款
調用地址
使用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