Links

Check order status

  1. 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": ""
},
"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)

Request Parameter Precautions

Parameter
Explanation
equipmentNo
Environment number, this can be used to check numbers associted with all of the order's information, please do not disclose

Code Example

java code example

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();

C# code example

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);

Objective-C code example

#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];

Nodejs code example

//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)

​Postman example

Response result example

{
"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"
},
"resCode": "800",
"resMsg": "成功"
}
For a detailed explanation, please seed the Google Document
Business Reference Graph