余额查询
<p>[TOC]</p>
<h4>简要描述</h4>
<ul>
<li>查询商户账户余额。</li>
</ul>
<h4>请求URL</h4>
<ul>
<li><code>https://live.dreamo9.com/api/balance/query</code></li>
</ul>
<h4>请求方式</h4>
<ul>
<li><code>POST</code></li>
</ul>
<h4>请求类型</h4>
<ul>
<li><code>application/json</code></li>
</ul>
<h4>参数</h4>
<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>
<th style="text-align: left;">示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">M1234567890</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">应用ID</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">60cc09bce4b0f1c0b83761c9</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">请求时间</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">1622016572190</td>
<td>13位毫秒时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">C380BEC2BFD727A4B6845133519F3AD6</td>
<td><code>详见签名算法</code></td>
</tr>
</tbody>
</table>
<h5>请求示例：</h5>
<pre><code>{
&quot;mchNo&quot;: &quot;M165xxxxxxxx&quot;,
&quot;appId&quot;: &quot;629c4634xxxxxxxxx&quot;,
&quot;reqTime&quot;: &quot;1678683113216&quot;,
&quot;version&quot;: &quot;3.5&quot;,
&quot;signType&quot;: &quot;MD5&quot;,
&quot;sign&quot;: &quot;7106E46F1E585A769E4D470261C93D4C&quot;
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th>参数描述</th>
<th>参数名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>返回状态</td>
<td>code</td>
<td>是</td>
<td>int</td>
<td>0</td>
<td>0: 成功 其他: 失败</br><code>详见错误码</code></td>
</tr>
<tr>
<td>返回信息</td>
<td>msg</td>
<td>否</td>
<td>String(128)</td>
<td>签名失败</td>
<td>具体错误原因</br>例如：签名失败、参数格式●●错误</td>
</tr>
<tr>
<td>签名信息</td>
<td>sign</td>
<td>否</td>
<td>String(32)</td>
<td>1F0A241B0349894B0C8D68BE0CB40EE1</td>
<td>对data内数据签名，如data为空则不返回</td>
</tr>
<tr>
<td>返回数据</td>
<td>data</td>
<td>否</td>
<td>String(512)</td>
<td>{}</td>
<td>指定返回数据，json格式数据</td>
</tr>
</tbody>
</table>
<h5>data数据格式</h5>
<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>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">应用ID</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>629c4634xxxxxxxxx</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>M165xxxxxxxx</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">balance</td>
<td style="text-align: left;">账户余额</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>10000</td>
<td>账户余额（分）</td>
</tr>
<tr>
<td style="text-align: left;">payoutBalance</td>
<td style="text-align: left;">已代付金额（忽略）</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>10000</td>
<td>已代付金额（分）</td>
</tr>
<tr>
<td style="text-align: left;">agentBalance</td>
<td style="text-align: left;">冻结账户余额</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>10000</td>
<td>冻结账户余额（分）</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;agentBalance&quot;: &quot;40900&quot;,
&quot;appId&quot;: &quot;629c4634xxxxxxxxx&quot;,
&quot;balance&quot;: &quot;25021&quot;,
&quot;mchNo&quot;: &quot;M165xxxxxxxx&quot;,
&quot;payoutBalance&quot;: &quot;12188&quot;
},
&quot;msg&quot;: &quot;SUCCESS&quot;,
&quot;sign&quot;: &quot;50F6F538C710563501767B8610B5A886&quot;
}</code></pre>
<h4>备注</h4>
<p><font color="#dd0000">##### 由于涉及到●●信息，此接口必须添加IP白名单，请联系客服添加</font></p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>