# 查询订单状态

**1. 接口调用：**

```
https://{host}/api/v2/queryOrderState
```

**2. 请求参数实例**

<table><thead><tr><th width="236">参数</th><th>是否必须</th><th>说明</th></tr></thead><tbody><tr><td>equipmentNo</td><td>是</td><td>设备唯一编号</td></tr><tr><td>sourceType</td><td>是</td><td>ANDROID,IOS,H5</td></tr><tr><td>orderId</td><td>是</td><td>eg：1fc8499f-dd6d-4ff3-8b7f-7a0d74c59adc</td></tr></tbody></table>

**3.请求参数示例**

```
{
    "equipmentNo":"SFjeigreEIFegjieFei",
    "sourceType":"H5",
    "orderId":"9d4a577d-fdb1-466c-8da2-a5ad3553260b"
}
```

**4.返回结果示例**

```
{
    "data": {
        "chainFee": "0.001",//兑换完成后发币旷工费
        "changeType": "advanced",//去中心化兑换
        "choiseFeeType": "3", // 手续费类型
        "completeTime": null,
        "createTime": "2022-03-10 18:44:21",
        "dealFinishTime": null,
        "dealReceiveCoinAmt": "",
        "depositCoinAmt": "2",
        "depositCoinCode": "ETH",
        "depositCoinFeeAmt": "0.004",//兑换手续费
        "depositCoinFeeRate": "0.002",//兑换手续费率
        "depositCoinState": "wait_send",
        "depositHashExplore": "https://etherscan.io/tx/null", //存币hash
        "depositTxid": "",
        "destinationAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//用户接收币种地址
        "detailState": "wait_deposit_send",//订单状态（详见查询订单状态接口）
        "instantRate": "6.874588522739",//汇率
        "isDiscount": "N",
        "isNft": "",
        "kycUrl": "",//超过当日限额的kyc路径（详见查询订单状态接口）
        "nftUrl": "",
        "orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",//订单号
        "payTokenUrl": "",
        "platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",//存币地址（用户创建订单后需向此地址转币，转币币种depositCoinCode，转币数量depositCoinAmt）
        "receiveCoinAmt": "13.713109",
        "receiveCoinCode": "BNB(BSC)",
        "receiveHashExplore": "https://bscscan.com/tx/",
        "receiveSwftAmt": "2416.89",
        "refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//退币地址（兑换失败退回存币币种到此地址）
        "refundCoinAmt": "",//兑换失败时的退币数量
        "refundCoinMinerFee": "",
        "refundDepositTxid": "",//兑换失败时的退币哈希
        "refundHashExplore": "https://etherscan.io/tx/",
        "refundSwftAmt": "",
        "router": {},
        "swftCoinFeeRate": "0.001",
        "swftCoinState": "",
        "swftReceiveAddr": "",
        "swftRefundAddr": "",
        "timeoutShowPlatformAddr": "N", // 是否展示复用地址
        "tradeState": "",
        "transactionId": "",//兑换完成的发币哈希
        "burnRate": "0",//燃烧率
        "refundReason": "" // 退币原因 
    },
    "resCode": "800",
    "resMsg": "成功",
    "resMsgEn": ""
}
```

**5.返回参数说明**

