微信充值-20190117
<p>[TOC]</p>
<h2>修订记录</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">版本</th>
<th style="text-align: left;">日期</th>
<th style="text-align: left;">操作内容</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">v1.0.0</td>
<td style="text-align: left;">20190114</td>
<td style="text-align: left;">创建</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<h2>接口文档维护者（前端 秦露）</h2>
<h2>接口约定</h2>
<h3>通用约定</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">名称</th>
<th style="text-align: left;">内容</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">协议</td>
<td style="text-align: left;">支持HTTPS/HTTP</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">接口地址</td>
<td style="text-align: left;">开发版：<a href="http://wxpayproxy.tcy365.org:1506/">http://wxpayproxy.tcy365.org:1506/</a><br>提测版：<a href="http://wxpayproxy.tcy365.org:1507">http://wxpayproxy.tcy365.org:1507</a> <br>稳定版：<a href="http://wxpayproxy.tcy365.org:1505/">http://wxpayproxy.tcy365.org:1505/</a><br> 正式版：<a href="http://wxpayproxy.tcy365.com/">http://wxpayproxy.tcy365.com/</a> <br>预发版：<a href="http://wxpayproxy.tcy365.com:2505">http://wxpayproxy.tcy365.com:2505</a></td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">Header</td>
<td style="text-align: left;">认证字段：AppKey</td>
<td style="text-align: left;">-</td>
</tr>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">application/json;charset=utf-8</td>
<td style="text-align: left;">-</td>
</tr>
</tbody>
</table>
<h3>通用Code值</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">代号区间</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">10000-19999</td>
<td style="text-align: left;">系统通用错误</td>
</tr>
<tr>
<td style="text-align: left;">20000-29999</td>
<td style="text-align: left;">业务错误</td>
</tr>
</tbody>
</table>
<h2>系统通用错误</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">code</th>
<th style="text-align: left;">说明</th>
<th>客户端提示信息</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1</td>
<td style="text-align: left;">成功</td>
<td>请求成功</td>
</tr>
</tbody>
</table>
<h2>业务错误（例如活动项目）</h2>
<ul>
<li>
<p>20001-20099 活动错误</p>
</li>
<li>
<p>20101-20199 请求错误</p>
</li>
<li>20201-20299 用户错误</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">code</th>
<th style="text-align: left;">说明</th>
<th>客户端提示信息</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1</td>
<td style="text-align: left;">成功</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">11000</td>
<td style="text-align: left;">没有权限</td>
<td>没有权限</td>
</tr>
</tbody>
</table>
<h2>特殊说明（需要给测试提供的接口）</h2>
<p>暂无</p>
<h2>其他说明</h2>
<p>下边的接口中的请求参数：tcyxlh（同城游序列号）、OpenId、UnionId 都从url上获取得到 。</p>
<h2>接口</h2>
<h3><del>接口1:获取该游戏公众号对应的微信的权限信息</del>（废弃）</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<p>暂无</p>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>AppId</td>
<td>string</td>
<td>公众号id</td>
<td>-</td>
</tr>
<tr>
<td>Timestamp</td>
<td>string</td>
<td>时间戳</td>
<td>-</td>
</tr>
<tr>
<td>NonceStr</td>
<td>string</td>
<td>随机字符串</td>
<td>-</td>
</tr>
<tr>
<td>Signature</td>
<td>string</td>
<td>签名</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":{ //数据
"AppId": "wx3df697c72d97a798",
"Timestamp": "1547459249",
"NonceStr": "F8D5387FF4CA25EFED9CAB0BBC116406",
"Signature": "10741e0ac826170c812e0a00073f669ef82f4684"
},
"Message":""
}</code></pre>
<h3>接口2:获取充值面额列表数据</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<p>暂无</p>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>meid</td>
<td>number</td>
<td>面额ID</td>
<td>-</td>
</tr>
<tr>
<td>jg</td>
<td>number</td>
<td>价格</td>
<td>-</td>
</tr>
<tr>
<td>yz</td>
<td>number</td>
<td>银子</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code":0, //code值
"Data":[{ //数据，目前是6个数据列表
"meid":1, // 面额ID
"jg":1, // 价格
"yz":10000 // 银子
}],
"Message":""
}
</code></pre>
<h3>接口3 获取用户历史充值记录（验证用户基础信息）</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong> </p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>tcyxlh</td>
<td>number</td>
<td>同城游序列号，为空则不请求</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"tcyxlh": 3432423 //同城游序列号
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>yhxlh</td>
<td>number</td>
<td>用户序列号</td>
<td>-</td>
</tr>
<tr>
<td>yhm</td>
<td>string</td>
<td>用户昵称</td>
<td>-</td>
</tr>
<tr>
<td>yxm</td>
<td>string</td>
<td>游戏名</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code": 0, //code值
"Data": {
"tcyxlh": 2312312, // 同城游序列号
"yhnc": "用户昵称", // 用户昵称
"yxm": "同城游打大A" // 游戏名
},
"Message": ""
}</code></pre>
<h3>接口4:充值订单创建</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>post</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>meid</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>面额ID</td>
<td>-</td>
</tr>
<tr>
<td>tcyxlh</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>同城游序列号</td>
<td>-</td>
</tr>
<tr>
<td>OpenId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>-</td>
</tr>
<tr>
<td>UnionId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"meid": 1, //面额ID
"tcyxlh": 2312312, // 同城游序列号
"OpenId": "",
"UnionId": ""
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>AppId</td>
<td>string</td>
<td>公众号id</td>
<td>-</td>
</tr>
<tr>
<td>TimeStamp</td>
<td>string</td>
<td>时间戳(秒)</td>
<td>-</td>
</tr>
<tr>
<td>NonceStr</td>
<td>string</td>
<td>随机串</td>
<td>-</td>
</tr>
<tr>
<td>Package</td>
<td>string</td>
<td>订单详情扩展字符串</td>
<td>统一支付接口返回的prepay_id参数值</td>
</tr>
<tr>
<td>SignType</td>
<td>string</td>
<td>签名方式</td>
<td>签名类型，默认为MD5，支持HMAC-SHA256和MD5</td>
</tr>
<tr>
<td>PaySign</td>
<td>string</td>
<td>签名</td>
<td>-</td>
</tr>
<tr>
<td>OrderNo</td>
<td>string</td>
<td>充值订单号</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code": 0, //code值
"Data": { //数据
"AppId": "wx3df697c72d97a798", // appId
"TimeStamp": "", // 时间戳(秒)
"NonceStr": "", // 随机串
"Package": "", // 订单详情扩展字符串
"SignType": "", //签名方式
"PaySign": "", //签名
"OrderNo": "" //充值订单号
},
"Message": ""
}</code></pre>
<h3>接口5:充值订单取消</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>post</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>OrderNo</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>充值订单号</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"OrderNo": "2321321312321321" //充值订单号
}</code></pre>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code": 0, //code值
"Data": {},
"Message": ""
}</code></pre>
<h3>接口6:充值成功页面</h3>
<p><strong>简要描述：</strong></p>
<ul>
<li>(接口介绍) </li>
</ul>
<p><strong>请求url：</strong></p>
<ul>
<li>(请求地址，后端填写)</li>
</ul>
<p><strong>适用版本：</strong> </p>
<ul>
<li>[v1.0+]</li>
</ul>
<p><strong>请求方式：</strong> </p>
<p><code>get</code></p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>tcyxlh</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>同城游序列号</td>
<td>-</td>
</tr>
<tr>
<td>OpenId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>-</td>
</tr>
<tr>
<td>UnionId</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code>{
"tcyxlh": 123456 ,//同城游序列号
"OpenId": "", // 充值银子
"UnionId": "" // 支付金额
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必选</th>
<th>默认值</th>
<th>说明</th>
<th>限制长度</th>
</tr>
</thead>
<tbody>
<tr>
<td>OrderNo</td>
<td>string</td>
<td>是</td>
<td>""</td>
<td>充值订单号</td>
<td>-</td>
</tr>
<tr>
<td>czyz</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>充值银子</td>
<td>-</td>
</tr>
<tr>
<td>zfje</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>支付金额</td>
<td>-</td>
</tr>
<tr>
<td>czsj</td>
<td>number</td>
<td>是</td>
<td>0</td>
<td>充值时间（时间戳，毫秒）</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code>{
"Code": 0, //code值
"Data":{
"OrderNo": "2321321312321321" ,//充值订单号
"czyz": 20000, // 充值银子
"zfje": 1, // 支付金额
"czsj": 12132323231 // 充值时间（时间戳，毫秒）
},
"Message": ""
}</code></pre>
<h3>欢迎使用ShowDoc！</h3>