識別碼 (Identifier) & ReferenceId
識別碼 (identifier) 可讓您追蹤錢包及其存款和提款。
注意：本頁的代碼應視為偽碼 (pseudocode)。有關詳細資訊和完全正确的範例，請參閱說明文件中描述特定功能的頁面。
重要事項
存款地址會永久映射至其建立時的識別碼 (identifier)
傳送至此類地址的交易總會包含識別碼 (identifier)
identifier和recipientId表示相同的概念（分別用於存款和出款/提幣）referenceId在存款請求中是可選的。如果您同時管理存款請求，它可以讓您進一步識別用戶存入的是哪筆存款。
強烈建議在使用者和存款地址之間保持一對一的對應關係。
為什麼？
永久分配的存款地址意味著每次啟動存款（或通過某種演算法從預先產生的池中選擇）時都不必創建新的錢包。為一個識別碼 (identifier) 請求一個存款地址後，您知道該識別碼 (identifier) 和地址是永遠相連的，因此不需要再為該識別碼 (identifier) 請求存款地址。如果您仍想檢查地址，AP 只需在資料庫中查找該錢包，而不是在區塊鏈上創建一個新錢包 - 這可能是一個冗長的過程，因此仍然更有效率。
如果您管理的是一組用戶，您會更容易追蹤哪個用戶有哪個地址用於存款（因為只有一個，而且總是同一個）。同樣地，您的用戶只需處理一個地址（或確實是每個網絡一個）用於存款，將存款進入錯誤錢包的任何風險降至最低。
詳細說明
在文件和程式碼中，您會遇到「識別碼」 (identifier)（有時是 「recipientId」）的概念。識別碼 (identifier) 就是唯一識別存款地址、存款和提款的東西。通常，識別碼 (identifier) 會是 userId 或類似的東西，但如何使用則由您決定。
如果您管理存款請求，您可以將您的存款 ID 傳給 「referenceId」，以進一步識別用戶存入的是哪筆存款。如果您管理出款請求，您可以直接將您的出款 ID 傳給 「receiverId」，它將在回調中作為 「identifier」 返回。
存款
建立存款地址
您最先遇到識別碼 (identifier) 的地方通常是為您的軟體建立錢包（存款地址）時，也許是讓您的某位使用者將資金存入錢包。如果您控制著許多使用者，您很可能會以一些獨特的屬性（例如 ID 或使用者名稱）儲存他們的資料。這可以用來取得存款地址：
回調的地址 (上例中為 TTVkK6hGoAFhaLh1NTkUDHjcFFXKmWcSdb) 現在永久指定給識別碼 'user1'。之後任何相同函式 (function) 的回調都會傳回相同的地址：
如果您變更網路或識別碼 (identifier)，自然會得到不同的地址：
如果您需要將存款對應到您的存款請求，您需要將存款請求 ID 傳給 referenceId
存款回調
如果我們已經識別為 user1 的用戶現在決定向錢包 TTVkK6hGoAFhaLh1NTkUDHjcFFXKmWcSdb 入金，您將收到一個回調到您在 AkashicPay.com 上設定的 URL。回調物件中會有一個標題為識別碼 (identifier) 的欄位，其值為 user1。這可以讓您輕鬆地將存款與其所屬的用戶相識別。當然，如果您願意的話，也可以將地址 (TTV...) 儲存在資料庫中，然後用它來代替。
如果您在 getDepositAddress 中傳入 referenceId，您也會在回調中收到 referenceId。
出款/提款
處理出款（提款）
對於出款/提款，您必須在函式呼叫中包含一個識別碼 (identifier)/收款人 ID (recipientId)。通常，如果支付與相同的使用者相關聯，則此識別碼 (identifier) 應與之前使用的相同。繼續我們的範例，假設 user1 準備提款。他們可能會向您提交一個請求，而您會使用 SDK 來啟動這個請求：
這將在 Tron (TRX) 網絡上啟動一筆從 AkashicPay 到外部錢包 TAzsQ... 的交易，價值為 10 USDT。由於 AkashicPay 的工作方式，提款可能會從許多錢包中的一個發送。因此，不能保證（事實上，不太可能）取款是從 user1 用來存款的相同地址發送的，您絕對不應該相信這一點。
請注意，支付識別碼 (payout-identifier) 不必與存款識別碼 (deposit-identifier) 相同。舉例來說，如果您想要追蹤個別交易的細節，而不只是追蹤發起交易的使用者，一個簡單的方法就是透過識別碼 (identifier) 對交易進行編號：
但是，基於上述原因，我們強烈建議存款時不要使用此方法。
出款回調
當使用上述功能觸發提款時，您將再次收到一個回調到您在 AkashicPay.com 上設置的 URL。當您收到出款回調時，交易已經被確認，並且可以安全地將款項存入用戶的賬號中。
特殊案例
付款時沒有識別碼 (identifier)？
根據您的使用情況，有些情況下可能不需要包含識別碼 (identifier)。例如，向特殊錢包進行內部交易或進行利潤出款時。一般而言，對於這些與任何使用者無關的出款，識別碼 (identifier) 基本上是多餘的。但是，我們仍然要求所有交易都要有識別碼 (identifier)，以確保所有交易都能被清楚追蹤。這是由於沒有安全的方法來分開兩個交易，否則在技術上有可能同時發生兩個原本相等的交易。因此，我們鼓勵您使用合理的識別碼 (identifier) 記錄所有交易。例如：
當然，任何字串參數 (string-argument) 都是允許的，所以如果您絕對確定不想透過識別碼 (identifier) 來追蹤交易，您可以直接提供任何隨機字串 (string)，然後馬上忘記它：
注意！請勿使用空字串 (string)！
多個存款地址？
當然，沒有什麼可以阻止您在系統中為「user1」提供多個存款地址。也許一個地址會用於特別促銷或其他情況。在這種情況下，您可以簡單地做以下事情：
或許您可以將此儲存於您的使用者，例如：
像往常一樣，任何存入上述兩個地址的存款現在都會返回各自的識別碼 (identifier)。
這是一個展示如何使用 AkashicPay 的範例。但是，我們建議在用戶和存款地址之間始終保持一對一的映射，以獲得最高的效率和最小的混淆可能性。
Last updated