調(diào)用地址
使用HTTP協(xié)議，POST方式提交。
測試環(huán)境：https://test.wsmsd.cn/sit/api/v3/labs/trans/share_code
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/labs/trans/share_code
請求報(bào)文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的業(yè)務(wù)終端號 |
| out_trade_no | 商戶交易流水號 | M | String(32) | 商戶系統(tǒng)唯一 |
| account_type | 錢包類型 | M | String(32) | 支付寶：ALIPAY |
| total_amount | 金額 | M | String(12) | 單位分，整數(shù)型字符 |
| location_info | 地址位置信息 | M | Object | 地址位置信息，風(fēng)控要求必送 |
| code_valid_period | 碼有效期 | C | String(8) | 秒為單位,整型 |
| acc_busi_fields | 賬戶端業(yè)務(wù)信息域 | C | Object | 參見以下acc_busi_fields字段詳細(xì)說明,不同的account_type，需要傳入的參數(shù)不一樣 |
location_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| request_ip | 請求方IP地址 | M | String(64) | 請求方的IP地址，存在必填，格式如36.45.36.95 |
| base_station | 基站信息 | C | String(128) | 客戶端設(shè)備的基站信息（主掃時(shí)基站信息使用該字段） |
| location | 緯度,經(jīng)度 | C | String(32) | 商戶終端的地理位置，存在必填 格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)，精度最長支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789 |
支付寶場景下acc_busi_fields域內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| source | 業(yè)務(wù)來源 | M | String(128) | 業(yè)務(wù)來源，業(yè)務(wù)接入的約定標(biāo)識，代表業(yè)務(wù)的調(diào)用方，內(nèi)容與支付寶約定，若無約定可上送拉卡拉側(cè)約定值。例如：ISV公司名稱縮寫 |
| biz_link | 跳轉(zhuǎn)業(yè)務(wù)鏈接 | M | String(1024) | 支付頁面url |
| seller_id | 賣家支付寶ID | C | String(32) |
|
| ext_info | 擴(kuò)展內(nèi)容 | C | Object | 擴(kuò)展內(nèi)容，主要滿足花唄分期相關(guān)的額鑒權(quán)驗(yàn)等功能 |
支付寶ext_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| fq_number | 花唄分期期數(shù) | C | String(5) | 支付寶花唄分期必送字段: 花唄分期數(shù) 3：3期 6：6期 12：12期 |
| fq_seller_percent | 賣家承擔(dān)手續(xù)費(fèi)比例 | C | String(3) | 支付寶花唄分期必送字段: 賣家承擔(dān)收費(fèi)比例，商家承擔(dān)手續(xù)費(fèi)傳入100，用戶承擔(dān)手續(xù)費(fèi)傳入0，僅支持傳入100、0兩種，其他比例暫不支持 100：代表商家貼息 0：代表用戶承擔(dān)手續(xù)費(fèi) |
響應(yīng)報(bào)文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號（請求接口中商戶號） |
| out_trade_no | 商戶請求流水號 | M | String(32) | 請求報(bào)文中的商戶請求流水號 |
| trade_no | 拉卡拉交易流水號 | M | String(32) | 拉卡拉交易流水號 |
| acc_resp_fields | 賬戶端返回信息域 | C | Object | 賬戶端返回信息域 |
支付寶場景下返回acc_resp_fields域
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| share_token | 吱口令 | M | String | 支付返回的吱口令token |
| expire_date | 吱口令失效時(shí)間 | C | String | 吱口令失效時(shí)間，若為空則表示永久有效 |
示例
請求報(bào)文
{
"out_org_code": "OP00000003",
"req_data": {
"merchant_no": "8222900701105HK",
"term_no": "A1013503",
"out_trade_no": "20230908test000000001",
"total_amount": "1",
"account_type": "ALIPAY",
"code_valid_period": "60",
"acc_busi_fields": {
"biz_link": "https://www.test.com",
"ext_info": {
"fq_number": "3",
"fq_seller_percent": "0"
}
},
"location_info": {
"request_ip": "12.34.56.78",
"base_station": "00 6361 58130",
"location": "+37.123456789,-121.123456789"
}
},
"req_time": "20220225222402",
"version": "3.0"
}復(fù)制
響應(yīng)報(bào)文
{
"msg": "成功",
"resp_time": "20211018165606",
"code": "BBS00000",
"resp_data": {
"acc_resp_fields": {
"expire_date": "20231010162729",
"share_token": "wETN2b480lM $547 E@p.IrGO u:/a"
},
"merchant_no": "8222900701105HK",
"out_trade_no": "20230908test000000001",
"trade_no": "2023101066210310250453"
}
}
}復(fù)制
