3.2 交易查询
<h2>描述</h2>
<p>该接口<strong>支持所有交易类型(支付,撤销,退款)的查询</strong>，商户可以通过该接口主动查询交易状态，完成下一步的业务逻辑。</p>
<p>需要调用查询接口的情况：</p>
<ol>
<li>当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；</li>
<li>调用支付接口后，返回系统错误或未知交易状态；</li>
<li>调用条码支付API，返回PROCESSING的状态；</li>
<li>调用撤销接口API之前，需确认支付状态；</li>
</ol>
<h2>请求参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">请求报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>请求方法</td>
<td>TEXT(128)</td>
<td>M</td>
<td>此接口固定值为：paycloud.pay.orderquery</td>
</tr>
<tr>
<td>merchant_no</td>
<td>商户号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户号，在PayCloud平台入驻后分配的商户号</td>
</tr>
<tr>
<td>out_order_no</td>
<td>商户支付单号或商户退款单号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>商户系统内部订单号，只允许数字或英文字母，下划线、 同一app_id下商户订单号不能重复商户订单号指商户系统自己生成的交易流水号，支付流水号和退款流水号是两个号码</td>
</tr>
<tr>
<td>trans_no</td>
<td>交易号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>PayCloud平台交易号</td>
</tr>
<tr>
<td>pay_channel_trans_no</td>
<td>支付通道交易号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>收单机构的交易流水</td>
</tr>
<tr>
<td>pay_platform_trans_no</td>
<td>支付平台交易号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>微信支付宝支付平台交易流水</td>
</tr>
<tr>
<td>extension_parameters</td>
<td>扩展参数</td>
<td>JSONObject</td>
<td>O</td>
<td>扩展输入参数，后续定义增加的参数存储于此JSON可变结构中</td>
</tr>
</tbody>
</table>
<h2></h2>
<h2>响应参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">响应报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<p>当 code=0 时，data[0] 返回如下参数：</p>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>trans_no</td>
<td>交易号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>PayCloud平台交易号</td>
</tr>
<tr>
<td>out_order_no</td>
<td>商户订单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td></td>
</tr>
<tr>
<td>merchant_no</td>
<td>商户号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>商户号，在PayCloud平台入驻后分配的商户号</td>
</tr>
<tr>
<td>store_no</td>
<td>门店编号</td>
<td>TEXT(16)</td>
<td>M</td>
<td>PayCloud分配的门店编号</td>
</tr>
<tr>
<td>payment_method</td>
<td>支付方式</td>
<td>TEXT(16)</td>
<td>M</td>
<td>目前支持的支付方式有：ALIPAY 支付宝WECHATPAY 微信支付UNIONPAY_QRCODE 银联二维码UNIONPAY 银联卡</td>
</tr>
<tr>
<td>trans_type</td>
<td>交易类型</td>
<td>NUMBER</td>
<td></td>
<td>1：消费；2：消费撤销；3：退款；5：预授权；6：预授权撤销；7：预授权完成；9：预授权完成撤销；</td>
</tr>
<tr>
<td>pay_operation_method</td>
<td>支付操作方式</td>
<td>NUMBER</td>
<td>M</td>
<td>0：未知1：插卡2：挥卡3：刷卡4：扫码支付5：条码支付6：H5支付7：小程序支付8：APP支付9：PC网页支付11：无卡支付12：无感支付</td>
</tr>
<tr>
<td>trans_status</td>
<td>交易状态</td>
<td>TEXT</td>
<td>M</td>
<td>交易状态:PREORDER - 交易预下单PROCESSING-买家支付中或系统退款中CLOSE-交易关闭，包括主动取消，超时未支付关闭，交易失败关闭SUCCESS-交易完成</td>
<td>当 trans_status交易状态为：SUCCESS-交易完成 时，data[0] 返回如下参数：</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>pay_user_account_id</td>
<td>买家账号标识</td>
<td>TEXT(32)</td>
<td>M</td>
<td>支付宝返回支付用户的ID,例如：2088101117955611微信返回商户appid下用户唯一标识，例如：wx37150978513678银行卡交易返回加*脱敏的卡号信息，例如：6226****1982</td>
</tr>
<tr>
<td>trans_currency</td>
<td>标价币种</td>
<td>TEXT(32)</td>
<td>O</td>
<td>符合ISO 4217标准的三位字母代码，币种列表详见货币类型</td>
</tr>
<tr>
<td>trans_amount</td>
<td>交易金额</td>
<td>AMOUNT</td>
<td>M</td>
<td>交易金额</td>
</tr>
<tr>
<td>customer_paid_amount</td>
<td>顾客实付金额</td>
<td>AMOUNT</td>
<td>C</td>
<td>交易过程中从顾客资金账户中实际扣减的金额，由于商户或收单方的一些营销优惠，顾客实际支付金额可能小于交易金额退款交易时此参数无意义，其值等于交易总金额</td>
</tr>
<tr>
<td>discount_bmopc</td>
<td>支付通道商户优惠金额</td>
<td>AMOUNT</td>
<td>O</td>
<td>商户在支付通道的服务提供方（微信、支付宝等）的系统发布营销活动（优惠券、代金券、满减、单品优惠），用户支付时享受的金额减免</td>
</tr>
<tr>
<td>discount_bpc</td>
<td>支付通道优惠金额</td>
<td>AMOUNT</td>
<td>O</td>
<td>支付通道提供方（微信、支付宝等）给用户提供的优惠，在交易过程中直接减免，如：鼓励金、立减、红包等营销活动</td>
</tr>
<tr>
<td>trans_end_time</td>
<td>交易完成时间</td>
<td>DATE</td>
<td>M</td>
<td>支付成功或失败的时间</td>
</tr>
<tr>
<td>discount_detail</td>
<td>商品优惠信息</td>
<td>JSONObject</td>
<td>O</td>
<td>biz_discount：业务优惠明细channel_discount：通道优惠明细本次交易支付所使用的单品券优惠的商品优惠信息，分为两个JSON展示</td>
</tr>
<tr>
<td>card_attr</td>
<td>卡属性</td>
<td>NUMBER</td>
<td>O</td>
<td>银联二维码及银行卡类交易时会返回此参数，取值如下：0: 未知1: 借记卡2: 贷记卡</td>
</tr>
<tr>
<td>related_trade_status</td>
<td>关联交易状态</td>
<td>NUMBER</td>
<td>O</td>
<td>R：已退款/撤销；PR：部分退款；F：已完结(预授权)</td>
</tr>
<tr>
<td>pay_channel_trans_no</td>
<td>支付通道交易号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>收单机构的交易流水</td>
</tr>
<tr>
<td>pay_platform_trans_no</td>
<td>支付平台交易号</td>
<td>TEXT(32)</td>
<td>O</td>
<td>微信支付宝支付平台交易流水</td>
</tr>
</tbody>
</table>