专属账号收款订单查询
<p><strong>简要描述:</strong></p>
<p>查询收款订单信息
1、当订单回调结果未回调成功,商户可以使用该接口进行订单查询。
2、商户在后台中进行逻辑处理时,需要注意数据的幂等校验,防止回调接口和当前该接口同时或重复处理同一笔订单。响应参数中mpQueryId + bankRRN字段值可做唯一校验。
3、当查询数据时,没有查询到当天未成功回调的订单,有两种可能。一是用户使用的第三方支付系统与银行间的业务处理未及时处理,这时订订还没有最终的结果。二是银行未能成功将订单结果告知我方,这种情况会在次日早上,我方和银行对账时发现,并会及时处理,订单结果会由系统以回调方式通知商户。</p>
<p><strong>接口名</strong></p>
<p>queryVcollectOrds</p>
<p><strong>接口请求参数:</strong></p>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">receiverVA</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td style="text-align: left;">收款专属账号</td>
</tr>
<tr>
<td style="text-align: left;">bankRRN</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(15)</td>
<td style="text-align: left;">银行订单id,在用户手机支付结果页面可以看到</td>
</tr>
<tr>
<td style="text-align: left;">beginTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(14)</td>
<td style="text-align: left;">数据创建时间开始时间点, 格式:yyyyMMddHHmmss</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(14)</td>
<td style="text-align: left;">数据创建时间结束时间点 , 格式:yyyyMMddHHmmss</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">request = {</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">"receiverVA": "mpu.nbfc.wete23543@icici",</td>
</tr>
<tr>
<td style="text-align: left;">"bankRRN":"021800670093",</td>
</tr>
<tr>
<td style="text-align: left;">"beginTime": "20200102150000",</td>
</tr>
<tr>
<td style="text-align: left;">"endTime": "20200102180000"</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
</tbody>
</table>
<p><strong>响应参数:</strong></p>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mpQueryId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">mpurse 端生成的关联订单号</td>
</tr>
<tr>
<td style="text-align: left;">payerVA</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">付款用户账户</td>
</tr>
<tr>
<td style="text-align: left;">payerAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">付款金额</td>
</tr>
<tr>
<td style="text-align: left;">txnStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">支付状态 : TRANSACTION_SUCCESS - 交易成功, TRANSACTION_FAILURE - 用户拒绝(交易失败)</td>
</tr>
<tr>
<td style="text-align: left;">payChannel</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">支付渠道,UPI</td>
</tr>
<tr>
<td style="text-align: left;">txnCompletionDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">交易完成时间 (yyyyMMddHHmmss)</td>
</tr>
<tr>
<td style="text-align: left;">partnerId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">商户id</td>
</tr>
<tr>
<td style="text-align: left;">bankRRN</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">银行订单号</td>
</tr>
<tr>
<td style="text-align: left;">receiverVA</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">收款专属账号</td>
</tr>
<tr>
<td style="text-align: left;">errorMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">订单失败原因</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">{</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">"status": "0000",</td>
</tr>
<tr>
<td style="text-align: left;">"message": "success",</td>
</tr>
<tr>
<td style="text-align: left;">"retBizParams": [{</td>
</tr>
<tr>
<td style="text-align: left;">"mpQueryId": "3131414131",</td>
</tr>
<tr>
<td style="text-align: left;">"payerVA": "payer.example@paytm",</td>
</tr>
<tr>
<td style="text-align: left;">"bankRRN": "1234567890",</td>
</tr>
<tr>
<td style="text-align: left;">"payerAmount": "120.00",</td>
</tr>
<tr>
<td style="text-align: left;">"payChannel":"UPI",</td>
</tr>
<tr>
<td style="text-align: left;">"txnStatus": "TRANSACTION_SUCCESS",</td>
</tr>
<tr>
<td style="text-align: left;">"txnCompletionDate": "20190706121000",</td>
</tr>
<tr>
<td style="text-align: left;">"partnerId": "Mct_test_10001_PartnerId",</td>
</tr>
<tr>
<td style="text-align: left;">"receiverVA":"mpu.cpdf.user1234567@icici",</td>
</tr>
<tr>
<td style="text-align: left;">"errorMsg": "transaction success"</td>
</tr>
<tr>
<td style="text-align: left;">},</td>
</tr>
<tr>
<td style="text-align: left;">{</td>
</tr>
<tr>
<td style="text-align: left;">"mpQueryId": "3131414132",</td>
</tr>
<tr>
<td style="text-align: left;">"payerVA": "payer.example@paytm",</td>
</tr>
<tr>
<td style="text-align: left;">"bankRRN": "1234567891",</td>
</tr>
<tr>
<td style="text-align: left;">"payerAmount": "340.00",</td>
</tr>
<tr>
<td style="text-align: left;">"payChannel":"UPI",</td>
</tr>
<tr>
<td style="text-align: left;">"txnStatus": "TRANSACTION_SUCCESS",</td>
</tr>
<tr>
<td style="text-align: left;">"txnCompletionDate": "20190706121100",</td>
</tr>
<tr>
<td style="text-align: left;">"partnerId": "Mct_test_10001_PartnerId",</td>
</tr>
<tr>
<td style="text-align: left;">"receiverVA":"mpu.cpdf.user1234567@icici",</td>
</tr>
<tr>
<td style="text-align: left;">"errorMsg": "transaction success"</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
<tr>
<td style="text-align: left;">]</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
</tbody>
</table>