代收退款
調(diào)用地址
使用HTTP協(xié)議，POST方式提交。
測(cè)試環(huán)境：https://test.wsmsd.cn/sit/api/v3/rfd/refund_front/refund
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/rfd/refund_front/refund
請(qǐng)求報(bào)文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| merchant_no | 商戶號(hào) | M | String(15) | 拉卡拉分配的商戶號(hào) |
| term_no | 終端號(hào) | M | String(8) | 拉卡拉分配的終端號(hào) |
| out_trade_no | 商戶請(qǐng)求流水號(hào) | M | String(32) | 商戶系統(tǒng)唯一 |
| refund_amount | 退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符 |
| refund_reason | 退貨原因 | C | String(32) | |
| origin_log_no | 拉卡拉對(duì)賬單流水號(hào) | C | String(14) | 正交易返回的拉卡拉對(duì)賬單流水號(hào) |
| origin_out_trade_no | 原商戶交易流水號(hào) | C | String(32) | origin_out_trade_no、origin_log_no、origin_trade_no至少一個(gè)必填（調(diào)用收銀臺(tái)下單接口拉起交易后發(fā)起退款時(shí)至少要傳兩個(gè)，同時(shí)存在時(shí)優(yōu)先級(jí)順序如下：origin_trade_no、origin_log_no、origin_out_trade_no |
| origin_trade_no | 原交易拉卡拉交易訂單號(hào) | C | String(32) | origin_out_trade_no、origin_log_no、origin_trade_no至少一個(gè)必填（調(diào)用收銀臺(tái)下單接口拉起交易后發(fā)起退款時(shí)至少要傳兩個(gè)，同時(shí)存在時(shí)優(yōu)先級(jí)順序如下：origin_trade_no、origin_log_no、origin_out_trade_no |
| location_info | 地址位置信息 | M | Object | 地址位置信息 |
| refund_acc_mode | 退貨賬戶模式 | C | String(2) | 00退貨賬戶余額 05商戶余額 06終端余額 30終點(diǎn)賬戶 |
| notify_url | 后臺(tái)通知地址 | C | String(128) | 交易結(jié)果通知地址 |
| refund_amt_sts | 退貨資金狀態(tài) | C | String(2) | 00 分賬前，01 分賬后；分賬交易部分退貨的情況，需要前端上送交易的分賬狀態(tài)。分賬核心，處理部分退貨時(shí)，根據(jù)這個(gè)判斷，按分賬前規(guī)則處理，還是分賬后規(guī)則處理 |
響應(yīng)報(bào)文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| trade_state | 交易狀態(tài) | M | tring(16) | INIT-初始化（查單確認(rèn)最終結(jié)果）；SUCCESS-交易成功；FAIL-交易失敗；DEAL-交易處理中/未知（查單確認(rèn)最終結(jié)果）；PROCESSING-交易已受理（過(guò)段時(shí)間查單確認(rèn)最終結(jié)果）；TIMEOUT-超時(shí)未知（查單確認(rèn)最終結(jié)果）；EXCEPTION-異常（失敗）； |
| refund_type | 退貨模式 | M | String(2) | |
| merchant_no | 商戶號(hào) | M | String(20) | 拉卡拉分配的商戶號(hào) |
| out_trade_no | 商戶請(qǐng)求流水號(hào) | M | String(32) | 請(qǐng)求中的商戶請(qǐng)求流水號(hào) |
| trade_no | 拉卡拉交易流水號(hào) | M | String(32) | 拉卡拉交易流水號(hào) |
| log_no | 拉卡拉對(duì)賬單流水號(hào) | M | String(14) | tradeNo的后14位 |
| acc_trade_no | 賬戶端交易訂單號(hào) | C | String(32) | 賬戶端交易流水號(hào) |
| account_type | 錢包類型 | C | String(32) | 微信：WECHAT支付寶：ALIPAY銀聯(lián)：UQRCODEPAY翼支付:BESTPAY蘇寧易付寶:SUNING |
| total_amount | 交易金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| refund_amount | 申請(qǐng)退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| payer_amount | 實(shí)際退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| trade_time | 退款時(shí)間 | C | String(14) | 實(shí)際退款時(shí)間。yyyyMMddHHmmss |
| origin_log_no | 原拉卡拉對(duì)賬單流水號(hào) | C | String(14) | 如果請(qǐng)求中攜帶，則返回 |
| origin_trade_no | 原拉卡拉交易流水號(hào) | C | String(32) | 如果請(qǐng)求中攜帶，則返回 |
| origin_out_trade_no | 原商戶請(qǐng)求流水號(hào) | C | String(32) | 如果請(qǐng)求中攜帶，則返回 |
| up_iss_add_data | 單品營(yíng)銷附加數(shù)據(jù) | C | String(8000) | 掃碼交易， 參與單品營(yíng)銷優(yōu)惠時(shí)返回 |
| up_coupon_info | 銀聯(lián)優(yōu)惠信息 | String(500) | 掃碼交易， 參與單品營(yíng)銷優(yōu)惠時(shí)返回 出資方例如：[{“fundchannel”:”BOC”,”amount”:”18”}] | |
| trade_info | 出資方信息 | C | String(512) | 掃碼交易， 數(shù)字貨幣中行返回示例說(shuō)明：[{“fundchannel”:”BOC”,”amount”:”18”}] |
| channel_ret_desc | 返回描述信息 | M | String | code#msg：RFD00000#成功、RFD11112#網(wǎng)絡(luò)請(qǐng)求超時(shí) |
請(qǐng)求報(bào)文：
{
"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"
}復(fù)制響應(yīng)報(bào)文：
{
"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#分賬系統(tǒng)處理中"
}
}復(fù)制The End