跳转到主要内容
GET
/
v1
/
pay
/
address
/
query
查询支付单详情
curl --request GET \
  --url https://api.example.com/v1/pay/address/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>'
{
  "prepayId": "1661239048576446",
  "merchantId": 10002,
  "merchantTradeNo": "43959345943769874395",
  "transactionId": "347827943294834379",
  "goodsName": "abc",
  "fromAddress": "",
  "currency": "BTC",
  "orderAmount": "9.88",
  "payCurrency": "USDT",
  "payAmount": "197600",
  "surchargeAmount": "",
  "fiatCurrency": "",
  "fiatAmount": "",
  "fiatRate": "",
  "rate": "20000",
  "status": "PENDING",
  "createTime": 1663657128148,
  "expireTime": 1664089128000,
  "transactTime": 1663829928000,
  "order_name": "orderName",
  "transaction_info": {
    "done_amount": "10.11",
    "done_amount_total": "10.11",
    "confirming_list": [
      {
        "amount": "0.35",
        "confirm": 3
      },
      {
        "amount": "0.65",
        "confirm": 4
      }
    ],
    "done_tx_item_list": [
      {
        "chain": "BSC",
        "address": "0x5E86088F084dD253fBd6d5ad955af6f53EFC8073",
        "fullCurrType": "USDT_BSC",
        "amount": "10.11",
        "txId": "D1758212402891",
        "utcCreateTime": "2025-09-18 08:20:03",
        "utcUpdateTime": "2025-09-18 08:20:03",
        "fromAddress": "LHDwcMPVPXXvrmSlRVeEcxsLUCvtThHLa"
      }
    ],
    "confirming_tx_item_list": [
      {
        "chain": "BSC",
        "address": "0x5E86088F084dD253fBd6d5ad955af6f53EFC8022",
        "fullCurrType": "USDT_BSC",
        "amount": "10.11",
        "txId": "D1758212402811",
        "utcCreateTime": "2025-09-18 08:20:03",
        "utcUpdateTime": "2025-09-18 08:20:03",
        "fromAddress": "LHDwcMPVPXXvrmSlRVeEcxsLUCvtThHLa"
      }
    ]
  },
  "channelId": "123456",
  "chain": "ETN",
  "address": "0x67C30f439D7734f393c2F4a587B198b8F4086Ccb"
}
API描述:查新地址支付单详情,指定的参数必须对应到地址支付单,否则会返回错误

请求头

X-GatePay-Certificate-ClientId
string
必填

商户客户端ID

示例:

"4186d0c6-6a35-55a9-8dc6-5312769dbff8"

X-GatePay-Signature
string
必填

签名

示例:

"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8"

X-GatePay-Timestamp
string
必填

时间戳(毫秒)

示例:

"1672905655498"

X-GatePay-Nonce
string
必填

随机数

示例:

"9578"

查询参数

prepayId
string
必填

地址支付预支付单id

merchantTradeNo
string
必填

商户系统交易号

响应

200 - application/json

成功响应

prepayId
string

支付单单号

merchantId
integer

用于申请商户账号的Gate UID

merchantTradeNo
string

商户系统交易号

transactionId
string

交易流水号

goodsName
string

商品名,商户创建订单时提供

currency
string

订单币种

orderAmount
string

订单金额

surchargeAmount
string

手续费金额

toleranceAmount
string

容差金额:当订单剩余未付金额 ≤ 设置的容差金额时,系统将自动视为支付成功,无需用户额外补款。

underpaidAmount
string

支付完成后,剩余支付金额

fiatCurrency
string

法币订单币种

fiatAmount
string

法币订单金额

fiatRate
string

法币-加密货币汇率

payCurrency
string

用户实际支付币种,非闪兑单中与订单币种一致

payAmount
string

应支付金额

rate
string

订单币种到用户支付币种的汇率,例如,1BTC换20000USDT

status
string

订单状态,PENDING处理中,PROCESS订单有效期内支付足够金额但链上未确认完毕,PAID订单支付成功,EXPIRED订单已过期

createTime
integer

创建时间

expireTime
integer

过期时间

transactTime
integer

订单在Gate内部交易发生时间

order_name
integer

订单名称

channelId
integer

客户名称

chain
string

address
string

网络

fromAddress
string

付款方地址

transaction_info
object