跳转到主要内容
GET
/
withdraw
/
open
/
v1
/
withdraw
/
suborder
/
query
查询下发子单列表
curl --request GET \
  --url https://openplatform.gateapi.io/withdraw/open/v1/withdraw/suborder/query \
  --header 'X-GatePay-ClientId: <x-gatepay-clientid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'
{
  "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
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gate.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

本页说明「查询下发子单列表」接口，完整的请求参数、响应结构与示例由关联的 OpenAPI 定义渲染。

​
说明

  • 认证方式使用 GatePay 标准签名请求头。
  • 常用于对账兜底与审计追溯；建议与出款回调配合，列表查询作为互补手段。
  • 通用签名规则见 安全与签名；接入步骤见 对账指引。

请求头

​
X-GatePay-ClientId
string
必填

应用 ClientId。

​
X-GatePay-Signature
string
必填

请求签名（HMAC-SHA512）。

​
X-GatePay-Timestamp
string
必填

请求时间戳（UTC 毫秒）。

​
X-GatePay-Nonce
string
必填

随机数，用于防重放。

查询参数

​
page
integer
必填

页码，从 1 开始。

必填范围: x >= 1
​
count
integer
必填

每页条数，最大 500。

必填范围: 1 <= x <= 500
​
start_time
integer<int64>
必填

查询起始时间（毫秒）。

​
end_time
integer<int64>
必填

查询结束时间（毫秒）。

​
status
string

子单状态筛选。常见取值包括 CREATED、PENDING、UNDER_REVIEW、PROCESSING、PAYOUT_SUCCESS、PAYOUT_FAIL。

​
channel_id
string

商户渠道 ID 筛选。

​
audit_status
enum<string>

审批状态筛选。可用取值：

  • AUDITING — 审批中
  • AUDIT_SUCCESS — 审批通过
  • AUDIT_REJECT — 审批拒绝
  • AUDIT_TIMEOUT — 审批超时
可用选项:
AUDITING,
AUDIT_SUCCESS,
AUDIT_REJECT,
AUDIT_TIMEOUT

响应

200 - application/json

下发子单列表

​
status
string

接口状态，SUCCESS 表示成功。

​
code
string

业务响应码，000000 表示成功。

​
label
string

响应标签。

​
errorMessage
string

失败时的错误描述。

​
data
object