Gate Pay 回調通知API文件：https://docs.gate.com/api-reference/version/100/cn/common/asyncNotification
支付回調資訊狀態解讀
動態地址類
1.動態地址支付資金到帳通知（biztype = TRANSFER_ADDRESS）
TRANSFERRED_ADDRESS_IN_TERM：訂單有效期內即時到帳。
TRANSFERRED_ADDRESS_DELAY：超過有效期的支付到帳，將實際支付的金額充值到商戶餘額帳戶中（超過有效期即時到帳）。
2.動態地址支付訂單狀態變更通知（biztype = PAY_ADDRESS）
PAY_SUCCESS：支付成功。
PAY_CLOSE：訂單過期。
PAY_EXPIRED_IN_PROCESS：等待鏈上確認資金。
靜態地址類
1.靜態地址收款成功（biztype=PAY_FIXED_ADDRESS）
PAY_SUCCESS：支付成功，且到帳
2.靜態地址被判定為風險地址（biztype=FIXED_ADDRESS_RISK）
RISK_ADDRESS：靜態地址被標記為風險地址
異常地址支付類
每產生一筆異常支付流水，Gate Pay 會向對應商戶發送一次 webhook 通知。
該類型支付 bizType 固定為 PAY_UNRESOLVED。
客戶需根據 data 裡的 errorType 判斷帳單問題，並參照 Gate Pay 異常支付處理指引 處理或聯繫 Gate Pay 客戶經理。
- address_risk_address
— 動態地址高風險地址 - address_error_currency
— 動態地址錯誤的幣種 - address_error_chain
— 動態地址錯誤的區塊鏈網路 - fix_error_currency
— 固定地址錯誤的幣種 - fix_error_chain
— 固定地址錯誤的區塊鏈網路 - fix_risk_address
— 固定地址高風險地址 - fix_delete
— 固定地址刪除 - fix_partial_delete
— 固定地址部分刪除
關於動態地址支付的回調資訊
為什麼支付回調資訊有兩種？
1.資金到帳通知（TRANSFER_ADDRESS）：實際到帳金額的通知。
2.訂單狀態變更通知（PAY_ADDRESS）：訂單狀態的變更通知。
商戶需結合這兩類資訊判斷訂單是否成功，以便執行發貨或處理失敗訂單。
回調資訊發送時間點
1.資金到帳通知：鏈上確認支付成功後，為商戶即時入帳資金，同時回調給商戶。
2.訂單狀態變更通知：訂單狀態發生變化時觸發。
動態地址支付的支付場景及訂單狀態判斷
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 以確認最終到帳總額。）
商戶需根據訂單狀態和資金到帳兩條回調資訊判斷訂單是否成功。
6.動態地址支付異常訂單回調資訊
6.1 支付了與訂單不一致的幣種或區塊鏈網路
商戶將收到 Biztype=PAY_UNRESOLVED；
且 data.errorType=address_error_currency；address_error_chain 的回調資訊。
6.2 資金有風險被攔截
商戶將收到 biztype=PAY_UNRESOLVED；
且 data.errorType=address_risk_address。
關於靜態地址的回調資訊
1.成功支付入帳
將會收到 PAY_SUCCES 的通知，表示支付成功，且到帳。
2.異常支付回調
2.1.支付了與訂單不一致的幣種/網路
商戶將收到 biztype=PAY_UNRESOLVED；且 data.errorType=fix_error_currency；fix_error_chain 的回調資訊
2.2 風險資金
商戶將收到 biztype=PAY_UNRESOLVED；且 data.errorType=fix_risk_address 的回調資訊。
2.3 支付到被刪除的靜態地址
商戶將收到 biztype=PAY_UNRESOLVED；且 data.errorType=fix_delete 或 fix_partial_delete
3.靜態地址風險通知
將會收到 bizType=FIXED_ADDRESS_RISK，bizStatus=RISK_ADDRESS，表示當商戶綁定的靜態收款地址被識別為風險地址。商戶應立即刪除對應的靜態地址。若用戶後續繼續往該地址付款，資金將不會入帳。
免責聲明
本文內容僅供參考與學習目的，不構成任何金融、投資、交易或法律建議，也不構成購買或出售任何虛擬資產的要約或邀請。Gate 對文中資訊的準確性、完整性或時效性不作任何明示或暗示的保證。產品功能、介面、規則及費率等資訊可能隨時更新或調整，請以 Gate 平台的最新公告及實際頁面展示為準。
虛擬資產投資涉及高風險，價格可能出現大幅波動，您可能損失全部投入資金。請在充分了解相關風險的基礎上，根據自身財務狀況和風險承受能力謹慎決策。如有需要，建議您諮詢獨立的專業財務或法律顧問。
有關更多風險資訊，請參閱 Gate《風險警示》及《用戶協議》。
