查询商户信息
<h1>查询商户信息接口开发文档</h1>
<h2>一、接口概述</h2>
<p>该接口用于查询特定商户的详细信息,包括商户的基本状态、支付与结算状态、账户余额、订单统计数据等,为商户管理和业务分析提供数据支持。</p>
<h2>二、接口基本信息</h2>
<ol>
<li><strong>请求地址</strong>:<code>https://pay.lmwa.cn/api/merchant/info</code></li>
<li><strong>请求方式</strong>:POST</li>
</ol>
<h2>三、请求参数说明</h2>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>商户 ID</td>
<td>pid</td>
<td>是</td>
<td>Int</td>
<td>1001</td>
<td>用于唯一标识商户身份,平台根据该 ID 查询对应商户的信息</td>
</tr>
<tr>
<td>当前时间戳</td>
<td>timestamp</td>
<td>是</td>
<td>String</td>
<td>1721206072</td>
<td>10 位整数,单位为秒。用于校验请求的时效性,防止请求被重放攻击</td>
</tr>
<tr>
<td>签名字符串</td>
<td>sign</td>
<td>是</td>
<td>String</td>
<td>-</td>
<td>按照特定签名规则生成的字符串,用于验证请求数据的完整性和真实性,确保请求未被篡改</td>
</tr>
<tr>
<td>签名类型</td>
<td>sign_type</td>
<td>是</td>
<td>String</td>
<td>RSA</td>
<td>默认采用 RSA 签名算法,指示签名所使用的具体算法</td>
</tr>
</tbody>
</table>
<h2>四、返回参数说明</h2>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>返回状态码</td>
<td>code</td>
<td>Int</td>
<td>0</td>
<td>0 表示查询成功,其他值表示失败。可根据错误码进一步排查问题</td>
</tr>
<tr>
<td>返回信息</td>
<td>msg</td>
<td>String</td>
<td>-</td>
<td>当查询成功或失败时,返回的提示信息,帮助开发者了解操作结果</td>
</tr>
<tr>
<td>商户 ID</td>
<td>pid</td>
<td>Int</td>
<td>1001</td>
<td>与请求中的商户 ID 一致,确认查询的商户身份</td>
</tr>
<tr>
<td>商户状态</td>
<td>status</td>
<td>Int</td>
<td>1</td>
<td>0 表示商户已被封禁,1 表示商户处于正常运营状态,2 表示商户正在等待审核</td>
</tr>
<tr>
<td>支付状态</td>
<td>pay_status</td>
<td>Int</td>
<td>1</td>
<td>0 表示支付功能已关闭,1 表示支付功能正常开启,商户可进行支付相关操作</td>
</tr>
<tr>
<td>结算状态</td>
<td>settle_status</td>
<td>Int</td>
<td>1</td>
<td>0 表示结算功能已关闭,1 表示结算功能正常开启,商户可进行结算操作</td>
</tr>
<tr>
<td>商户余额</td>
<td>money</td>
<td>String</td>
<td>50.00</td>
<td>商户在平台的账户余额,单位为元</td>
</tr>
<tr>
<td>结算方式</td>
<td>settle_type</td>
<td>Int</td>
<td>1</td>
<td>1 代表支付宝,2 代表微信,3 代表 QQ 钱包,4 代表银行卡,表明商户的结算渠道</td>
</tr>
<tr>
<td>结算账户</td>
<td>settle_account</td>
<td>String</td>
<td>alipay@alipay.com</td>
<td>商户用于结算的账户信息,如支付宝账号、银行卡号等</td>
</tr>
<tr>
<td>结算账户姓名</td>
<td>settle_name</td>
<td>String</td>
<td>张三</td>
<td>结算账户对应的姓名,用于确认账户归属</td>
</tr>
<tr>
<td>订单总数量</td>
<td>order_num</td>
<td>Int</td>
<td>10</td>
<td>商户在平台上产生的订单总数</td>
</tr>
<tr>
<td>今日订单数量</td>
<td>order_num_today</td>
<td>Int</td>
<td>3</td>
<td>商户当天产生的订单数量</td>
</tr>
<tr>
<td>昨日订单数量</td>
<td>order_num_lastday</td>
<td>Int</td>
<td>2</td>
<td>商户前一天产生的订单数量</td>
</tr>
<tr>
<td>今日订单收入</td>
<td>order_money_today</td>
<td>String</td>
<td>45.00</td>
<td>商户当天订单的总收入,单位为元</td>
</tr>
<tr>
<td>昨日订单收入</td>
<td>order_money_lastday</td>
<td>String</td>
<td>35.00</td>
<td>商户前一天订单的总收入,单位为元</td>
</tr>
<tr>
<td>当前时间戳</td>
<td>timestamp</td>
<td>String</td>
<td>1721206072</td>
<td>10 位整数,单位为秒,用于校验返回数据的时效性</td>
</tr>
<tr>
<td>签名字符串</td>
<td>sign</td>
<td>String</td>
<td>-</td>
<td>用于验证返回数据的合法性,确保数据未被篡改,参考签名规则生成</td>
</tr>
<tr>
<td>签名类型</td>
<td>sign_type</td>
<td>String</td>
<td>RSA</td>
<td>默认采用 RSA 签名算法,指示签名所使用的具体算法</td>
</tr>
</tbody>
</table>
<h2>五、结算方式列表</h2>
<table>
<thead>
<tr>
<th>状态值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>支付宝:使用支付宝作为结算渠道,支持多种支付场景,资金结算便捷</td>
</tr>
<tr>
<td>2</td>
<td>微信:通过微信进行结算,依托微信庞大的用户基础,支付和结算流程方便</td>
</tr>
<tr>
<td>3</td>
<td>QQ 钱包:以 QQ 钱包为结算方式,满足 QQ 用户的支付结算需求</td>
</tr>
<tr>
<td>4</td>
<td>银行卡:绑定银行卡进行结算,适用于习惯使用银行卡收付款的商户</td>
</tr>
</tbody>
</table>