Gate Pay 常見問題

常見問題解答

訂單金額限制

1. 最小金額限制： Gate支付：0.0001 （所有貨幣單位） Web3鏈上支付：0.01 USDT（或等價值其他幣種） 閃兌最小金額：查詢幣種對接口會返回最大最小值

訂單金額必須不低於設定的最小金額。例如，若最小金額限制爲 0.0001，則訂單金額 ≥ 0.0001 即可，如 0.0001、0.00011 等。

2. 精度限制： 訂單金額的小數位數不得超過設定的精度。例如，若精度設定爲 0.0001（即最多 4 位小數），則 0.001 是有效的，而 0.00011 會報錯，不會進行四舍五入。

訂單金額需同時滿足最小金額和精度兩項要求，否則無法提交。例如：若最小金額限制爲 0.0001，精度限制爲 0.1，則 0.01 仍不符合精度要求，會報錯。

提現手續費說明

查詢提現狀態 API

https://www.gate.com/docs/developers/apiv4/zh_CN/#%E6%9F%A5%E8%AF%A2%E6%8F%90%E7%8E%B0%E7%8A%B6%E6%80%81

說明

調用 “查詢提現狀態” 接口可獲取不同幣種在各支持鏈上的提現手續費信息，用戶可根據需要選擇合適的鏈。

手續費參數

withdraw_fix_on_chains：固定提現手續費 withdraw_percent_on_chains：百分比提現手續費（部分特殊幣種適用，計算方式爲提現金額 × 該百分比）

計算方式

提現手續費 = 固定費用 + (百分比費率 × 提現數量)

其他注意事項

目前大多數常用鏈僅收取固定手續費，該費用每小時更新。 建議在每次提現前調用該接口，以獲取最新手續費數據，確保計算準確。

爲什麼用戶在有效期內支付，但被判定爲過期訂單？

支付時間以鏈上檢測到這筆交易時間爲準，不是以用戶實際操作時間爲準，中間會有時間差。

爲什麼 Gate APP 或 Web 端帳單情況與實際收單情況不一致？

App 或 Web 端內展示的帳單顯示的是訂單金額，不是實際用戶支付的金額。即使用戶支付的金額與訂單金額不一致，也會顯示訂單金額。查看帳單詳情，必須以商戶後臺的數據爲準。

創建訂單 API 中 merchantTradeNo 和 merchantUserId 的含義

merchantTradeNo：商戶側系統的訂單號，不超過 32 個字符。
merchantUserId：商戶側用戶的帳號 ID。必須是一個存在的用戶 ID，否則在地址支付退款時無法識別支付用戶。

關於地址支付的回調信息

爲什麼支付回調信息有兩條？

資金到帳通知（TRANSFER_ADDRESS）：實際到帳金額的通知。
訂單狀態變更通知（PAY_ADDRESS）：訂單狀態的變更通知。

商戶需要結合這兩類信息判斷訂單是否成功，以便執行發貨或處理失敗訂單。

回調信息發送時間點

資金到帳通知 鏈上確認支付成功後，爲商戶實時入帳資金，同時回調給商戶。
訂單狀態變更通知 訂單狀態發生變化時觸發。

回調信息狀態解讀

1. 資金到帳通知（biztype = TRANSFER_ADDRESS）

TRANSFERRED_ADDRESS_IN_TERM：訂單有效期內即時到帳。
TRANSFERRED_ADDRESS_DELAY：超過有效期的支付到帳，將實際支付對應金額充值到商戶支付帳戶中（超過有效期即時到帳）。
TRANSFERRED_ADDRESS_BLOCK：交易存在安全風險，拒收，需要聯繫Gate Pay客戶經理原路退回資金。

2. 訂單狀態變更通知（biztype = PAY_ADDRESS）

PAY_SUCCESS：支付成功。
PAY_CLOSE：訂單過期。
PAY_EXPIRED_IN_PROCESS：等待鏈上確認資金。

