批量查询
<p>[TOC]</p>
<h4>简要描述</h4>
<ul>
<li>批量查询订单详情，每次可查询100单，超过100单通过lastId继续查询</li>
</ul>
<h4>请求URL</h4>
<ul>
<li><code>https://live.dreamo9.com/api/order/batch-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;">orderType</td>
<td style="text-align: left;">订单类型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(1)</td>
<td style="text-align: left;">T</td>
<td>P代表代收订单 T代表代付订单</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 开始日期与结束日期需在同一个月，大于等于开始日期(<code>结束日期和开始日期相同时，查询该日期的订单</code>)</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 开始日期与结束日期需在同一个月，小于结束日期(<code>结束日期和开始日期相同时，查询该日期的订单</code>)</td>
</tr>
<tr>
<td style="text-align: left;">startId</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;">0</td>
<td>第一次传输设置为“0”，后续将响应体的lastId设置在这里，响应结果将跳过lastId对应的订单，并且按日期升序查询</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;60cc09bce4b0f1c0b83761c9&quot;,
&quot;createTimeStart&quot;: &quot;2025-04-01&quot;,
&quot;createTimeEnd&quot;: &quot;2025-04-10&quot;,
&quot;mchNo&quot;: &quot;M1234567890&quot;,
&quot;orderType&quot;: &quot;T&quot;,
&quot;reqTime&quot;: 1622016572190,
&quot;sign&quot;: &quot;C380BEC2BFD727A4B6845133519F3AD6&quot;,
&quot;startId&quot;: &quot;0&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;">size</td>
<td style="text-align: left;">订单数量</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>2</td>
<td>该时间区间内的订单数量，每次最多100条</td>
</tr>
<tr>
<td style="text-align: left;">lastId</td>
<td style="text-align: left;">最后一笔订单对应的id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>T25040375675673</td>
<td>该时间区间内查询出的最后一笔订单的id，放入请求体中将跳过这笔订单往下继续查询</td>
</tr>
<tr>
<td style="text-align: left;">orders</td>
<td style="text-align: left;">订单数组</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">数组</td>
<td>[]</td>
<td>包含订单详情</td>
</tr>
</tbody>
</table>
<h5>orders数组数据格式 （payout）</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;">mchFeeAmount</td>
<td style="text-align: left;">订单手续费（分）</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>2</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;">Long</td>
<td>1999</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">商户订单号</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>Test-20250403151603389</td>
</tr>
<tr>
<td style="text-align: left;">mchName</td>
<td style="text-align: left;">商户名称</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>mch1</td>
</tr>
<tr>
<td style="text-align: left;">transferId</td>
<td style="text-align: left;">订单号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>T2504033423423</td>
</tr>
<tr>
<td style="text-align: left;">mchFeeRate</td>
<td style="text-align: left;">订单手续费率</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Double</td>
<td>0.05</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-04-03 15:16:03</td>
</tr>
<tr>
<td style="text-align: left;">amountTo</td>
<td style="text-align: left;">商户实扣金额(分）</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>2001</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>60cc09bce4b0f1c0b83761c9</td>
</tr>
<tr>
<td style="text-align: left;">successTime</td>
<td style="text-align: left;">成功时间</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>2025-04-03 20:55:05</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;">state</td>
<td style="text-align: left;">状态</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>2</td>
</tr>
<tr>
<td style="text-align: left;">accountBalance</td>
<td style="text-align: left;">余额快照（分）</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Long</td>
<td>37740</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>MTEST1</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-04-03 18:55:05</td>
</tr>
</tbody>
</table>
<h5>orders数组数据格式 （payin）</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;">id</td>
<td style="text-align: left;">唯一id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>4234</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;">Long</td>
<td>8</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;">Long</td>
<td>1999</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">商户订单号</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>Test-20250403151603389</td>
</tr>
<tr>
<td style="text-align: left;">mchName</td>
<td style="text-align: left;">商户名称</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>mch1</td>
</tr>
<tr>
<td style="text-align: left;">payOrderId</td>
<td style="text-align: left;">订单号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>P2504033423423</td>
</tr>
<tr>
<td style="text-align: left;">mchFeeRate</td>
<td style="text-align: left;">订单手续费率</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Double</td>
<td>0.05</td>
</tr>
<tr>
<td style="text-align: left;">payAmount</td>
<td style="text-align: left;">实际支付金额（分）BDT,USDT有效</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Long</td>
<td>1998</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-04-03 15:16:03</td>
</tr>
<tr>
<td style="text-align: left;">amountTo</td>
<td style="text-align: left;">商户实得金额(分）</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>1990</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>60cc09bce4b0f1c0b83761c9</td>
</tr>
<tr>
<td style="text-align: left;">successTime</td>
<td style="text-align: left;">成功时间</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>2025-04-03 20:55:05</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;">state</td>
<td style="text-align: left;">状态</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>2</td>
</tr>
<tr>
<td style="text-align: left;">accountBalance</td>
<td style="text-align: left;">余额快照（分）</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Long</td>
<td>37740</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>MTEST1</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-04-03 18:55:05</td>
</tr>
<tr>
<td style="text-align: left;">mchRemark</td>
<td style="text-align: left;">商户备注</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>test_remark</td>
</tr>
<tr>
<td style="text-align: left;">txHash</td>
<td style="text-align: left;">hash</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>accdc7ec3eedfa1607af685682088da18</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;size&quot;: 2,
&quot;lastId&quot;: &quot;T25040375675673&quot;,
&quot;orders&quot;: [
{&quot;accountBalance&quot;:37740,&quot;amount&quot;:1000,&quot;amountTo&quot;:1005,&quot;appId&quot;:&quot;60cc09bce4b0f1c0b83761c9&quot;,&quot;createdAt&quot;:&quot;2025-04-03 15: 16: 03&quot;,&quot;currency&quot;:&quot;INR&quot;,&quot;mchFeeAmount&quot;:5,&quot;mchFeeRate&quot;:0.003000,&quot;mchName&quot;:&quot;testMch&quot;,&quot;mchNo&quot;:&quot;M1234567890&quot;,&quot;mchOrderNo&quot;:&quot;Test-20250403151603389&quot;,&quot;state&quot;:2,&quot;successTime&quot;:&quot;2025-04-03 18: 55: 05&quot;,&quot;transferId&quot;:&quot;T25040342342342&quot;,&quot;updatedAt&quot;:&quot;2025-04-03 18: 55: 05&quot;},
{&quot;accountBalance&quot;:36735,&quot;amount&quot;:1000,&quot;amountTo&quot;:1005,&quot;appId&quot;:&quot;60cc09bce4b0f1c0b83761c9&quot;,&quot;createdAt&quot;:&quot;2025-04-03 19: 03: 07&quot;,&quot;currency&quot;:&quot;INR&quot;,&quot;mchFeeAmount&quot;:5,&quot;mchFeeRate&quot;:0.003000,&quot;mchName&quot;:&quot;testMch&quot;,&quot;mchNo&quot;:&quot;M1234567890&quot;,&quot;mchOrderNo&quot;:&quot;Test-20250403190307310&quot;,&quot;state&quot;:2,&quot;successTime&quot;:&quot;2025-04-03 19: 05: 06&quot;,&quot;transferId&quot;:&quot;T25040375675673&quot;,&quot;updatedAt&quot;:&quot;2025-04-03 19: 05: 06&quot;}
]
},
&quot;msg&quot;: &quot;SUCCESS&quot;,
&quot;sign&quot;: &quot;15C423WERW342TER99JPSLE5TER252&quot;
}</code></pre>
<h4>备注</h4>
<p><font color="#dd0000">##### 由于涉及到●●信息，此接口必须添加IP白名单，请联系客服添加</font></p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>