# 服務端接入文檔
## **1.服務端登錄校驗接口**
> 接口描述：SDK服務端登錄校驗查詢接口;
> 使用場景：SDK 登錄成功之后，服務端校驗登錄用戶調用;
> 協議需求：HTTPS 協議, POST 方式請求；
### **1.1 請求接口URL**
```
https://sdk.youximao.com/cp/getUserByOpenId
```
### **1.2 請求參數**
```
參數類型 / 參數名稱 / 描述
---------------------------------
String / openId / 登錄成功后，返回的用戶唯一標識
```
### **1.3 返回參數**
```
參數類型 / 參數名稱 / 描述
---------------------------------
String / code / 狀態碼(code='000'表示成功)
String / message / 狀態碼對應的信息描述
JSON格式字符串 / data / 返回結果
```
```
返回參數“data”字段數據結果：
參數類型 / 參數名稱 / 描述
---------------------------------
Long / platAccount / 賬號
String / userName / 用戶昵稱
String / openId / 用戶唯一標識
String / gameId / 游戲id
Long / uid / 用戶id
```
```
返回結果樣例：
code: "000",
data: {
platAccount: "1800000",
userName: "測試",
gameId: "youximao_test_2",
openId: "4b5saetd18f45682aa9758668ee15614",
uid: "100001"
},
message: "success"
```
*****
## **2.支付成功，回調接入方通知接口**
> 接口描述：用戶使用SDK支付成功之后，SDK服務端通知接入方服務支付結果；
> 使用場景：用戶在游戲商城購買道具，調出SDK，然后進行支付，支付成功之后，游戲貓服務端通知接入方服務端支付結果，驗簽通過則進行發貨處理;
> 協議需求：HTTPS 協議, POST 方式請求；
### **2.1 請求接口URL**
```
以創建訂單時，渠道上送的通知“notifyUrl”為準
```
### **2.2 請求參數**
```
參數類型 / 參數名稱 / 描述
---------------------------------
String / codeNo / 對接方訂單號
String / tradeNo / 平臺交易訂單號
String / openId / 用戶唯一標識
String / amount / 交易金額
String / ext / 透傳參數
String / notifyUrl / 通知地址
String / sign / 簽名（簽名規則參考下面說明）
Short / payWay / 支付方式(1-支付寶,2-微信,3-喵點)
```
### **2.3 返回參數**
```
參數類型 / 參數名稱 / 描述
---------------------------------
String / code / 狀態碼(code='000'表示成功)
String / message / 狀態碼對應的信息描述
JSON格式字符串 / data / 返回結果（此接口data返回空字符）
```
```
返回結果樣例（H5SDK服務這邊"code"="000"表示通知成功，否則會繼續通知）：
code: "000",
data: "",
message: "success"
```
> 簽名規則說明:
按照返回字段首字母大小升序排列拼接(剔除返回字段 sign 和 data)，然后再拼接服務端分配的秘鑰，最 后對整個字符串進行 MD5 加密處理得到簽名數據。
例如: amount=1.0&codeNo=100&ext=1¬ifyUrl=http://x.xx.com&openId=adb&payWay=1&trade No=1001，最后拼接上服務端秘鑰(樣例:6a29c63ab6b9368ca0cc0e04962bc541)，得出簽名串如: amount=1.0&codeNo=100&ext=1¬ifyUrl=http://x.xx.com&openId=adb&payWay=1&trade No=10016a29c63ab6b9368ca0cc0e04962bc541，再對整個字符串進行 MD5。
*****
> 接口發貨邏輯處理:
用戶支付成功,會通知渠道支付結果,如果通知失敗,會有 10 次輪詢通知請求，輪詢通知失敗，再定時通知
