getDepositAddress

Get an address on the specified network for users to make deposits into.

NB!! You MUST be signed up on AkashicPay.com before creating wallets. Otherwise they will not be recognized even though you might get an address in return.

Given a network and a user-identifier, this function will create a wallet on the specified network via AkashicChain for the user to deposit into. To read more about the purpose of the identifier, see the next page.

referenceId is optional in deposit request. It allows you to identify individual transactions if you require more detailed control over deposits. See the next page for more information.

requestedAmount and requestedCurrency are optional in deposit request. It allows you to identify individual transactions based on these. See Requested amount & currencyfor more information.

Note: Deposit addresses are permanently assigned on AkashicPay. That means, any subsequent call to getDepositAddress with the same parameters (Network and identifier) will return the same address. This means it is easy to keep track of the 1-to-1 mapping between identifier and address, and - if the identifier represent a user - impossible for the user to become confused about where to deposit into.

Example

Creates a Tron-wallet for user123

TypeScript

const { address, identifier } = await akashicPay.getDepositAddress(
  NetworkSymbol.Tron, // Network
  'user123', // identifier
  'order1' // optional referenceId
);
​
// with requestedAmount, requestedCurrency and markupPercentage
const { address, identifier } = await akashicPay.getDepositAddressWithRequestedValue(
  NetworkSymbol.Tron, // Network
  'user123', // identifier
  'orderId', // referenceId
  Currency.USD, // requested currency
  "1000", // requested amount
  TokenSymbol, // optional token symbol, omit if native coin
  1, // optional mark up percentage on exchange rate
);

PHP

Java

C#

Go

Return Example

TypeScript

{
address: 'TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU',
identifier: 'user123'
// with requestedAmount and requestedCurrency
referenceId: 'order1',
requestedAmount: '1000',
requestedCurrency: 'USD',
network: 'TRX-SHASTA',
token: undefined, // or TokenSymbol
exchangeRate: '264.23123',
amount: '3.78',
expires: '2025-07-01T00:00:00.000Z',
markupPercentage: undefined // or string
}

PHP

Java

C#

Go

Errors

Error	Explanation
AkashicError.KeyCreationFailure - 'Failed to generate new wallet. Try again.'	AkashicChain had an issue and could not generate the requested wallet. Normally should resolve shortly
AkashicError.UnHealthyKey - 'New wallet was not created safely, please re-create'	Wallet was created but it was not verified to be 100% healthy. E.g. one of the nodes may not have been able to write its part of the data correctly. Try again right away