> ## 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 标准签名请求头。 * 常用于日终对账、报表同步；建议与支付回调配合，列表查询可作为兜底数据源。 * 通用签名规则见 [安全与签名](/api-reference/version/100/cn/common/securityAndSignature)；接入步骤见 [对账指引](/essentials/version/100/cn/common/reconciliation)。 ## OpenAPI ````yaml api-reference/version/100/cn/openapi/reconciliation-openapi.json GET /payment/open/v1/pay/order/list openapi: 3.1.0 info: title: GatePay 对账 API version: 1.0.0 description: GatePay 对账订单列表相关 OpenAPI 定义。 servers: - url: https://openplatform.gateapi.io description: 生产环境 security: [] paths: /payment/open/v1/pay/order/list: get: tags: - reconciliation summary: 查询收款订单列表 description: 按时间范围分页查询收款订单，支持按订单类型、状态、支付方式等条件筛选。 operationId: listReconciliationPayOrders parameters: - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId' - $ref: '#/components/parameters/X-GatePay-Signature' - $ref: '#/components/parameters/X-GatePay-Timestamp' - $ref: '#/components/parameters/X-GatePay-Nonce' requestBody: required: true content: multipart/form-data: schema: $ref: '#/components/schemas/PayOrderListRequest' responses: '200': description: 收款订单列表 content: application/json: schema: $ref: '#/components/schemas/ReconciliationPayOrderListResponse' examples: success: summary: 成功响应 value: status: SUCCESS code: '000000' label: '' errorMessage: '' data: Total: 1 orderList: - refund_info: canRefund: false refundSuccessAmount: '0' refundProcessAmount: '0' refundSuccessTimes: 0 refundFailTimes: 0 refundCurrency: USDT canNotRefundReason: '' totalRequestAmount: '0' totalRequestCurrency: USDT existRefund: false create_time: 1766470410668 pay_type: '' is_refund: false refund_amount: 0 refund_currency: '' settleMerchantId: 10002 orderType: '' merchantTradeNo: M202405290001 orderId: '63546113486749696' goodsName: '' orderCurrency: USDT orderAmount: 100 payCurrency: USDT payAmount: 100 surchargeAmount: 0 payableAmount: 100 receiveCurrency: USDT receiveAmount: 100 addressPayAmount: currency: USDT inTerm: 0 outTerm: 0 generalizedStatus: PAY_SUCCESS payChannel: gate billType: 0 chain: '' orderTime: 1766474310668 clientId: '' channelId: '123456' fromAddress: '' settleCurrency: USDT platFeeAmount: 0 merchantSettleAmount: 100 fiatCurrency: '' fiatAmount: '' fiatRate: '' refundTime: 0 failReason: '' buyer: '' uid: '' fundStatus: '' newPayType: gate address: '' status: '' institutionFeeAmount: 0 hashes: '' originalOrderId: '' originMerchantTradeNo: '' components: parameters: X-GatePay-Certificate-ClientId: name: X-GatePay-Certificate-ClientId in: header required: true description: 应用 ClientId。 schema: type: string X-GatePay-Signature: name: X-GatePay-Signature in: header required: true description: 请求签名（HMAC-SHA512）。 schema: type: string X-GatePay-Timestamp: name: X-GatePay-Timestamp in: header required: true description: 请求时间戳（UTC 毫秒）。 schema: type: string X-GatePay-Nonce: name: X-GatePay-Nonce in: header required: true description: 随机数，用于防重放。 schema: type: string schemas: PayOrderListRequest: type: object description: 收款订单列表查询条件（multipart 表单字段）。 properties: startTime: type: string description: 查询起始时间（毫秒）。 endTime: type: string description: 查询结束时间（毫秒）。 status: type: string description: |- 订单状态筛选。可用取值： - `PENDING` — 待支付 - `PAID` — 支付成功 - `ERROR` — 支付失败 - `PROCESS` — 支付中 - `EXPIRED` — 已过期 - `CANCELLED` — 已取消 - `BLOCK` — 支付异常 enum: - PENDING - PAID - ERROR - PROCESS - EXPIRED - CANCELLED - BLOCK payChannel: type: string description: |- 支付方式筛选。可用取值： - `GatePay` — Gate 支付 - `Web3Pay` — Web3 支付 - `FiatPay` — 法币支付 enum: - GatePay - Web3Pay - FiatPay payType: type: string description: |- 交易类型筛选。可用取值： - `checkout_pt` — 收银台支付 - `address_pt` — 地址支付 - `call_pt` — 调起 App 支付 - `qrcode_pt` — 扫码支付 - `web_pt` — Web 端支付 - `mini_pt` — GateLife 支付 - `payee_pt` — 静态收款码 - `agent_address_pt` — AI 支付 - `qrcode_ch` — 渠道扫码支付 - `bank_ch` — 银行转账支付 - `subscription_address_pt` — 订阅支付 - `invoicing_pt` — 账单支付 enum: - checkout_pt - address_pt - call_pt - qrcode_pt - web_pt - mini_pt - payee_pt - agent_address_pt - qrcode_ch - bank_ch - subscription_address_pt - invoicing_pt page: type: string description: 页码，从 1 开始。 count: type: string description: 每页条数，最大 500。 required: - startTime - endTime ReconciliationPayOrderListResponse: type: object properties: status: type: string description: 接口状态，`SUCCESS` 表示成功。 code: type: string description: 业务响应码，`000000` 表示成功。 label: type: string description: 响应标签。 errorMessage: type: string description: 失败时的错误描述。 data: $ref: '#/components/schemas/ReconciliationPayOrderListData' ReconciliationPayOrderListData: type: object properties: Total: type: integer format: int64 description: 符合条件的订单总数。 orderList: type: array description: 当前页收款订单列表。 items: $ref: '#/components/schemas/ReconciliationPayOrderItem' ReconciliationPayOrderItem: type: object description: 收款订单列表项。 properties: refund_info: $ref: '#/components/schemas/ReconciliationPayOrderRefundInfo' create_time: type: integer format: int64 description: 订单创建时间（毫秒）。 pay_type: type: string description: 交易类型。 is_refund: type: boolean description: 是否存在退款。 refund_amount: type: number description: 退款金额。 refund_currency: type: string description: 退款币种。 settleMerchantId: type: integer format: int64 description: 结算商户 ID。 orderType: type: string description: 订单类型。 merchantTradeNo: type: string description: 商户订单号。 orderId: type: string description: GatePay 订单号。 goodsName: type: string description: 商品名称。 orderCurrency: type: string description: 订单币种。 orderAmount: type: number description: 订单金额。 payCurrency: type: string description: 支付币种。 payAmount: type: number description: 实付金额。 surchargeAmount: type: number description: 附加费/手续费金额。 payableAmount: type: number description: 应付金额。 receiveCurrency: type: string description: 结算到账币种。 receiveAmount: type: number description: 结算到账金额。 addressPayAmount: $ref: '#/components/schemas/ReconciliationPayOrderAddressPayAmount' generalizedStatus: type: string description: 对外展示的订单状态。 payChannel: type: string description: 支付方式。 billType: type: integer description: 账单类型编码。 chain: type: string description: 地址支付对应的链。 orderTime: type: integer format: int64 description: 最近支付时间（毫秒）。 clientId: type: string description: ClientId。 channelId: type: string description: 商户渠道 ID。 fromAddress: type: string description: 付款链上地址。 settleCurrency: type: string description: 结算币种。 platFeeAmount: type: number description: 平台手续费。 merchantSettleAmount: type: number description: 商户结算金额。 fiatCurrency: type: string description: 法币展示币种。 fiatAmount: type: string description: 法币展示金额。 fiatRate: type: string description: 法币汇率。 refundTime: type: integer format: int64 description: 最近退款时间（毫秒）。 failReason: type: string description: 失败原因。 buyer: type: string description: 买家 Gate UID 或付款地址。 uid: type: string description: 买家 UID。 fundStatus: type: string description: 资金状态。 newPayType: type: string description: 支付分类，如 `web3`、`gate`、`unknown`。 address: type: string description: 收款地址。 status: type: string description: 内部订单状态。 institutionFeeAmount: type: number description: 机构手续费。 hashes: type: string description: Web3 支付链上交易哈希。 originalOrderId: type: string description: 关联原订单号。 originMerchantTradeNo: type: string description: 关联原商户订单号。 ReconciliationPayOrderRefundInfo: type: object description: 订单退款汇总信息。 properties: canRefund: type: boolean description: 是否可退款。 refundSuccessAmount: type: string description: 已成功退款总金额。 refundProcessAmount: type: string description: 处理中退款金额。 refundSuccessTimes: type: integer description: 成功退款次数。 refundFailTimes: type: integer description: 失败退款次数。 refundCurrency: type: string description: 退款币种。 canNotRefundReason: type: string description: 不可退款原因。 totalRequestAmount: type: string description: 申请退款总金额。 totalRequestCurrency: type: string description: 申请退款币种。 existRefund: type: boolean description: 是否存在退款记录。 ReconciliationPayOrderAddressPayAmount: type: object description: 地址支付的链上金额明细。 properties: currency: type: string description: 币种。 inTerm: type: number description: 有效期内支付金额。 outTerm: type: number description: 有效期外支付金额。 ````