掃碼預授權公共參數說明

拉卡拉 3個月前 ( 11-20 ) 145

公共說明

  • 接口文檔中,必選欄目:M 必須,C 可選


說明描述
接口版本v1.0.0
功能描述外部機構接入開放平臺
調用方外部機構
請求方法POST
請求簽名
響應簽名
需要BASE64編碼
授權方式LKLAPI-SHA256withRSA
測試環境URLhttps://test.wsmsd.cn/sit/api/v2/labs/txn
生產環境URLhttps://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時間戳CLongUnix時間戳。13位
rnd隨機數CString(32)隨機數
ver版本號CString(6)1.0.0
reqId請求序列號CString(32)-
reqData請求參數MObject
locationInfo地址位置信息MObject
termExtInfo終端信息MObject無特殊處理需求或無終端信息,填寫”termExtInfo”:{}

locationInfo字段說明

字段名中文名稱是否必填類型說明
requestIp請求方IP地址MString(64)請求方的IP地址,存在必填,格式如36.45.36.95
baseStation基站信息CString(128)客戶端設備的基站信息(主掃時基站信息使用該字段)
location緯度,經度CString(32)商戶終端的地理位置,存在必填 格式:緯度,經度,+表示北緯、東經,-表示南緯、 西經,精度最長支持小數點后9位。舉例:+37.123456789,-121.123456789

termExtInfo字段說明

屬性說明必選類型備注
termSN終端設備序列號CString(64)商戶終端設備的SN號,存在必填,如:QR930000001172
termBaseStation終端基站信息CString(128)商戶終端設備的基站信息,存在必填,上送格式為:MNC 移動網絡號碼(2)+LAC 位置區域碼(5)+CID 基站編號(8)其中LAC不滿五位,或CID不滿足8位的均左補空格.如:00 6361 ·58130 為:00+LAC:6361+CID:58130
termLoc終端地理位置CString(100)商戶終端的地理位置,存在必填 格式:緯度,經度,+表示北緯、東經,-表示南緯、 西經,精度最長支持小數點后9位。舉例:+37.123456789,-121.123456789
termIp終端IP地址CString(32)商戶終端的IP地址,存在必填,格式如36.45.36.95
termSerialNo終端設備串號CString(64)商戶終端硬件的設備串號,存在必填,靜態碼沒有
termType終端設備類型CString(2)商戶終端硬件的設備類型,必填
01:PC
02:手機
03:收銀機
04:移動終端
05:靜態碼
termModel終端型號CString(64)商戶終端型號
termManu終端廠商CString(64)商戶終端廠商
appCode終端app代碼CString(64)商戶終端app代碼
appVer終端app版本CString(64)商戶終端app版本
termFP終端指紋CString(64)商戶終端指紋

termBaseStation、termLoc、termIp三者必須上送一個


公共響應參數

屬性說明必選類型備注
retCode返回業務代碼MString(8)返回業務代碼(按照錯誤信息來定)
retMsg返回業務代碼描述MString(50)返回業務代碼描述
sign簽名CString(32)默認MD5方式簽名,簽名內容為retData+secret_key。
timestamp時間戳MLongUnix時間戳,13位
rnd隨機數CString(32)隨機數
reqId請求序列號CString(32)請求序列號
respId響應序列號CString(32)響應序列號
ver版本號MString(6)版本號
respData響應參數CObject返回數據.下文定義的響應均為該屬性中的內容



The End