November 22, 2022

Minimum deposits and API improvements

In April 2022, we introduced a minimum amount for withdrawals and explained that it was necessary in order to prevent loss of liquidity when processing withdrawals.

Today we are introducing minimum deposit amounts for some assets to shorten blockchain fees on incoming/outgoing transactions.

The minimum deposit amount is visible in the form. We also added the total equivalent in USD price (aproximate).

As for preventing losses to the platform, we have established this configuration for Toncoin:

  • Minimum deposit: 0.5 TON.
  • Minimum withdrawal: 0.5 TON.
  • Withdrawal processing fee: 2.8%.

By doing this, we can cover the blockchain fee and save some revenue for TelePay. Our simulations threw these results, which are the best numbers we can offer now to the TON blockchain users.

Deposits for HIVE and HBD have no minimum amount. That's an advantage of Hive blockchain vs. TON blockchain, they don't have fees. But, we do charge a small fee on Hive/HBD withdrawals, that's your payment for our service. ๐Ÿ™‚

โš™๏ธ API changes

New documentation

The API is now accessible with Swagger and Redoc, following the OpenAPI specification. Now it's easier for devs to integrate it.

Join our channel for devs, to keep updated

Improved: Endpoint POST /createInvoice [REFERENCE]

Specifying the type of payment that you'd like to receive is now possible. You can choose between on-chain, off-chain transactions, or bot.

  • added input field on_chain_allowed, default true
  • added input field off_chain_allowed, default true

โ„น๏ธ On-chain transactions are performed on the blockchain, off-chain transactions are paid with the internal (existing) TelePay balance.

Improved: Endpoint GET /getAsset [REFERENCE]

Now the endpoint serves more data related to each asset. These fields are added

  • coingecko_id (string) The asset ID on CoinGecko, which we use as a provider to cache the price against USD. Just in case you need it.
  • deposit_minimum (decimal) The minimum required amount for on-chain deposits.
  • deposit_enabled (boolean) Deposits to this asset are enabled or not.
  • withdrawal_minimum (decimal) The minimum required amount for on-chain withdrawals.
  • withdrawal_enabled (boolean) Withdrawals from this asset are enabled or not.
  • withdrawal_fee_percentage (decimal) The withdrawal (percentage) fee associated with this asset.
  • withdrawal_fee_fixed (decimal) The withdrawal (fixed) fee associated with this asset.

Example request:

  "asset": "TON",
  "blockchain": "TON",
  "network": "mainnet"

Example response:

  "asset": "TON",
  "blockchain": "TON",
  "usd_price": "1.719999999999999973",
  "url": "",
  "networks": [
  "coingecko_id": "the-open-network",
  "deposit_minimum": "0.500000000000000000",
  "deposit_enabled": true,
  "withdrawal_minimum": "0.500000000000000000",
  "withdrawal_enabled": true,
  "withdrawal_fee_percentage": "0.02800",
  "withdrawal_fee_fixed": "0.000000000000000000"

Deprecated: Endpoint GET /getWithdrawalMinimum [REFERENCE]

It will be kept functional, for compatibility purposes with the older versions, but we encourage you to use the GET /getAsset endpoint, where the withdrawal minimum (among other data) is served.

๐Ÿง‘โ€๐Ÿ’ป Devs, action from your side is required

We recommend updating your apps to ensure that:

  • Your invoices comply with the minimum deposit amount for each asset, if defined.
  • Check if deposits for an asset are enabled before creating new invoices.
  • Handle the error=deposit.disabled error when creating an invoice.
  • Handle the error=deposit.minimum error when creating an invoice.

That's it for now. Our team is a little bit quiet these days, but we are working hard to add more tokens and features. Stay tuned!

This article is brought to you by TelePay, a cryptocurrencies payments gateway, to help you handle payments in your business, in an easy, fast, and secure way. Sign up, add your merchants and get your personal guarded wallet with us.

Join our other channels to stay updated with the latest news:
Telegram EN ๐Ÿ‡บ๐Ÿ‡ธ:
Telegram ES ๐Ÿ‡ช๐Ÿ‡ธ:
Telegram RU ๐Ÿ‡ท๐Ÿ‡บ:
Telegram Devs channel: