Commit 23dcff7429e594ce6f1378837b64a2d358fb8413
1 parent
fa787d2d0e
Exists in
master
添加充值通知支付类型
Showing 1 changed file with 1 additions and 0 deletions Inline Diff
doc/ServerDocument.md
1 | ## GumpTech服务端接口文档 | 1 | ## GumpTech服务端接口文档 |
2 | 2 | ||
3 | 1. 用户登录验证接口 | 3 | 1. 用户登录验证接口 |
4 | ---------------------------- | 4 | ---------------------------- |
5 | 接口地址:http://api.gumptech.com/v1/user/verify_user.do | 5 | 接口地址:http://api.gumptech.com/v1/user/verify_user.do |
6 | 参数: | 6 | 参数: |
7 | appId: 游戏接入分配appid | 7 | appId: 游戏接入分配appid |
8 | appkey: 注意appkey都为小写字母 | 8 | appkey: 注意appkey都为小写字母 |
9 | userId: GumpTech平台的用户id | 9 | userId: GumpTech平台的用户id |
10 | sessionKey: 登录后回调给给第三方 | 10 | sessionKey: 登录后回调给给第三方 |
11 | 11 | ||
12 | 返回值: | 12 | 返回值: |
13 | { | 13 | { |
14 | "code":100000 | 14 | "code":100000 |
15 | "msg":"xxxxxx" | 15 | "msg":"xxxxxx" |
16 | "data":{ | 16 | "data":{ |
17 | "userId":23444 | 17 | "userId":23444 |
18 | "sessionKey":"xxx" | 18 | "sessionKey":"xxx" |
19 | } | 19 | } |
20 | } | 20 | } |
21 | 21 | ||
22 | 22 | ||
23 | 23 | ||
24 | 2. 充值通知第三方服务端接口 | 24 | 2. 充值通知第三方服务端接口 |
25 | ----------------------------- | 25 | ----------------------------- |
26 | 参数列表: | 26 | 参数列表: |
27 | orderId: 订单id | 27 | orderId: 订单id |
28 | appId: 游戏接入分配appid | 28 | appId: 游戏接入分配appid |
29 | userId: 平台用户id | 29 | userId: 平台用户id |
30 | product: 购买商品名字 | 30 | product: 购买商品名字 |
31 | extraInfo:游戏接入方传入自定义参数,200字符 | 31 | extraInfo:游戏接入方传入自定义参数,200字符 |
32 | currency:币种 exp:USD RMB | 32 | currency:币种 exp:USD RMB |
33 | amount:支付过程中选中额度,第三方可以忽略此参数 | 33 | amount:支付过程中选中额度,第三方可以忽略此参数 |
34 | realAmount: 最终用户支付的额度 | 34 | realAmount: 最终用户支付的额度 |
35 | serverId: 第三方区服id | 35 | serverId: 第三方区服id |
36 | roleId: 第三方平台角色id | 36 | roleId: 第三方平台角色id |
37 | subPayGateId: 支付类型id | ||
37 | sig: 签名 | 38 | sig: 签名 |
38 | 39 | ||
39 | 第三方server端返回值: | 40 | 第三方server端返回值: |
40 | 如果第三方验证成功,则返回字符串:success即可。 | 41 | 如果第三方验证成功,则返回字符串:success即可。 |
41 | 42 | ||
42 | 43 | ||
43 | 3.签名算法 | 44 | 3.签名算法 |
44 | -------------------------------- | 45 | -------------------------------- |
45 | 46 | ||
46 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 | 47 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 |
47 | ```java | 48 | ```java |
48 | 49 | ||
49 | /** | 50 | /** |
50 | * 签名算法 | 51 | * 签名算法 |
51 | * @param request | 52 | * @param request |
52 | * @return | 53 | * @return |
53 | */ | 54 | */ |
54 | public String sig(HttpServletRequest request, String key){ | 55 | public String sig(HttpServletRequest request, String key){ |
55 | 56 | ||
56 | Enumeration names = request.getParameterNames(); | 57 | Enumeration names = request.getParameterNames(); |
57 | SortedSet<String> allParams = Sets.newTreeSet(); | 58 | SortedSet<String> allParams = Sets.newTreeSet(); |
58 | 59 | ||
59 | while (names.hasMoreElements()) { | 60 | while (names.hasMoreElements()) { |
60 | String name = (String) names.nextElement(); | 61 | String name = (String) names.nextElement(); |
61 | if (name.equals("sig")) { | 62 | if (name.equals("sig")) { |
62 | continue; | 63 | continue; |
63 | } | 64 | } |
64 | 65 | ||
65 | try { | 66 | try { |
66 | allParams.add(name + "=" + UriUtils.decode(request.getParameter(name), "utf-8")); | 67 | allParams.add(name + "=" + UriUtils.decode(request.getParameter(name), "utf-8")); |
67 | } catch (UnsupportedEncodingException e) { | 68 | } catch (UnsupportedEncodingException e) { |
68 | e.printStackTrace(); | 69 | e.printStackTrace(); |
69 | } | 70 | } |
70 | } | 71 | } |
71 | 72 | ||
72 | String params = Joiner.on("&").join(allParams)+key; | 73 | String params = Joiner.on("&").join(allParams)+key; |
73 | String computedToken = DigestUtils.md5DigestAsHex(params.getBytes()); | 74 | String computedToken = DigestUtils.md5DigestAsHex(params.getBytes()); |
74 | return computedToken; | 75 | return computedToken; |
75 | } | 76 | } |
76 | ``` | 77 | ``` |
77 | 78 | ||
78 | 79 | ||
79 | 80 | ||
80 | 注意:参数是按字母升序排列 | 81 | 注意:参数是按字母升序排列 |
81 | 82 | ||
82 | 83 | ||
83 | 4. 错误码对照表 | 84 | 4. 错误码对照表 |
84 | ----------------------------- | 85 | ----------------------------- |
85 | 86 | ||
86 | 100000 : 成功 | 87 | 100000 : 成功 |
87 | 800000 : 应用不存在 | 88 | 800000 : 应用不存在 |
88 | 100010 : 用户密码错误 | 89 | 100010 : 用户密码错误 |
89 | 100011 : 用户已经存在 | 90 | 100011 : 用户已经存在 |
90 | 100012 : 用户不存在 | 91 | 100012 : 用户不存在 |
91 | 100013 : 用户名不能为空 | 92 | 100013 : 用户名不能为空 |
92 | 900000 : 订单不存在 | 93 | 900000 : 订单不存在 |
93 | 900001 : 支付失败 | 94 | 900001 : 支付失败 |
94 | 900003 : sig签名错误 | 95 | 900003 : sig签名错误 |