反查api
<h5>简要描述</h5>
<ul>
<li>当发起代付订单请求时,我司会根据商户的要求发起订单反查功能以验证订单的有效性,保证代付订单安全可靠,当验证通过后再执行后续的代付流程。商户方需在发起代付请求时提供反查api接口,我司提供签名验证md5Key,签名要求请参考具体的签名规则,签名密钥可独立。</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>反查api地址(商户方在发起代付请求时提供)</code> </li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post</li>
</ul>
<h5>请求Body参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">示例值</th>
<th>必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantid</td>
<td style="text-align: left;">202207208888</td>
<td>是</td>
<td>string</td>
<td>商户ID,由OnePay统一支付分配。</td>
</tr>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;">20220720123456</td>
<td>是</td>
<td>string</td>
<td>商户系统订单号,该订单号将作为OnePay 的返回数据。该值需在商户系统内唯一。</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">100.00</td>
<td>是</td>
<td>string</td>
<td>币数量</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">Fabscs5sd5f4gf4g5</td>
<td>是</td>
<td>string</td>
<td>收款方钱包地址</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">详见签名规则</td>
<td>是</td>
<td>string</td>
<td>32位大写MD5签名值 ,详见签名规则</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code>{
"code":"0000",
"msg":"success",
"data":{
"orderid":"20220720235026732209",//商户订单号
"merchantid":2022060100434708888,//商户号
"amount":"200.000",//币数量
"address":"Fabscs5sd5f4gf4g5 ",//钱包地址
"endtime":"1658332537",//订单完成时间/取消时间
"sign":""// 签名
}
}
</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;">code</td>
<td style="text-align: left;">string</td>
<td>订单结果"0000"为成功,其他失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>返回失败时,错误信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>成功时返回的数据,结果参考示例</td>
</tr>
</tbody>
</table>
<h5>失败返回示例</h5>
<pre><code>{
"code":"10001"
"msg":"fail"
}
</code></pre>
<h5>备注</h5>
<p>请求参数id和orderid不能同时为空</p>