getDepositAddress
取得指定網路的地址,供使用者存款至此。
注意!!在創建錢包之前,您必須在 AkashicPay.com 上註冊。否則它們將無法被識別,儘管您可能會得到一個地址作為回報。
給定一個網路和一個使用者識別碼 (user-identifier),這個函式 (function) 會透過 AkashicChain 在指定的網路中建立一個錢包,讓使用者存入錢包。要閱讀更多關於識別碼的用途,請參閱下一頁。
referenceId
在存款請求中是可選的。如果您同時管理存款請求,它可以讓您進一步識別用戶存入的是哪筆存款。
注意:存款地址在 AkashicPay 上是永久分配的。這意味著,任何以相同參數(網路和識別碼)隨後呼叫 getDepositAddress
將返回相同的地址。這意味著很容易跟蹤識別碼 (identifier) 和地址之間的一對一映射,而且 - 如果識別碼 (identifier) 代表一個用戶 - 用戶不可能搞不清楚該把錢存到哪裡。
範例
為 user123
建立 Tron-wallet
const { address, identifier } = await akashicPay.getDepositAddress(
NetworkSymbol.Tron, 'user123'
);
// with referenceId
const { address, identifier } = await akashicPay.getDepositAddress(
NetworkSymbol.Tron, 'user123', 'order1'
);
$depositAddress = $akashicPay->getDepositAddress(
NetworkSymbol::Tron, 'user123'
);
// with referenceId
$depositAddress = $akashicPay->getDepositAddress(
NetworkSymbol::Tron, 'user123', 'order1'
);
APDepositAddressResult depositAddress = akashicPay.getDepositAddress(
APNetworkSymbol.TRX, 'user123'
);
// with referenceId
APDepositAddressResult depositAddress = akashicPay.getDepositAddress(
APNetworkSymbol.TRX, 'user123', 'order1'
);
var trxDepositAddress = await akashicPay.GetDepositAddressAsync(TronShastaNetworkSymbol.Value,
"user123");
// with referenceId
var trxDepositAddress = await akashicPay.GetDepositAddressAsync(TronShastaNetworkSymbol.Value, "user123", "order1");
回調範例
{
address: 'TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU',
identifier: 'user123'
}
[
"address" => "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
"identifier" => "user123",
]
{
address: 'TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU',
identifier: 'user123'
}
{
Address: "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
Identifier: "user123"
}
錯誤訊息
AkashicError.KeyCreationFailure
- '產生新錢包失敗。請再試一次'。
AkashicChain 出現問題,無法產生所要求的錢包。通常應很快解決
AkashicError.UnHealthyKey
- '新錢包未安全建立,請重新建立
已建立錢包,但未驗證是否 100% 健康。例如,其中一個節點可能無法正確寫入其部分資料。馬上再試一次