<table><thead><tr><th width="126.666748046875">字段名称</th><th width="180.6666259765625">字段</th><th>备注</th><th data-hidden>备注</th></tr></thead><tbody><tr><td>订单号</td><td>orderId</td><td>eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a</td><td>eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a</td></tr><tr><td>存币币种</td><td>depositCoinCode</td><td>eg：ETH</td><td>eg：ETH</td></tr><tr><td>接收币币种</td><td>receiveCoinCode</td><td>eg：BTC</td><td>eg：BTC</td></tr><tr><td>存币数量    </td><td>depositCoinAmt</td><td>eg：1</td><td>eg：1</td></tr><tr><td>接收币数量     </td><td>receiveCoinAmt </td><td>eg：0.1</td><td>eg：0.1</td></tr><tr><td>存币地址</td><td>platformAddr</td><td>eg：123123123-232-1231232</td><td>eg：123123123-232-1231232</td></tr><tr><td>目标币接收地址</td><td>destinationAddr</td><td><p>eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY</p><p>如有memo请将memo放到地址后，用#分隔</p><p>例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632</p></td><td>"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY, 如有memo,请讲memo放到地址后，用#分隔，例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"</td></tr><tr><td>退原币的地址</td><td>refundAddr</td><td><p>eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY </p><p>如有memo,请讲memo放到地址后，用#分隔</p><p>例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632</p></td><td>"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后，用#分隔，例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"</td></tr><tr><td>存币的手续费率</td><td>depositCoinFeeRate</td><td>eg：手续费率</td><td>eg：手续费率</td></tr><tr><td>存币的手续费金额     </td><td>depositCoinFeeAmt</td><td>eg：手续费收取的原币的数量</td><td>eg：手续费收取的原币的数量</td></tr><tr><td>退币金额</td><td>refundCoinAmt</td><td>eg: 0.98</td><td>eg: 0.98</td></tr><tr><td>兑换成功交易id</td><td>transactionId</td><td>链上交易id，在兑换完成并已发币之后，该字段才会有值</td><td>链上交易id，在兑换完成并已发币之后，该字段才会有值</td></tr><tr><td>兑换失败交易id</td><td>refundDepositTxid</td><td>链上交易id，在兑换失败退币情况下，已退币之后，该字段才会有值</td><td>链上交易id，在兑换失败退币情况下，已退币之后，该字段才会有值</td></tr><tr><td>订单状态</td><td>detailState</td><td><p>(1)wait_deposit_send:等待存币发送 </p><p>(2)timeout:超时</p><p>(3)wait_exchange_push:等待交换信息推送(4)wait_exchange_return:等待交换信息返回</p><p>(5.1)</p><p>wait_receive_send:等待接收币种发送,wait_receive_confirm:等待接收币种确认receive_complete:接收币种确认完成</p><p>(5.2)</p><p>wait_refund_send:等待退原币币种发送wait_refund_confirm:等待退原币币种确认refund_complete:退原币币种确认完成</p><p>(6)ERROR/error:正在处理的订单 </p><p>(7)WAIT_KYC: 等待进行KYC或联系客服提供链接</p></td><td>"(1)wait_deposit_send:等待存币发送 (2)timeout:超时； (3)wait_exchange_push:等待交换信息推送； (4)wait_exchange_return:等待交换信息返回； (5.1)wait_receive_send:等待接收币种发送, wait_receive_confirm:等待接收币种确认, receive_complete:接收币种确认完成. (5.2)wait_refund_send:等待退原币币种发送, wait_refund_confirm:等待退原币币种确认, refund_complete:退原币币种确认完成； (6)ERROR/error:正在处理的订单 (7)WAIT_KYC: 等待进行KYC或联系客服提供链接"</td></tr><tr><td>实际兑换得到的币的数量</td><td>dealReceiveCoinAmt</td><td>实际兑换得到的数量,在兑换未完成时，该值为空字符串</td><td> 实际兑换得到的数量,在兑换未完成时，该值为空字符串</td></tr><tr><td>订单完成时间</td><td>completeTime</td><td>订单发币或退币完成时的时间（UTC+8）</td><td>订单发币或退币完成时的时间（UTC+8）</td></tr><tr><td>燃烧率</td><td>burnRate</td><td>燃烧率 默认为0</td><td>燃烧率 默认为0</td></tr><tr><td>订单创建时间</td><td>createTime</td><td>订单创建时间</td><td>订单创建时间</td></tr><tr><td>订单完成的时间</td><td>dealFinishTime</td><td>订单完成的时间</td><td>订单完成的时间</td></tr><tr><td>存币的存放状态</td><td>depositCoinState</td><td><p>wait_send:待发送</p><p>wait_confirm:待确认</p><p>already_confirm:已确认</p></td><td>wait_send:待发送、wait_confirm:待确认、already_confirm:已确认</td></tr><tr><td>退手续费交易id</td><td>depositTxid</td><td>退手续费交易id</td><td>退手续费交易id</td></tr><tr><td>速币数量</td><td>receiveSwftAmt</td><td>速币数量</td><td>速币数量</td></tr><tr><td>速币的手续费率</td><td>swftCoinFeeRate</td><td>速币的手续费率</td><td>速币的手续费率</td></tr><tr><td>兑换成功发币矿工费</td><td>chainFee</td><td>兑换成功发币矿工费</td><td>兑换成功发币矿工费</td></tr><tr><td>兑换类型</td><td>changeType</td><td>兑换类型</td><td>兑换类型</td></tr><tr><td>超过当日限额kyc路径</td><td>kycUrl</td><td>超过当日限额kyc路径</td><td>超过当日限额kyc路径</td></tr><tr><td><p>退币原因</p><p></p></td><td>refundReason</td><td><p>返回数字 对应下方信息 </p><p>1 流动性不足(默认) </p><p>2 误差超过阈值 </p><p>3 kyc超额 </p><p>4 地址黑名单 </p><p>5 目标币维护</p><p>6 兑换数量不在范围内 </p><p>7 存币超时 </p><p>8 与风险地址交互</p></td><td><p>返回数字 对应下方信息<br>1  流动性不足(默认)<br>2  误差超过阈值<br>3  kyc超额<br>4  地址黑名单<br>5  目标币维护</p><p>6  兑换数量不在范围内<br>7  存币超时<br>8 与风险地址交互</p></td></tr></tbody></table>

**6.入参注意事项**

<table data-header-hidden><thead><tr><th width="156">入参字段</th><th>说明</th></tr></thead><tbody><tr><td>入参字段</td><td>说明</td></tr><tr><td>equipmentNo</td><td>环境编号，这个可用于查询属于该编号的所有订单信息，请勿泄露,详细查询订单相关信息可以参见<code>queryAllTrade</code> 和 <code>queryOrderState</code>  接口</td></tr></tbody></table>

**7.Postman示例**

![](https://3392740180-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSTh_zo_IUKEGh-Qy-n-3765750170%2Fuploads%2FHmTTJDyeg4a55VzE4Vjv%2F1646913411\(4\).png?alt=media\&token=75698110-9743-421c-98b8-7920f98471a5)