Gate Pay 常見問題 ｜ Gate

常見問題解答

訂單金額限制

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://docs.gate.com/api-reference/version/100/cn/endpoint/withdraw/withdrawStatus

說明

調用「提現手續費查詢」這個接口，會返回幣種支持鏈所需的手續費。用戶可根據需要選擇合適的鏈。
參考下面這兩個參數：

手續費參數

「withdraw_fix_on_chains」為固定手續費，「withdraw_percent_on_chains」為百分比提現手續費（部分特殊幣種提現時需用提現數量 x 此百分比）

計算方式

提現手續費即為這兩部分相加：固定費用 + 百分比費率 * 提現數量

其他注意事項

目前常用的鏈基本上只有固定費用（此固定費用每小時更新一次）
建議每次提現時，都需調用此接口確認手續費。手續費每小時更新。

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

支付時間以鏈上偵測到該筆交易的時間為準，不以用戶實際操作時間為準，中間會有時間差。

為什麼 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 以確認最終到帳總額。）

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

免責聲明

本文內容僅供參考與學習目的，不構成任何金融、投資、交易或法律建議，也不構成購買或出售任何虛擬資產的要約或邀請。Gate 對文中資訊的準確性、完整性或時效性不作任何明示或暗示的保證。產品功能、介面、規則及費率等資訊可能隨時更新或調整，請以 Gate 平台的最新公告及實際頁面展示為準。

虛擬資產投資涉及高風險，價格可能出現大幅波動，您可能損失全部投入資金。請在充分了解相關風險的基礎上，根據自身財務狀況和風險承受能力謹慎決策。如有需要，建議您諮詢獨立的專業財務或法律顧問。

有關更多風險資訊，請參閱 Gate《風險警示》及《用戶協議》。