Check order status
- 1.Interface call:
https://{host}/api/v2/queryOrderState
2. Request parameter instance
parameter | whether | explain |
|---|---|---|
equipmentNo | Yes | Equipment unique number |
sourceType | Yes | eg：ANDROID,IOS,H5 |
orderId | Yes | eg：0eg：1fc8499f-dd6d-4ff3-8b7f-7a0d74c59adc |
3. Example of request parameters
{
"equipmentNo":"SFjeigreEIFegjieFei",
"sourceType":"H5",
"orderId":"9d4a577d-fdb1-466c-8da2-a5ad3553260b"
}
4.Example of returned results
{
"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",
"depositTxid": "",
"destinationAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",
"detailState": "wait_deposit_send",
"instantRate": "6.874588522739",
"isDiscount": "N",
"isNft": "",
"kycUrl": "",
"nftUrl": "",
"orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",
"orderState": "wait_deposits",
"payTokenUrl": "",
"platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",
"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"
},
"resCode": "800",
"resMsg": "success",
"resMsgEn": ""
}
5.Return Parameter Description
Field Name | field | data type | remarks |
|---|---|---|---|
orderId | orderId | String | eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a |
depositCoinCode | depositCoinCode | String | eg：ETH |
receiveCoinCode | receiveCoinCode | String | eg：BTC |
depositCoinAmt | depositCoinAmt | String | eg：1 |
receiveCoinAmt | receiveCoinAmt | String | eg：0.1 |
platformAddr | platformAddr | String | eg：123123123-232-1231232 |
destinationAddr | destinationAddr | String | "Eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY. If there are memos, please put them in the address and separate them with #, for example: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY # 1927632" |
refundAddr | refundAddr | String | "Eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY If there are memos, please separate them with # after placing them in the address, for example: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY # 1927632" |
depositCoinFeeRate | depositCoinFeeRate | String | Eg: Handling rate |
depositCoinFeeAmt | depositCoinFeeAmt | String | Eg: The amount of original currency charged for handling charges |
refundCoinAmt | refundCoinAmt | String | eg: 0.98 |
transactionId | transactionId | String | On chain transaction ID, this field will have a value only after the exchange is completed and the currency has been issued |
refundDepositTxid | refundDepositTxid | String | On chain transaction ID, this field will have a value only after the currency has been returned in case of exchange failure |
detailState | detailState | String | "(1) wait_deposit_send: waiting for the deposit currency to be sent; (2) timeout: timeout; (3) wait_exchange_push: waiting for the exchange information to be pushed; (4) wait_exchange_return: waiting for the exchange information to be returned; (5.1) wait_receive_send: waiting for the receipt currency to be sent; wait_receive_confirm: waiting for the receipt currency to be confirmed; receive_complete: waiting for the receipt currency to be confirmed. (5.2) wait_ refund_ Send: Wait for sending the returned original currency, wait_ refund_ Confirm: wait for confirmation of returning original currency, refresh_ Complete: Confirm the return of original currency; (6) ERROR/error: Processing order (7) WAIT_ KYC: Wait for KYC or contact customer service to provide a link“ |
dealReceiveCoinAmt | dealReceiveCoinAmt | String | The quantity obtained from the actual exchange. When the exchange is not completed, the value is an empty string |
completeTime | completeTime | String | Time when the order is issued or returned (UTC+8) |
burnRate | burnRate | String | Default 0 |
createTime | createTime | String | createTime |
Completion time | dealFinishTime | String | Completion time |
depositCoinState | depositCoinState | String | wait_send、wait_confirm:、already_confirm |
depositTxid | depositTxid | String | depositTxid |
swftAmt | receiveSwftAmt | String | swftAmt |
swftRate | swftCoinFeeRate | String | swftRate |
gas fee after the exchange is completed. | chainFee | String | gas fee after the exchange is completed. |
Exchange type | changeType | String | Exchange type |
Kyc path that exceeds the quota of the day | kycUrl | String | Kyc path that exceeds the quota of the day |
Parameter | Explanation |
equipmentNo | Environment number, this can be used to check numbers associted with all of the order's information, please do not disclose |
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n \"equipmentNo\": \"Zasdf352943090468518\",\n \n \"sourceType\": \"ANDROID\",\n\n \"orderId\": \"de752da3-0ff7-4682-8038-d8e1f20cad95\"\n}");
Request request = new Request.Builder()
.url("https://{host}/api/v2/queryOrderState")
.post(body)
.addHeader("Content-Type", "application/json")
.addHeader("cache-control", "no-cache")
.build();
Response response = client.newCall(request).execute();
var client = new RestClient("https://{host}/api/v2/queryOrderState");
var request = new RestRequest(Method.POST);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("undefined", "{\n \"equipmentNo\": \"Zasdf352943090468518\",\n \n \"sourceType\": \"ANDROID\",\n\n \"orderId\": \"de752da3-0ff7-4682-8038-d8e1f20cad95\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
#import <Foundation/Foundation.h>
NSDictionary *headers = @{ @"Content-Type": @"application/json",
@"cache-control": @"no-cache" };
NSDictionary *parameters = @{ @"equipmentNo": @"Zasdf352943090468518",
@"sourceType": @"ANDROID",
@"orderId": @"de752da3-0ff7-4682-8038-d8e1f20cad95" };
NSData *postData = [NSJSONSerialization dataWithJSONObject:parameters options:0 error:nil];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://{host}/api/v2/queryOrderState"]
cachePolicy:NSURLRequestUseProtocolCachePolicy
timeoutInterval:10.0];
[request setHTTPMethod:@"POST"];
[request setAllHTTPHeaderFields:headers];
[request setHTTPBody:postData];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
if (error) {
NSLog(@"%@", error);
} else {
NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
NSLog(@"%@", httpResponse);
}
}];
[dataTask resume];
//getToken example
import axios from 'axios'
const params = {
equipmentNo:"zfgryh918f93a19fdg6918a68cf5",
sourceType:"H5",
userNo:"",
sessionUuid:"",
orderId:"9d4a577d-fdb1-466c-8da2-a5ad3553260b",
sourceFlag:"widget"
}
const res = await axios.post('https://{host}/api/v2/queryOrderState', params )
console.log(res)
.png?alt=media&token=e7d09151-45f5-4add-a41e-636b046e2442)
{
"data": {
"changeType": "advanced",
"choiseFeeType": "3",
"dealReceiveCoinAmt": "10.513615",
"depositCoinAmt": "0.276",
"depositCoinCode": "ETH",
"depositCoinFeeAmt": "0.000276",
"depositCoinFeeRate": "0.001",
"depositCoinState": "already_confirm",
"destinationAddr": "loveqyw12345",
"detailState": "receive_complete",
"orderId": "de752da3-0ff7-4682-8038-d8e1f20cad95",
"orderState": "wait_send",
"platformAddr": "0x6e76d9e78b6f4878fbe83e6985185173373f0b7e",
"receiveCoinAmt": "10.403011",
"receiveCoinCode": "EOS",
"receiveSwftAmt": "14.06",
"refundAddr": "0x189547cb7984711c2ab25b1543a784e65628a8f6",
"refundCoinAmt": "",
"refundCoinMinerFee": "",
"refundDepositTxid": "",
"refundSwftAmt": "",
"swftCoinFeeRate": "0.0005",
"swftCoinState": "",
"swftReceiveAddr": "",
"swftRefundAddr": "",
"tradeState": "",
"transactionId": "072a7915ac9de0e64d5131afde8f61e1cdf0cf517ffa3f8db2f2d26bf208b658",
"burnRate": "0"
},
"resCode": "800",
"resMsg": "成功"
}
Business Reference Graph
Last modified 24d ago