調用地址
使用HTTP協議，POST方式提交。
測試環境：https://test.wsmsd.cn/sit/api/v3/labs/trans/share_code
生產環境：https://s2.lakala.com/api/v3/labs/trans/share_code
請求報文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的業務終端號 |
| out_trade_no | 商戶交易流水號 | M | String(32) | 商戶系統唯一 |
| account_type | 錢包類型 | M | String(32) | 支付寶：ALIPAY |
| total_amount | 金額 | M | String(12) | 單位分，整數型字符 |
| location_info | 地址位置信息 | M | Object | 地址位置信息，風控要求必送 |
| code_valid_period | 碼有效期 | C | String(8) | 秒為單位,整型 |
| acc_busi_fields | 賬戶端業務信息域 | C | Object | 參見以下acc_busi_fields字段詳細說明,不同的account_type，需要傳入的參數不一樣 |
location_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| request_ip | 請求方IP地址 | M | String(64) | 請求方的IP地址，存在必填，格式如36.45.36.95 |
| base_station | 基站信息 | C | String(128) | 客戶端設備的基站信息（主掃時基站信息使用該字段） |
| location | 緯度,經度 | C | String(32) | 商戶終端的地理位置，存在必填 格式：緯度,經度，+表示北緯、東經，-表示南緯、 西經，精度最長支持小數點后9位。舉例:+37.123456789,-121.123456789 |
支付寶場景下acc_busi_fields域內容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| source | 業務來源 | M | String(128) | 業務來源，業務接入的約定標識，代表業務的調用方，內容與支付寶約定，若無約定可上送拉卡拉側約定值。例如：ISV公司名稱縮寫 |
| biz_link | 跳轉業務鏈接 | M | String(1024) | 支付頁面url |
| seller_id | 賣家支付寶ID | C | String(32) |
|
| ext_info | 擴展內容 | C | Object | 擴展內容，主要滿足花唄分期相關的額鑒權驗等功能 |
支付寶ext_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| fq_number | 花唄分期期數 | C | String(5) | 支付寶花唄分期必送字段: 花唄分期數 3：3期 6：6期 12：12期 |
| fq_seller_percent | 賣家承擔手續費比例 | C | String(3) | 支付寶花唄分期必送字段: 賣家承擔收費比例，商家承擔手續費傳入100，用戶承擔手續費傳入0，僅支持傳入100、0兩種，其他比例暫不支持 100：代表商家貼息 0：代表用戶承擔手續費 |
響應報文
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號（請求接口中商戶號） |
| out_trade_no | 商戶請求流水號 | M | String(32) | 請求報文中的商戶請求流水號 |
| trade_no | 拉卡拉交易流水號 | M | String(32) | 拉卡拉交易流水號 |
| acc_resp_fields | 賬戶端返回信息域 | C | Object | 賬戶端返回信息域 |
支付寶場景下返回acc_resp_fields域
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| share_token | 吱口令 | M | String | 支付返回的吱口令token |
| expire_date | 吱口令失效時間 | C | String | 吱口令失效時間，若為空則表示永久有效 |
示例
請求報文
{
"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"
}復制
響應報文
{
"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"
}
}
}復制
