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",
        "refundReason": ""
    },
    "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

Reasons for refund of coins

refundReason

String

Returns the information below corresponding to the number.

1 illiquidity (default). 2 Amount error

3 kyc excess.

4 address blacklist. 5 goal chain

maintenance

6 The amount of redemption is not within the range 7 Deposit timeout 8 Interacting with risky addresses

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",
          "burnRate": "0"
          "refundReason": ""
      },
      "resCode": "800",
      "resMsg": "成功"
  }

Last updated