拉卡拉聚合掃碼-退款交易
說明：正在使用本接口的商戶，可繼續(xù)正常使用；因當(dāng)前接口不再做功能迭代，建議商戶對接新退貨接口：統(tǒng)一退貨
調(diào)用地址
使用HTTP協(xié)議，POST方式提交
URL(測試環(huán)境)： https://test.wsmsd.cn/sit/api/v3/labs/relation/refund
URL(生產(chǎn)環(huán)境)：https://s2.lakala.com/api/v3/labs/relation/refund
退款交易
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的商戶號 |
| out_trade_no | 商戶交易流水號 | M | String(32) | 商戶系統(tǒng)唯一 |
| refund_amount | 退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符 |
| refund_reason | 退款原因 | M | String(32) | 退款原因描述 |
| origin_out_trade_no | 原商戶交易流水號 | C | String(32) | 下單時的商戶請求流水號（退款時origin_out_trade_no，origin_trade_no，origin_log_no必送其一） |
| origin_trade_no | 原拉卡拉交易流水號 | C | String(32) | 下單成功時，返回的拉卡拉交易流水。 origin_out_trade_no、origin_log_no、origin_trade_no至少一個必填（調(diào)用收銀臺下單接口拉起交易后發(fā)起退款時至少要傳兩個），同時存在時優(yōu)先級順序如下： origin_trade_no、origin_log_no、origin_out_trade_no。 |
| origin_log_no | 原對賬單流水號 | C | String(14) | 對賬單中的交易流水。 origin_out_trade_no、origin_log_no、origin_trade_no至少一個必填（調(diào)用收銀臺下單接口拉起交易后發(fā)起退款時至少要傳兩個，同時存在時優(yōu)先級順序如下： origin_trade_no、origin_log_no、origin_out_trade_no。 |
| trade_req_date（待上線） | 交易請求日期 | O | String(8) | 送原商戶交易流水號退款時必填 |
| location_info | 地址位置信息 | M | Object | 地址位置信息，風(fēng)控要求必送 |
location_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| request_ip | 請求方IP地址 | M | String(64) | 請求方的IP地址，存在必填，格式如36.45.36.95 |
| base_station | 基站信息 | C | String(128) | 客戶端設(shè)備的基站信息（主掃時基站信息使用該字段） |
| location | 維度,經(jīng)度 | C | String(32) | 商戶終端的地理位置，存在必填 格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)，精度最長支持小數(shù)點后9位。舉例:+37.123456789,-121.123456789 |
響應(yīng)參數(shù)
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號（請求接口中商戶號） |
| out_trade_no | 商戶請求流水號 | M | String(32) | 請求中的商戶請求流水號 |
| trade_no | 拉卡拉退款單號 | M | String(32) | 拉卡拉交易流水號 |
| log_no | 拉卡拉對賬單流水號 | M | String(14) | 拉卡拉對賬單流水號 |
| acc_trade_no | 賬戶端交易訂單號 | C | String(48) | 賬戶端交易流水號 |
| account_type | 錢包類型 | C | String(32) | 微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING |
| total_amount | 交易金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| refund_amount | 申請退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| payer_amount | 實際退款金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符串 |
| trade_time | 退款時間 | C | String(14) | 實際退款時間。yyyyMMddHHmmss |
| origin_trade_no | 原拉卡拉訂單號 | C | String(32) | 如果請求中攜帶，則返回 |
| origin_out_trade_no | 原商戶請求流水號 | C | String(64) | 如果請求中攜帶，則返回 |
| up_iss_addn_data | 單品營銷 附加數(shù)據(jù) | C | String(8000) | 參與單品營銷優(yōu)惠時返回 |
| up_coupon_info | 銀聯(lián)優(yōu)惠信息、出資方信息 | C | String(500) | 參與單品營銷優(yōu)惠時返回 |
| trade_info | 出資方信息 | C | String(512) | 數(shù)字貨幣中行返回示例說明：[{“fundchannel”:”BOC”,”amount”:”18”}] |
| fund_bill_list | 交易支付使用的資金渠道 | C | String(512) |
示例
請求報文
{
"req_time": "20210907173330",
"version": "3.0",
"out_org_code": "OP00000003",
"req_data": {
"merchant_no": "822290070111135",
"term_no": "29034705",
"out_trade_no": "wxy2021090700003",
"refund_amount": "1",
"refund_reason": "test測試退款",
"origin_out_trade_no": "wxy2021090700001",
"location_info": {
"request_ip": "10.176.1.192",
"location": "+37.123456789,-121.123456789"
}
}
}復(fù)制響應(yīng)報文
{
"msg": "成功",
"resp_time": "20210907173417",
"code": "BBS00000",
"resp_data": {
"out_trade_no": "wxy2021090700003",
"trade_no": "2021090766160003670036",
"log_no": "66160003670036",
"acc_trade_no": "2021090722001449261431458662",
"account_type": "ALIPAY",
"total_amount": "1",
"refund_amount": "1",
"payer_amount": "1",
"trade_time": "20210907173417",
"origin_trade_no": "2021090766210003670031",
"origin_out_trade_no": "wxy2021090700001",
"up_iss_addn_data": "",
"up_coupon_info": "",
"trade_info": ""
}
}復(fù)制The End