getDepositAddress

取得指定網路的地址，供使用者存款至此。

注意！！在創建錢包之前，您必須在 AkashicPay.com 上註冊。否則它們將無法被識別，儘管您可能會得到一個地址作為回報。

給定一個網路和一個使用者識別碼 (user-identifier)，這個函式 (function) 會透過 AkashicChain 在指定的網路中建立一個錢包，讓使用者存入錢包。要閱讀更多關於識別碼的用途，請參閱下一頁。

referenceId在存款申請中是可選的。如果您需要對存款進行更詳細的控制，它允許您識別個別交易。更多資訊請參閱下一頁。

requestedAmount 和 requestedCurrency 在存款請求中是可選的。它允許您根據這些來識別個別交易。更多資訊請參閱。

注意：存款地址在 AkashicPay 上是永久分配的。這意味著，任何以相同參數（網路和識別碼）隨後呼叫 getDepositAddress 將返回相同的地址。這意味著很容易跟蹤識別碼 (identifier) 和地址之間的一對一映射，而且 - 如果識別碼 (identifier) 代表一個用戶 - 用戶不可能搞不清楚該把錢存到哪裡。

範例

為 user123 建立 Tron-wallet

TypeScript

const { address, identifier } = await akashicPay.getDepositAddress(
  NetworkSymbol.Tron, 'user123'
);

// with referenceId
const { address, identifier } = await akashicPay.getDepositAddress(
  NetworkSymbol.Tron, 'user123', 'order1'
);
​
// with requestedAmount and requestedCurrency
const { address, identifier } = await akashicPay.getDepositAddress(
  NetworkSymbol.Tron, 'user123', 'order1', Currency.USD, "1000"
);

PHP

$depositAddress = $akashicPay->getDepositAddress(
  NetworkSymbol::Tron, 'user123'
);

// with referenceId
$depositAddress = $akashicPay->getDepositAddress(
  NetworkSymbol::Tron, 'user123', 'order1'
);

Java

APDepositAddressResult depositAddress = akashicPay.getDepositAddress(
  APNetworkSymbol.TRX, 'user123'
);

// with referenceId
APDepositAddressResult depositAddress = akashicPay.getDepositAddress(
  APNetworkSymbol.TRX, 'user123', 'order1'
);

C#

var trxDepositAddress = await akashicPay.GetDepositAddressAsync(TronShastaNetworkSymbol.Value, 
"user123");

// with referenceId
var trxDepositAddress = await akashicPay.GetDepositAddressAsync(TronShastaNetworkSymbol.Value, "user123", "order1");

回調範例

TypeScript

{
address: 'TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU',
identifier: 'user123'
}

PHP

[
    "address" => "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
    "identifier" => "user123",
]

Java

{
address: 'TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU',
identifier: 'user123'
}

C#

{
Address: "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
Identifier: "user123"
}

錯誤訊息

錯誤訊息	說明
AkashicError.KeyCreationFailure - '產生新錢包失敗。請再試一次'。	AkashicChain 出現問題，無法產生所要求的錢包。通常應很快解決
AkashicError.UnHealthyKey - '新錢包未安全建立，請重新建立	已建立錢包，但未驗證是否 100% 健康。例如，其中一個節點可能無法正確寫入其部分資料。馬上再試一次