掃碼預(yù)授權(quán)公共參數(shù)說(shuō)明
公共說(shuō)明
接口文檔中，必選欄目：M 必須，C 可選
| 說(shuō)明 | 描述 |
|---|---|
| 接口版本 | v1.0.0 |
| 功能描述 | 外部機(jī)構(gòu)接入開(kāi)放平臺(tái) |
| 調(diào)用方 | 外部機(jī)構(gòu) |
| 請(qǐng)求方法 | POST |
| 請(qǐng)求簽名 | 是 |
| 響應(yīng)簽名 | 是 |
| 需要BASE64編碼 | 否 |
| 授權(quán)方式 | LKLAPI-SHA256withRSA |
| 測(cè)試環(huán)境URL | https://test.wsmsd.cn/sit/api/v2/labs/txn |
| 生產(chǎn)環(huán)境URL | https://s2.lakala.com/api/v2/labs/txn |
| 測(cè)試環(huán)境商戶終端號(hào) | 商戶號(hào)：822290070111135 終端號(hào)： 29034705 商戶號(hào)：822126090640003 終端號(hào)： 47781282 |
訪問(wèn)URL說(shuō)明
| URL | 描述 |
|---|---|
| https://test.wsmsd.cn/sit/api/v2/labs/txn/preorder | 主掃支付 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/close | 關(guān)單 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/micropay | 被掃支付 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/revoked | 撤銷 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/extOrderQuery | 外部訂單查詢 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/query | 交易訂單查詢 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/refund | 退款接口 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/dycodeCreate | 生成動(dòng)態(tài)碼 |
公共請(qǐng)求參數(shù)
| 字段 | 說(shuō)明 | 是否必填 | 類型 | 備注 |
|---|---|---|---|---|
| timestamp | 時(shí)間戳 | C | Long | Unix時(shí)間戳。13位 |
| rnd | 隨機(jī)數(shù) | C | String(32) | 隨機(jī)數(shù) |
| ver | 版本號(hào) | C | String(6) | 1.0.0 |
| reqId | 請(qǐng)求序列號(hào) | C | String(32) | - |
| reqData | 請(qǐng)求參數(shù) | M | Object | |
| locationInfo | 地址位置信息 | M | Object | |
| termExtInfo | 終端信息 | M | Object | 無(wú)特殊處理需求或無(wú)終端信息，填寫(xiě)”termExtInfo”:{} |
locationInfo字段說(shuō)明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說(shuō)明 |
|---|---|---|---|---|
| requestIp | 請(qǐng)求方IP地址 | M | String(64) | 請(qǐng)求方的IP地址，存在必填，格式如36.45.36.95 |
| baseStation | 基站信息 | C | String(128) | 客戶端設(shè)備的基站信息（主掃時(shí)基站信息使用該字段） |
| location | 緯度,經(jīng)度 | C | String(32) | 商戶終端的地理位置，存在必填 格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)，精度最長(zhǎng)支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789 |
termExtInfo字段說(shuō)明
| 屬性 | 說(shuō)明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| termSN | 終端設(shè)備序列號(hào) | C | String(64) | 商戶終端設(shè)備的SN號(hào)，存在必填，如：QR930000001172 |
| termBaseStation | 終端基站信息 | C | String(128) | 商戶終端設(shè)備的基站信息，存在必填，上送格式為：MNC 移動(dòng)網(wǎng)絡(luò)號(hào)碼(2)＋LAC 位置區(qū)域碼（5）+CID 基站編號(hào)（8）其中LAC不滿五位，或CID不滿足8位的均左補(bǔ)空格．如：00 6361 ·58130 為：00+LAC:6361+CID:58130 |
| termLoc | 終端地理位置 | C | String(100) | 商戶終端的地理位置，存在必填 格式：緯度,經(jīng)度，+表示北緯、東經(jīng)，-表示南緯、 西經(jīng)，精度最長(zhǎng)支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789 |
| termIp | 終端IP地址 | C | String(32) | 商戶終端的IP地址，存在必填，格式如36.45.36.95 |
| termSerialNo | 終端設(shè)備串號(hào) | C | String(64) | 商戶終端硬件的設(shè)備串號(hào)，存在必填，靜態(tài)碼沒(méi)有 |
| termType | 終端設(shè)備類型 | C | String(2) | 商戶終端硬件的設(shè)備類型，必填 01:PC 02:手機(jī) 03:收銀機(jī) 04:移動(dòng)終端 05:靜態(tài)碼 |
| termModel | 終端型號(hào) | C | String(64) | 商戶終端型號(hào) |
| termManu | 終端廠商 | C | String(64) | 商戶終端廠商 |
| appCode | 終端app代碼 | C | String(64) | 商戶終端app代碼 |
| appVer | 終端app版本 | C | String(64) | 商戶終端app版本 |
| termFP | 終端指紋 | C | String(64) | 商戶終端指紋 |
termBaseStation、termLoc、termIp三者必須上送一個(gè)
公共響應(yīng)參數(shù)
| 屬性 | 說(shuō)明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| retCode | 返回業(yè)務(wù)代碼 | M | String(8) | 返回業(yè)務(wù)代碼(按照錯(cuò)誤信息來(lái)定) |
| retMsg | 返回業(yè)務(wù)代碼描述 | M | String(50) | 返回業(yè)務(wù)代碼描述 |
| sign | 簽名 | C | String(32) | 默認(rèn)MD5方式簽名，簽名內(nèi)容為retData+secret_key。 |
| timestamp | 時(shí)間戳 | M | Long | Unix時(shí)間戳，13位 |
| rnd | 隨機(jī)數(shù) | C | String(32) | 隨機(jī)數(shù) |
| reqId | 請(qǐng)求序列號(hào) | C | String(32) | 請(qǐng)求序列號(hào) |
| respId | 響應(yīng)序列號(hào) | C | String(32) | 響應(yīng)序列號(hào) |
| ver | 版本號(hào) | M | String(6) | 版本號(hào) |
| respData | 響應(yīng)參數(shù) | C | Object | 返回?cái)?shù)據(jù).下文定義的響應(yīng)均為該屬性中的內(nèi)容 |
The End