查询彩票信息接口
<p>[TOC]</p>
<h5>业务背景</h5>
<ul>
<li>彩票直充商品，当订单状态为充值成功后，合作方可调用本接口查询彩票信息。</li>
<li>接口请求链路：合作方 --> 福禄</li>
</ul>
<h5>接口描述</h5>
<ul>
<li>本接口专用于彩票直充订单状态为充值成功后，合作方查询彩票信息。</li>
<li>请注意调用本接口使用如下的AppKey、Aes加解密Key
AppKey：<code>Q+6/C78HgFn76yy2W4uoQLvfkCAi/ddkUp1RdreqN+QUhH4ZZWwvn+hSDvnJgTaP</code>
Aes加解密Key：<code>b3c5d1d8945ea04402faf304c76f9494</code></li>
</ul>
<h5>接口地址</h5>
<ul>
<li><code>/api/LotteryTicket/QueryLotteryTicketInfo</code></li>
<li>API渠道服务请求地址（测试环境）：<code>https://it-fulu-mall-apichannelservice-api.suuyuu.cn</code></li>
<li>API渠道服务请求地址（生产环境）：<code>https://channelservice-api-mall.fulu.com</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>公共请求参数</h5>
<table>
<thead>
<tr>
<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;">app_key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开放平台分配给商户的app_key</td>
</tr>
<tr>
<td style="text-align: left;">encrypt_data</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>加密的业务报文，采用[AES加密](<a href="https://www.showdoc.com.cn/fuluapichannelservice/11558549786573526">https://www.showdoc.com.cn/fuluapichannelservice/11558549786573526</a> "AES加密")</td>
</tr>
</tbody>
</table>
<h5>业务报文参数</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;">lottery_ticket_number</td>
<td style="text-align: left;">三选一</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">50</td>
<td>彩票投注号码</td>
</tr>
<tr>
<td style="text-align: left;">customer_order_no</td>
<td style="text-align: left;">三选一</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">100</td>
<td>外部订单号</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">三选一</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">30</td>
<td>福禄开放平台订单号</td>
</tr>
</tbody>
</table>
<h5>业务报文参数示例</h5>
<p>根据彩票投注号码查询</p>
<pre><code> {
&quot;lottery_ticket_number&quot;: &quot;05-10-15-17-18-27-09&quot;
}</code></pre>
<p>根据外部订单号查询</p>
<pre><code> {
&quot;customer_order_no&quot;: &quot;Test202506161828250001&quot;
}</code></pre>
<p>根据福禄开放平台订单号查询</p>
<pre><code> {
&quot;order_id&quot;: &quot;25061636820966091728&quot;
}</code></pre>
<h5>公共请求参数示例</h5>
<p>根据彩票投注号码查询</p>
<pre><code>{
&quot;app_key&quot;: &quot;Q+6/C78HgFn76yy2W4uoQLvfkCAi/ddkUp1RdreqN+QUhH4ZZWwvn+hSDvnJgTaP&quot;,
&quot;encrypt_data&quot;: &quot;dNa9itOlcemapZ4rPXEwgmdCz1nR5soYFG0zXtiYc5MQahB1gldHFQ2GinP3P+soy/yCIeOL+1OT27o4mOyVdQ==&quot;
}</code></pre>
<p>根据外部订单号查询</p>
<pre><code>{
&quot;app_key&quot;: &quot;Q+6/C78HgFn76yy2W4uoQLvfkCAi/ddkUp1RdreqN+QUhH4ZZWwvn+hSDvnJgTaP&quot;,
&quot;encrypt_data&quot;: &quot;+vE71wCsxswojkH34lmC+Hp1+Uzhd7+iRM2nFxfNmIX+WSdUtcdtYnmjyynHer8U&quot;
}</code></pre>
<p>根据福禄开放平台订单号查询</p>
<pre><code>{
&quot;app_key&quot;: &quot;Q+6/C78HgFn76yy2W4uoQLvfkCAi/ddkUp1RdreqN+QUhH4ZZWwvn+hSDvnJgTaP&quot;,
&quot;encrypt_data&quot;: &quot;lYtOxdFLfyKOQ0XRhVbdST/9yN/k6ReQ3j16m/l4hDvWf0xzcN3ObL8UmLRqhhWe&quot;
}</code></pre>
<h5>响应参数</h5>
<table>
<thead>
<tr>
<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;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回码，详见底部《业务错误码》</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>返回码描述，详见底部《业务错误码》</td>
</tr>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>响应结果，json字符串</td>
</tr>
</tbody>
</table>
<h5>响应结果参数</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;">lottery_ticket_number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">50</td>
<td>彩票投注号码</td>
</tr>
<tr>
<td style="text-align: left;">customer_order_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">100</td>
<td>外部订单号</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">30</td>
<td>福禄开放平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">lottery_ticket_order_time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">19</td>
<td>彩票订单时间，格式yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">lottery_ticket_status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">1</td>
<td>彩票订单状态</br>1未开奖</br>2未中奖</br>3未兑奖</br>4已兑奖</td>
</tr>
<tr>
<td style="text-align: left;">lottery_ticket_Issue</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">20</td>
<td>彩票期数，示例值：2025068</td>
</tr>
</tbody>
</table>
<h5>成功响应示例</h5>
<pre><code>{
&quot;code&quot;: 0,
&quot;message&quot;: &quot;接口调用成功&quot;,
&quot;result&quot;: &quot;[{\&quot;lottery_ticket_number\&quot;:\&quot;05-10-15-17-18-27-09\&quot;,\&quot;customer_order_no\&quot;:\&quot;Test202506161828250001\&quot;,\&quot;order_id\&quot;:\&quot;25061636820966091728\&quot;,\&quot;lottery_ticket_order_time\&quot;:\&quot;2025-06-16 17:29:01\&quot;,\&quot;lottery_ticket_status\&quot;:2,\&quot;lottery_ticket_Issue\&quot;:\&quot;2025068\&quot;}]&quot;
}</code></pre>
<h5>异常响应示例</h5>
<pre><code> {
&quot;code&quot;: 1027,
&quot;message&quot;: &quot;订单不存在&quot;,
&quot;result&quot;: &quot;&quot;
}</code></pre>
<h5>业务错误码</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">返回码</th>
<th style="text-align: left;">返回码描述</th>
<th>解决方案</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td style="text-align: left;">接口调用成功</td>
<td>接口调用成功，按正常流程处理</td>
</tr>
<tr>
<td style="text-align: left;">1005</td>
<td style="text-align: left;">必须传入app_key</td>
<td>请检查请求参数app_key是否为空</td>
</tr>
<tr>
<td style="text-align: left;">1006</td>
<td style="text-align: left;">无效的app_key</td>
<td>1、检查appkey是否复制错误；<br>2、沙箱环境与生产环境数据不互通；<br>3、沙箱环境只能使用沙箱数据；</td>
</tr>
<tr>
<td style="text-align: left;">1020</td>
<td style="text-align: left;">接口权限验证失败，请联系接口提供方</td>
<td>请联系接口提供方</td>
</tr>
<tr>
<td style="text-align: left;">1021</td>
<td style="text-align: left;">Api渠道未启用</td>
<td>请联系接口提供方启用Api渠道</td>
</tr>
<tr>
<td style="text-align: left;">1022</td>
<td style="text-align: left;">应用加解密Key未配置</td>
<td>请联系接口提供方配置应用加解密Key，并提供给您</td>
</tr>
<tr>
<td style="text-align: left;">1023</td>
<td style="text-align: left;">接口权限未配置</td>
<td>请联系接口提供方配置接口权限</td>
</tr>
<tr>
<td style="text-align: left;">1024</td>
<td style="text-align: left;">加密的业务报文为空</td>
<td>请检查请求参数encrypt_data是否为空</td>
</tr>
<tr>
<td style="text-align: left;">1025</td>
<td style="text-align: left;">业务参数：彩票投注号码、外部订单号、福禄开放平台订单号不能同时为空</td>
<td>请检查加密前的业务报文中lottery_ticket_number、customer_order_no、order_id是否为空</td>
</tr>
<tr>
<td style="text-align: left;">1026</td>
<td style="text-align: left;">查询彩票信息的其他异常描述</td>
<td>提供请求报文，联系接口提供方排查</td>
</tr>
<tr>
<td style="text-align: left;">1027</td>
<td style="text-align: left;">订单不存在</td>
<td>订单不存在/非充值成功订单/非该商户订单，请检查彩票投注号码或订单号</td>
</tr>
<tr>
<td style="text-align: left;">5001</td>
<td style="text-align: left;">系统异常</td>
<td>提供请求报文，联系接口提供方排查</td>
</tr>
</tbody>
</table>