# 服务端接入文档
## **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 次轮询通知请求，轮询通知失败，再定时通知
