USDTAPI

接口文档


查询支付订单

<h2>3. 查询支付订单</h2> <p>&gt; 接口描述</p> <p>业务系统通过查询支付订单接口获取最新的支付订单状态,并根据状态结果进一步处理业务逻辑。</p> <p>&gt; 接口链接</p> <p>URL地址:{payUrl}/api/pay/query_order</p> <p>&gt; 请求参数</p> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>平台ID</td> <td>platId</td> <td>是</td> <td>String(30)</td> <td>1000</td> <td>支付中心分配的平台ID</td> </tr> <tr> <td>支付订单号</td> <td>payOrderId</td> <td>是</td> <td>String(30)</td> <td>P20160427210604000490</td> <td>支付中心生成的订单号,与mchOrderNo二者传一即可</td> </tr> <tr> <td>商户订单号</td> <td>mchOrderNo</td> <td>是</td> <td>String(30)</td> <td>20160427210604000490</td> <td>商户生成的订单号,与payOrderId二者传一即可</td> </tr> <tr> <td>请求时间</td> <td>reqTime</td> <td>是</td> <td>String(30)</td> <td>20190723141000</td> <td>请求接口时间, yyyyMMddHHmmss格式</td> </tr> <tr> <td>接口版本</td> <td>version</td> <td>是</td> <td>String(3)</td> <td>1.0</td> <td>接口版本号,固定:1.0</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>String(32)</td> <td>C380BEC2BFD727A4B6845133519F3AD6</td> <td>签名值,详见签名算法</td> </tr> </tbody> </table> <p>&gt; 响应结果</p> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>返回状态码</td> <td>code</td> <td>是</td> <td>String(16)</td> <td>0</td> <td>0-处理成功,其他-处理有误,详见错误码</td> </tr> <tr> <td>返回信息</td> <td>msg</td> <td>否</td> <td>String(128)</td> <td>签名失败</td> <td>具体错误原因,例如:签名失败、参数格式校验错误</td> </tr> </tbody> </table> <h5>以下字段在code=0 时有返回</h5> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>平台ID</td> <td>platId</td> <td>是</td> <td>String(30)</td> <td>1000</td> <td>支付中心分配的平台ID</td> </tr> <tr> <td>支付订单号</td> <td>payOrderId</td> <td>是</td> <td>String(30)</td> <td>P01201907231119090520000</td> <td>返回支付系统订单号</td> </tr> <tr> <td>商户订单号</td> <td>mchOrderNo</td> <td>是</td> <td>String(30)</td> <td>20160427210604000490</td> <td>商户生成的订单号</td> </tr> <tr> <td>下单金额-RMB</td> <td>amountRmb</td> <td>是</td> <td>int</td> <td>100</td> <td>下单金额-RMB,单位分</td> </tr> <tr> <td>下单金额-USDT</td> <td>amountUsdt</td> <td>是</td> <td>String</td> <td>0.156</td> <td>下单金额-USDT,单位个</td> </tr> <tr> <td>实际付款金额-RMB</td> <td>realAmountRmb</td> <td>是</td> <td>int</td> <td>100</td> <td>实际付款金额-RMB,单位分</td> </tr> <tr> <td>实际付款金额-USDT</td> <td>realAmountUsdt</td> <td>是</td> <td>String</td> <td>0.156</td> <td>实际付款金额-USDT,单位个</td> </tr> <tr> <td>签名信息</td> <td>sign</td> <td>是</td> <td>String(128)</td> <td>CCD9083A6DAD9A2DA9F668C3D4517A84</td> <td>签名信息</td> </tr> <tr> <td>订单状态</td> <td>status</td> <td>是</td> <td>String(3)</td> <td>2</td> <td>当前订单状态: -2:订单超时已关闭,1-支付中,2-支付成功</td> </tr> <tr> <td>支付成功时间</td> <td>paySuccTime</td> <td>否</td> <td>Long</td> <td>1505049094262</td> <td>支付成功时间,精确到毫秒</td> </tr> <tr> <td>请求时间</td> <td>reqTime</td> <td>是</td> <td>String(30)</td> <td>20190723141000</td> <td>请求接口时间, yyyyMMddHHmmss格式</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>String(32)</td> <td>C380BEC2BFD727A4B6845133519F3AD6</td> <td>签名值,详见签名算法</td> </tr> </tbody> </table>

页面列表

ITEM_HTML