API接口请求格式
<p>[TOC]</p>
<p>[TOC]</p>
<p>[TOC]</p>
<p>[TOC]</p>
<p><strong>请求URL:</strong></p>
<p><strong><a href="https://stg.mpursewallet.com/api/v2/gateway/service/partnerId">https://stg.mpursewallet.com/api/v2/gateway/service/partnerId</a></strong>
Content-Type - text/plain</p>
<p><strong>说明</strong>
路径中 service 是接口名, 由每个接口定义决定,如请求放款(代付)接口名是loanPay, partnerId 是商户ID,在商户注册时分配。</p>
<p><strong>请求方式:</strong></p>
<p><strong>POST</strong></p>
<p><strong>请求参数:</strong></p>
<p>请求参数字段详见各接口入参表, 加密后发送。</p>
<p><strong>加密方式:</strong></p>
<ul>
<li>请求和响应参数(代收、代付回调接口响应参数SUCCESS除外)均以加密方式传输。 请求参数加密、响应参数解密使用的key在商户注册时随partnerId一起分配,可在开户资料文档或邮件中看到。Java加解密Demo可在AES解密示例页面看到。</li>
<li>请求参数加密</li>
<li>加密格式: Base64.encode(AES.encrypt(json_data, key)); json_data为json格式的字符串,在请求参数示例中可见。</li>
<li>响应参数解密</li>
<li>解密格式: AES.decrypt(Base64.decode(retBizParams),key); retBizParams在响应参数示例中可见。</li>
<li>AES加密模式为 AES/ECB/PKCS5Padding 秘钥长度:256</li>
</ul>
<p><strong>请求参数示例:</strong></p>
<pre><code> json_data = {
"partnerId": "Mct_test_10001_PartnerId",
"payerVA": "test123@icici",
"txnId": "1234567890",
"amount": "2.0" ,
"product": "骑士家族-钻石大礼包",
"cMobile": "9998887770",
"cName": "Bodhid",
"expiredDate": "2019-07-26 10:30:00",
"remark": "test123"
}</code></pre>
<p><strong>返回参数说明</strong></p>
<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;">status</td>
<td style="text-align: left;">str</td>
<td style="text-align: left;">状态码</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">str</td>
<td style="text-align: left;">简要描述</td>
</tr>
<tr>
<td style="text-align: left;">retBizParams</td>
<td style="text-align: left;">str</td>
<td style="text-align: left;">加密后的响应参数,由json封装,json字段见各接口说明</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">明文如下:</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">decrypt_result = {</td>
</tr>
<tr>
<td style="text-align: left;">"status": "0000",</td>
</tr>
<tr>
<td style="text-align: left;">"message": "success",</td>
</tr>
<tr>
<td style="text-align: left;">"retBizParams": "由json封装,json字段见各接口说明"</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
</tbody>
</table>
<p><strong>响应代码列表</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">代码</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0000</td>
<td style="text-align: left;">成功,注意此代码不代表交易成功,详情需要看各个接口的返回参数</td>
</tr>
<tr>
<td style="text-align: left;">6612</td>
<td style="text-align: left;">商户代收当日限额超出限制</td>
</tr>
<tr>
<td style="text-align: left;">6613</td>
<td style="text-align: left;">商户下用户代付当日限额超出限制</td>
</tr>
<tr>
<td style="text-align: left;">6614</td>
<td style="text-align: left;">商户代付当日限额超出限制</td>
</tr>
<tr>
<td style="text-align: left;">6616</td>
<td style="text-align: left;">订单不存在,无法执行操作(如执行退款等)</td>
</tr>
<tr>
<td style="text-align: left;">6620</td>
<td style="text-align: left;">订单不存在,查询失败</td>
</tr>
<tr>
<td style="text-align: left;">6657</td>
<td style="text-align: left;">订单已存在,无法重复创建</td>
</tr>
<tr>
<td style="text-align: left;">6656</td>
<td style="text-align: left;">请求参数非法</td>
</tr>
<tr>
<td style="text-align: left;">6655</td>
<td style="text-align: left;">请求参数不匹配,如订单金额与订单号不匹配等</td>
</tr>
<tr>
<td style="text-align: left;">8826</td>
<td style="text-align: left;">专属收款账号已存在,创建账号失败</td>
</tr>
<tr>
<td style="text-align: left;">8887</td>
<td style="text-align: left;">方法不存在(方法名错误)</td>
</tr>
<tr>
<td style="text-align: left;">8888</td>
<td style="text-align: left;">未知异常</td>
</tr>
<tr>
<td style="text-align: left;">9992</td>
<td style="text-align: left;">批量查询订单,单批次参数个数超过上限个数</td>
</tr>
<tr>
<td style="text-align: left;">9993</td>
<td style="text-align: left;">入参校验失败,入参错误</td>
</tr>
<tr>
<td style="text-align: left;">8825</td>
<td style="text-align: left;">创建专属收款账号,用户名称格式校验失败</td>
</tr>
<tr>
<td style="text-align: left;">8824</td>
<td style="text-align: left;">创建专属收款账号,用户邮箱格式错误</td>
</tr>
<tr>
<td style="text-align: left;">8823</td>
<td style="text-align: left;">创建专属收款账号,用户手机号格式错误</td>
</tr>
<tr>
<td style="text-align: left;">8821</td>
<td style="text-align: left;">创建专属收款账号,用户编号格式错误</td>
</tr>
<tr>
<td style="text-align: left;">9994</td>
<td style="text-align: left;">无权限访问该 url</td>
</tr>
</tbody>
</table>