掃碼預授權公共參數說明
公共說明
接口文檔中,必選欄目:M 必須,C 可選
| 說明 | 描述 |
|---|---|
| 接口版本 | v1.0.0 |
| 功能描述 | 外部機構接入開放平臺 |
| 調用方 | 外部機構 |
| 請求方法 | POST |
| 請求簽名 | 是 |
| 響應簽名 | 是 |
| 需要BASE64編碼 | 否 |
| 授權方式 | LKLAPI-SHA256withRSA |
| 測試環境URL | https://test.wsmsd.cn/sit/api/v2/labs/txn |
| 生產環境URL | https://s2.lakala.com/api/v2/labs/txn |
| 測試環境商戶終端號 | 商戶號:822290070111135 終端號: 29034705 商戶號:822126090640003 終端號: 47781282 |
訪問URL說明
| URL | 描述 |
|---|---|
| https://test.wsmsd.cn/sit/api/v2/labs/txn/preorder | 主掃支付 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/close | 關單 |
| 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 | 生成動態碼 |
公共請求參數
| 字段 | 說明 | 是否必填 | 類型 | 備注 |
|---|---|---|---|---|
| timestamp | 時間戳 | C | Long | Unix時間戳。13位 |
| rnd | 隨機數 | C | String(32) | 隨機數 |
| ver | 版本號 | C | String(6) | 1.0.0 |
| reqId | 請求序列號 | C | String(32) | - |
| reqData | 請求參數 | M | Object | |
| locationInfo | 地址位置信息 | M | Object | |
| termExtInfo | 終端信息 | M | Object | 無特殊處理需求或無終端信息,填寫”termExtInfo”:{} |
locationInfo字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| requestIp | 請求方IP地址 | M | String(64) | 請求方的IP地址,存在必填,格式如36.45.36.95 |
| baseStation | 基站信息 | C | String(128) | 客戶端設備的基站信息(主掃時基站信息使用該字段) |
| location | 緯度,經度 | C | String(32) | 商戶終端的地理位置,存在必填 格式:緯度,經度,+表示北緯、東經,-表示南緯、 西經,精度最長支持小數點后9位。舉例:+37.123456789,-121.123456789 |
termExtInfo字段說明
| 屬性 | 說明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| termSN | 終端設備序列號 | C | String(64) | 商戶終端設備的SN號,存在必填,如:QR930000001172 |
| termBaseStation | 終端基站信息 | C | String(128) | 商戶終端設備的基站信息,存在必填,上送格式為:MNC 移動網絡號碼(2)+LAC 位置區域碼(5)+CID 基站編號(8)其中LAC不滿五位,或CID不滿足8位的均左補空格.如:00 6361 ·58130 為:00+LAC:6361+CID:58130 |
| termLoc | 終端地理位置 | C | String(100) | 商戶終端的地理位置,存在必填 格式:緯度,經度,+表示北緯、東經,-表示南緯、 西經,精度最長支持小數點后9位。舉例:+37.123456789,-121.123456789 |
| termIp | 終端IP地址 | C | String(32) | 商戶終端的IP地址,存在必填,格式如36.45.36.95 |
| termSerialNo | 終端設備串號 | C | String(64) | 商戶終端硬件的設備串號,存在必填,靜態碼沒有 |
| termType | 終端設備類型 | C | String(2) | 商戶終端硬件的設備類型,必填 01:PC 02:手機 03:收銀機 04:移動終端 05:靜態碼 |
| termModel | 終端型號 | C | String(64) | 商戶終端型號 |
| termManu | 終端廠商 | C | String(64) | 商戶終端廠商 |
| appCode | 終端app代碼 | C | String(64) | 商戶終端app代碼 |
| appVer | 終端app版本 | C | String(64) | 商戶終端app版本 |
| termFP | 終端指紋 | C | String(64) | 商戶終端指紋 |
termBaseStation、termLoc、termIp三者必須上送一個
公共響應參數
| 屬性 | 說明 | 必選 | 類型 | 備注 |
|---|---|---|---|---|
| retCode | 返回業務代碼 | M | String(8) | 返回業務代碼(按照錯誤信息來定) |
| retMsg | 返回業務代碼描述 | M | String(50) | 返回業務代碼描述 |
| sign | 簽名 | C | String(32) | 默認MD5方式簽名,簽名內容為retData+secret_key。 |
| timestamp | 時間戳 | M | Long | Unix時間戳,13位 |
| rnd | 隨機數 | C | String(32) | 隨機數 |
| reqId | 請求序列號 | C | String(32) | 請求序列號 |
| respId | 響應序列號 | C | String(32) | 響應序列號 |
| ver | 版本號 | M | String(6) | 版本號 |
| respData | 響應參數 | C | Object | 返回數據.下文定義的響應均為該屬性中的內容 |
The End
