查询下发子单列表
curl --request GET \
--url https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'import requests
url = "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query"
headers = {
"X-GatePay-Certificate-ClientId": "<x-gatepay-certificate-clientid>",
"X-GatePay-Signature": "<x-gatepay-signature>",
"X-GatePay-Timestamp": "<x-gatepay-timestamp>",
"X-GatePay-Nonce": "<x-gatepay-nonce>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-GatePay-Certificate-ClientId': '<x-gatepay-certificate-clientid>',
'X-GatePay-Signature': '<x-gatepay-signature>',
'X-GatePay-Timestamp': '<x-gatepay-timestamp>',
'X-GatePay-Nonce': '<x-gatepay-nonce>'
}
};
fetch('https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>",
"X-GatePay-Nonce: <x-gatepay-nonce>",
"X-GatePay-Signature: <x-gatepay-signature>",
"X-GatePay-Timestamp: <x-gatepay-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query")
.header("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
.header("X-GatePay-Signature", "<x-gatepay-signature>")
.header("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
.header("X-GatePay-Nonce", "<x-gatepay-nonce>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
req.Header.Add("X-GatePay-Signature", "<x-gatepay-signature>")
req.Header.Add("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
req.Header.Add("X-GatePay-Nonce", "<x-gatepay-nonce>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-GatePay-Certificate-ClientId"] = '<x-gatepay-certificate-clientid>'
request["X-GatePay-Signature"] = '<x-gatepay-signature>'
request["X-GatePay-Timestamp"] = '<x-gatepay-timestamp>'
request["X-GatePay-Nonce"] = '<x-gatepay-nonce>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"code": "000000",
"label": "",
"errorMessage": "",
"data": {
"merchant_id": 10002,
"total": 1,
"total_amount": "1",
"order_count": 1,
"user_count": 1,
"suborder_list": [
{
"create_time": 1726055848856,
"finish_time": 1726055856011,
"batch_id": "237394559478075350",
"merchant_withdraw_id": "M137394559478075550",
"suborder_id": "268830764354768896",
"withdraw_id": "268830764354768896",
"currency": "USDT",
"amount": "1",
"fee": "0",
"fee_type": 1,
"chain": "ETH",
"show_chain_name": "Ethereum",
"address": "0x1234567890abcdef",
"channel_id": "123456",
"desc": "",
"status": "DONE",
"pay_status": "DONE",
"pay_amount": "1",
"pay_time": 1726055856011,
"pay_account": "",
"done_amount": "1",
"memo": "",
"tx_id": "0xabc123",
"err_msg": "",
"from_address": "",
"settle_merchant_id": 10002
}
]
}
}对账
查询下发订单列表
按时间范围分页查询下发子单,支持按批次号、状态、审批状态等条件筛选。
GET
/
withdraw
/
open
/
v1
/
withdraw
/
suborder
/
query
查询下发子单列表
curl --request GET \
--url https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'import requests
url = "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query"
headers = {
"X-GatePay-Certificate-ClientId": "<x-gatepay-certificate-clientid>",
"X-GatePay-Signature": "<x-gatepay-signature>",
"X-GatePay-Timestamp": "<x-gatepay-timestamp>",
"X-GatePay-Nonce": "<x-gatepay-nonce>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-GatePay-Certificate-ClientId': '<x-gatepay-certificate-clientid>',
'X-GatePay-Signature': '<x-gatepay-signature>',
'X-GatePay-Timestamp': '<x-gatepay-timestamp>',
'X-GatePay-Nonce': '<x-gatepay-nonce>'
}
};
fetch('https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>",
"X-GatePay-Nonce: <x-gatepay-nonce>",
"X-GatePay-Signature: <x-gatepay-signature>",
"X-GatePay-Timestamp: <x-gatepay-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query")
.header("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
.header("X-GatePay-Signature", "<x-gatepay-signature>")
.header("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
.header("X-GatePay-Nonce", "<x-gatepay-nonce>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
req.Header.Add("X-GatePay-Signature", "<x-gatepay-signature>")
req.Header.Add("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
req.Header.Add("X-GatePay-Nonce", "<x-gatepay-nonce>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-GatePay-Certificate-ClientId"] = '<x-gatepay-certificate-clientid>'
request["X-GatePay-Signature"] = '<x-gatepay-signature>'
request["X-GatePay-Timestamp"] = '<x-gatepay-timestamp>'
request["X-GatePay-Nonce"] = '<x-gatepay-nonce>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"code": "000000",
"label": "",
"errorMessage": "",
"data": {
"merchant_id": 10002,
"total": 1,
"total_amount": "1",
"order_count": 1,
"user_count": 1,
"suborder_list": [
{
"create_time": 1726055848856,
"finish_time": 1726055856011,
"batch_id": "237394559478075350",
"merchant_withdraw_id": "M137394559478075550",
"suborder_id": "268830764354768896",
"withdraw_id": "268830764354768896",
"currency": "USDT",
"amount": "1",
"fee": "0",
"fee_type": 1,
"chain": "ETH",
"show_chain_name": "Ethereum",
"address": "0x1234567890abcdef",
"channel_id": "123456",
"desc": "",
"status": "DONE",
"pay_status": "DONE",
"pay_amount": "1",
"pay_time": 1726055856011,
"pay_account": "",
"done_amount": "1",
"memo": "",
"tx_id": "0xabc123",
"err_msg": "",
"from_address": "",
"settle_merchant_id": 10002
}
]
}
}概述
本页说明「查询下发子单列表」接口,完整的请求参数、响应结构与示例由关联的 OpenAPI 定义渲染。说明
请求头
应用 ClientId。
请求签名(HMAC-SHA512)。
请求时间戳(UTC 毫秒)。
随机数,用于防重放。
查询参数
页码,从 1 开始。
必填范围:
x >= 1每页条数,最大 500。
必填范围:
1 <= x <= 500查询起始时间(毫秒)。
查询结束时间(毫秒)。
子单状态筛选。可用取值:
INIT— 已创建PENDING— 待处理CHECK— 审核中PROCESSING— 处理中DONE— 下发成功FAIL— 下发失败
可用选项:
INIT, PENDING, CHECK, PROCESSING, DONE, FAIL 商户渠道 ID 筛选。
审批状态筛选。可用取值:
AUDITING— 审批中AUDIT_SUCCESS— 审批通过AUDIT_REJECT— 审批拒绝AUDIT_TIMEOUT— 审批超时
可用选项:
AUDITING, AUDIT_SUCCESS, AUDIT_REJECT, AUDIT_TIMEOUT ⌘I