地址支付的支付場景及訂單狀態判斷

1. 有效期內一次性足額或超額支付

描述： 在訂單有效期內，只要足額或者超額支付，待鏈上確認資金後，就會實時發送回調信息。
訂單狀態 ：首先等待鏈上確認資金，回調一個中間態：bizStatus 爲 PAY_EXPIRED_IN_PROCESS。等待鏈上確認資金後，訂單成功，回調bizStatus 爲 PAY_SUCCESS，到帳金額爲doneAmountOnChain
資金到帳通知 ：bizStatus 爲 TRANSFERRED_ADDRESS_IN_TERM，到帳金額爲 transferAmount。

2. 有效期內未足額支付

描述：用戶在訂單有效期內支付不足訂單金額的，待鏈上確認資金後，給商戶入帳用戶實際支付的金額，並實時發送資金到帳的回調信息。
訂單狀態 ：有效期內，此時訂單狀態沒有發生變化，不發送訂單狀態的回調信息。
資金到帳通知 ：bizStatus 爲 TRANSFERRED_ADDRESS_IN_TERM，到帳金額爲 transferAmount。

3.有效期內未足額支付，且未補足

描述：用戶在訂單有效期內支付不足訂單金額，且在有效期內沒有補足。
訂單狀態 ：訂單有效期結束的時候，發送訂單狀態的回調。bizStatus爲PAY_CLOSE，到帳金額爲doneAmountOnChain。
資金到帳通知 ：用戶支付完成後，已經實時回調，不再重復發送。

4. 有效期內未足額支付，但已補足 4.1 有效期內補足金額：

用戶補足剩餘金額後 ：
訂單狀態 ：此時等待鏈上確認資金，回調一個中間態：bizStatus 爲 PAY_EXPIRED_IN_PROCESS。
資金到帳通知 ：等待鏈上確認補足的資金，所以不發送資金到帳通知。
鏈上確認成功後 ：
訂單狀態 ：等鏈上資金確認完畢，金額足夠，此時訂單才算成功，bizStatus 爲 PAY_SUCCESS，到帳金額爲doneAmountOnChain （此時爲所有支付的匯總金額）。
資金到帳通知 ：bizStatus 爲 TRANSFERRED_ADDRESS_IN_TERM，到帳金額爲 transferAmount。

4.2 有效期外補足金額：

訂單狀態 ：因檢測到有效期內沒有足額支付，在訂單有效期結束的時候，會先發送訂單狀態的回調。bizStatus爲PAY_CLOSE，到帳金額爲doneAmountOnChain。
資金到帳通知 ：用戶支付完成後，已經實時回調，不再重復發送。
用戶有效期外補足剩餘金額後 ：會發送資金到帳的回調，bizStatus 爲 TRANSFERRED_ADDRESS_DELAY，到帳金額爲 transferAmount。 (此種情況下不會額外發送訂單狀態的回調，最終回調信息中不包含 doneAmountOnChain 字段。如用戶使用多筆交易完成支付，商戶需自行累加所有回調中的 transferAmount 以確認最終到帳總額。)

5. 過期支付

描述：用戶在訂單有效期外支付，不管是部分還是足額，亦或是超額支付，鏈上確認成功後，會實時到帳。
訂單狀態變 ：因爲有效期內沒有支付任何金額，在訂單有效期結束的時候，會回調bizStatus 爲 PAY_CLOSE。
資金到帳 ：無資金到帳通知。
過期後支付： 過期後支付一筆，回調一筆資金到帳的通知，bizStatus 爲 TRANSFERRED_ADDRESS_DELAY，到帳金額爲 transferAmount。 (此種情況下不會額外發送訂單狀態的回調，最終回調信息中不包含 doneAmountOnChain 字段。如用戶使用多筆交易完成支付，商戶需自行累加所有回調中的 transferAmount 以確認最終到帳總額。)

商戶需要根據 訂單狀態和資金到帳 兩條回調信息判斷訂單是否成功。