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/gatepay/withdraw/zh_CN/#_3-5-%E6%8F%90%E7%8E%B0%E6%89%8B%E7%BB%AD%E8%B4%B9%E6%9F%A5%E8%AF%A2

說明

呼叫「提現手續費查詢」這個介面，會回傳該幣種在各個支援鏈上所需的手續費。使用者可依需求選擇合適的鏈。

請參考以下兩個參數：

手續費參數

• withdraw_fix_on_chains ：固定提現手續費
• withdraw_percent_on_chains ：百分比提現手續費
  （部分特殊幣種提現時，需要使用「提現數量 × 該百分比」來計算）

計算方式

提現手續費為以下兩部分之和：
固定費用 +（百分比費率 × 提現數量）

其他注意事項

目前常用的鏈基本上僅收取固定費用

（此固定費用每小時更新一次）。

建議每次提現時都呼叫此介面以確認最新手續費，因為手續費會每小時更新。

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

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

為什麼 Gate APP 與商戶後台的帳單收支情況不一致

Gate Pay 商戶後台所顯示的帳單資訊，對應的是 商戶餘額帳戶
（此帳戶僅限已註冊 Gate Pay 的商戶使用），主要用於商戶收款與資金下發操作。

Gate APP 則是 Gate 交易所的 個人帳戶 。

由於 商戶餘額帳戶 與 個人帳戶 彼此獨立，兩者之間的資金與帳單資訊不互通，因此在 Gate APP 或 Web 端所看到的帳單情況，可能與實際收單情況存在差異。

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

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

關於地址支付的回調信息

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

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

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

回調信息發送時間點

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

回調信息狀態解讀

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 以確認最終到帳總額。)

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