提汇查询
<p>[TOC]</p>
<h4>简要描述</h4>
<ul>
<li>查询时间区间在6个月以内</li>
<li>金额单位： 元</li>
</ul>
<h4>请求URL</h4>
<ul>
<li><code>https://live.dreamo9.com/api/draw/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;">createTimeStart</td>
<td style="text-align: left;">开始日期</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td style="text-align: left;">2025-04-01</td>
<td>yyyy-MM-dd 开始日期</td>
</tr>
<tr>
<td style="text-align: left;">createTimeEnd</td>
<td style="text-align: left;">结束日期</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td style="text-align: left;">2025-04-10</td>
<td>yyyy-MM-dd 结束日期)</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;appId&quot;: &quot;A9876543210&quot;,
&quot;createTimeStart&quot;: &quot;2024-12-01&quot;,
&quot;createTimeEnd&quot;: &quot;2025-03-31&quot;,
&quot;mchNo&quot;: &quot;M5551234567&quot;,
&quot;reqTime&quot;: 1763999999999,
&quot;sign&quot;: &quot;A1B2C3D4E5F6789012345678901234567&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>draws数组数据格式</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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">drawId</td>
<td style="text-align: left;">提汇ID</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>D2502010812345678</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</td>
<td>A9999888777</td>
</tr>
<tr>
<td style="text-align: left;">appName</td>
<td style="text-align: left;">应用名称</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>test1</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</td>
<td>M11111</td>
</tr>
<tr>
<td style="text-align: left;">accountNo</td>
<td style="text-align: left;">收款账号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>MTEST1</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">币种</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>INR</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">汇款金额</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>30.5</td>
</tr>
<tr>
<td style="text-align: left;">exchangeRate</td>
<td style="text-align: left;">结汇汇率）</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>1.05</td>
</tr>
<tr>
<td style="text-align: left;">drawAmount</td>
<td style="text-align: left;">提汇金额(元)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>100.0</td>
</tr>
<tr>
<td style="text-align: left;">drawAmountTo</td>
<td style="text-align: left;">商户实际扣除</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>105.0</td>
</tr>
<tr>
<td style="text-align: left;">mchFeeAmount</td>
<td style="text-align: left;">提汇手续费</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>1.0</td>
</tr>
<tr>
<td style="text-align: left;">createdAt</td>
<td style="text-align: left;">创建时间</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>2025-02-01 08:12:34</td>
</tr>
<tr>
<td style="text-align: left;">updatedAt</td>
<td style="text-align: left;">更新时间</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>2025-02-01 08:15:00</td>
</tr>
</tbody>
</table>
<h3>响应体</h3>
<pre><code>
{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;SUCCESS&quot;,
&quot;sign&quot;: &quot;B2C3D4E5F678901234567890123456789&quot;,
&quot;data&quot;: {
&quot;size&quot;: 2,
&quot;draws&quot;: [
{
&quot;drawId&quot;: &quot;D2502010812345678&quot;,
&quot;appId&quot;: &quot;A9999888777&quot;,
&quot;appName&quot;: &quot;test1&quot;,
&quot;mchNo&quot;: &quot;M5551234567&quot;,
&quot;accountNo&quot;: &quot;DEMO123&quot;, // 收款账号
&quot;currency&quot;: &quot;PKR&quot;,
&quot;amount&quot;: 30.5, // 汇款金额
&quot;exchangeRate&quot;: 1.05, // 结汇汇率
&quot;drawAmount&quot;: 100.0, // 提汇金额
&quot;drawAmountTo&quot;: 105.0, // 商户实际扣除
&quot;mchFeeAmount&quot;: 1.0, // 提汇手续费
&quot;createdAt&quot;: &quot;2025-02-01 08:12:34&quot;,
&quot;updatedAt&quot;: &quot;2025-02-01 08:15:00&quot;
},
{
&quot;drawId&quot;: &quot;D2501312244332211&quot;,
&quot;appId&quot;: &quot;A7777888999&quot;,
&quot;appName&quot;: &quot;test2&quot;,
&quot;mchNo&quot;: &quot;M5551234567&quot;,
&quot;accountNo&quot;: &quot;DEMO456&quot;,
&quot;currency&quot;: &quot;INR&quot;,
&quot;amount&quot;: 3.0,
&quot;exchangeRate&quot;: 0.92,
&quot;drawAmount&quot;: 200.0,
&quot;drawAmountTo&quot;: 184.0,
&quot;mchFeeAmount&quot;: 1.5,
&quot;createdAt&quot;: &quot;2025-01-31 22:44:33&quot;,
&quot;updatedAt&quot;: &quot;2025-01-31 22:50:00&quot;
}
]
}
}
</code></pre>
<h4>备注</h4>
<p><font color="#dd0000">##### 由于涉及到●●信息，此接口必须添加IP白名单，请联系客服添加</font></p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>