提款/提幣 (payout)
用於傳送加密貨幣交易。
Last updated
Was this helpful?
用於傳送加密貨幣交易。
Last updated
Was this helpful?
確保地址格式正確,並符合網路。
金額必須是字串 (string),並應使用標準貨幣單位。例如:ETH (而非 WEI) 和 TRX (而非 SUN)
代幣是可選的,僅在發送令牌時使用。例如:USDT
在 Tron 上為 user123
傳送 100 USDT 到 TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU
如果交易成功,則返回 交易哈希值。否則返回錯誤代碼。
注意: l2Txnhash
(「L2-hash」) 應該永遠用作交易的唯一識別碼 (identifier)。這是 上任何交易的唯一交易哈希值 (transaction-hash)。它存在於已確認的存款和待定/已確認的付款中。這對於交易尤其重要,因為第二層交易沒有第一層哈希值 (txHash)
函式 (functions) 回調的預期錯誤有:
您沒有足夠的資金完成交易。請重新檢查您的餘額。
通常表示您做錯了什麼。例如,在未向 AP 建立或加入帳號的情況下嘗試發送。也可能表示 AP 在嘗試協調交易時發生了意料之外的問題。這種情況應該很少發生。檢查您的詳細資料,快速重試,如果找不到解決方案,請聯絡客戶服務。
如果在Akashicpay.com上註冊了支付的回調 URL,您將收到一個 HTTP 呼叫到該 URL,正文如下:
注意:如果對回調的回應狀態代碼 (status code) >= 400,則回調最多會重試 15 次,延遲時間從第一次嘗試開始計算,最多可延遲 10 小時左右。
提款時,有幾種不同的費用。這些是:
Akashic 費用 (回調中的 internalFee.withdraw
),總是與交易貨幣相同。例如,ETH 轉帳用 ETH,USDT 轉帳用 USDT,等等。除非發生「費用代付」,否則通常為 0,請參閱下文。
利用這一點,我們可以計算使用者花費的總金額(假設上圖所示的回調資料在 txCallback
中):
請注意,以上是偽碼 (pseudocode)。您可能需要額外注意處理潛在的未定義/空值(如 internalFee
),並根據您所選程式語言的一般慣例,安全正確地解析數字。
在任何預期的失敗情況下,函式 (function) 將回調一個帶有錯誤代碼的欄位名稱 error
。請注意,任何意料之外的失敗(如網路問題導致交易提交超時)仍可能產生錯誤。如需所有錯誤的完整清單,請參閱。
如果嘗試傳送至第二層交易,而收件人不存在於AkashicChain上。如果只進行交易,請忽略此項。
如果產生 UNKNOWN_ERROR
,可能表示 出錯。請檢查所拋出錯誤的詳細資訊 (details
),以瞭解更多資訊 。如果您沒有出錯,這些錯誤通常都是短暫的,延遲一小段時間後再重試應該就會成功。
(回調中的 feesPaid
),總是以計算 (例如 ETH 代表 ERC20 USDT 轉帳,TRX 代表 TRC20 USDT 轉帳等)。由 收取 (以太坊 (Ethereum)、波場 (Tron) 等。)
「費用代付」。Akashic 系統讓您用代幣而非原生幣來支付上述的原生費用,以簡化問題。如果這樣做,feeIsDelegated
將會在回調中為 true
。所有使用 SDK 完成的提款都應該是 「代付」的,而從 啟動的提款預設不會是 「代付」的。「代付」費用所需的額外代幣金額在 internalFee.withdraw
中。