跳转到主要内容
GET
/
open
/
otc
/
api
/
recharge
/
list
查询 OTC 入金订单列表
curl --request GET \
  --url https://openplatform.gateapi.io/open/otc/api/recharge/list \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-MerchantId: <x-gatepay-merchantid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'
{
  "code": "<string>",
  "status": "<string>",
  "errorMessage": "<string>",
  "data": {
    "total": 123,
    "page": 123,
    "list": [
      {
        "orderId": "<string>",
        "otcOrderId": "<string>",
        "currency": "<string>",
        "amount": "<string>",
        "fiatCurrency": "<string>",
        "fiatAmount": "<string>",
        "cfRate": "<string>",
        "bankId": "<string>",
        "bankNumber": "<string>",
        "paid": true,
        "status": "<string>",
        "card_info": {
          "id": 123,
          "uid": 123,
          "entity": "<string>",
          "bank_account_name": "<string>",
          "bank_name": "<string>",
          "bank_country": "<string>",
          "bank_address": "<string>",
          "bank_code": "<string>",
          "branch_code": "<string>",
          "iban": "<string>",
          "swift": "<string>",
          "remittance_line_number": "<string>",
          "agent_bank_name": "<string>",
          "agent_bank_swift": "<string>",
          "transferRemark": "<string>",
          "memo": "<string>",
          "is_default": true,
          "bank_id": "<string>"
        },
        "createTime": 123,
        "promoCode": "<string>",
        "transferRemark": "<string>",
        "paymentReceiptFileUrl": "<string>"
      }
    ]
  }
}

概述

本页说明 GET /open/otc/api/recharge/list 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

说明

请求头

X-GatePay-Certificate-ClientId
string
必填

用于标识调用应用的商户应用 ClientId。

X-GatePay-Signature
string
必填

按 GatePay 签名规则生成的 HMAC 签名。

X-GatePay-Timestamp
string
必填

用于防重放和验签的 Unix 时间戳。

X-GatePay-Nonce
string
必填

与时间戳配合使用的随机串,用于防止重放攻击。

X-GatePay-MerchantId
integer<int64>
必填

商户 ID。

查询参数

status
enum<string>

按订单状态筛选。

可用选项:
PENDING,
PROCESSING,
DONE,
CANCEL,
ERROR
startTime
integer<int64>
必填

查询时间范围起点(毫秒时间戳)。必填。

endTime
integer<int64>
必填

查询时间范围终点(毫秒时间戳)。必填。

page
integer<int64>

页码。-1 表示不分页获取全部记录。

count
integer<int64>

每页记录数。page >= 0 时必填,最大 1000。

响应

200 - application/json

成功

code
string

业务响应码。

status
string

请求顶层状态。

errorMessage
string

请求失败时的错误信息。

data
object