WaivioLabs
commented
4 years ago Copy of Blocktrades instructions:
Embedding into Wallets and Web Sites via BlockTrades API
Our conversion services can be directly embedded into 3rd party wallets and web sites via our public REST-based API. Full documentation on our API is available at:
https://blocktrades.us/api/v2/explorer
For most integrations, only use of the high-level API function initiate-trade is necessary. Using URL Parameters Our site allows the following trade parameters to be specified in the URL:
input_coin_type – Input (Send) Coin Type, e.g. "eth" for Ethereum, "hive" for Hive, "hbd" for Hive Dollar. input_coin_amount – Input (Send) Coin Amount, e.g. "1.05". output_coin_type – Output (Receive) Coin Type, e.g. "eth" for Ethereum, "hive" for Hive, "hbd" for Hive Dollar. output_coin_amount – Output (Receive) Coin Amount, e.g. "1.05". If both input_coin_amount and output_coin_amount are given, the input_coin_amount will be ignored. receive_address – Receive Address, e.g. "omega". Warning: don't use prefix "@" in Hive addresses. memo – Receive Memo. mapping_id – Mapping ID (UUID), used only when there is valid Session in application. locked_output_coin_type – Output (Receive) Coin Type, unchangeable by user, e.q. "eth" for Ethereum, "hive" for Hive, "hbd" for Hive Dollar. hidden_receive_address – Receive Address, hidden from view and unchangeable, e.q. "alpha". Works only in Widget application. hidden_memo – Receive Memo, hidden from view and unchangeable. Works only in Widget application. show_powered_by_blocktrades – boolean. True by default. If false all information about BlockTrades will be hidden. Works only in Widget application. Use strings true, 1 or on for true, and false, 0 or off for false.
Do not use hidden_receive_address or hidden_memo without locked_output_coin_type, which is required for hidden parameters. Otherwise hidden parameters will be ignored. Hidden or locked parameters always take precedence over normal, e.q. when hidden_memo=black and memo=white, site will use "black" as memo. In Widget application when locked_output_coin_type is set to nonexistent or currently not available coin, site will display 503 error.
Example of use: example link Using BlockTrades logo Our official logo can be used at your site this way:
Обычные Hive пользователи могут пользоваться услугами Blocktrades.us если пройдут самостоятельную регистрацию на бирже.
Для гостевых аккаунтов же, которые только пытаются разобраться в том, как работает Hive и другие cryptocurrencies, этот процесс хочеться сделать максимально простым, чтобы пользователи могли легко вынимать заработанные средства через любой Bitcoin ATM.
Зайдя в wallet пользователь может нажать кнопку Witdraw, указать сумму, просканировать адрес Bitcoin ATM и переслать средства. Процесс расчитан для небольших сумм (до $100 в день).
Можно посмотреть разные библиотеки для сканирования QR кодов. Один из вариантов: https://qrcodescan.in/ (OpenSource -https://github.com/code-kotis/qr-code-scanner)
Очень важным этапом является валидация BTC/LTC/ETH номеров. В API Blocktrades должна быть такая функция.
Далее, облегченная социальная авторизация пользователей может оказаться недостаточной для проведения финансовых операций и в этот процесс предлагается добавить email подтверждения. В будущем, подтверждение email адреса может выполнять роль 1-step регистрации на бирже.
После того, как пользователь подтвердит транзакцию через нажатие ссылки в email, нужно показать условия транзакции еще раз с updated estimates.
И после финального подтверждения, транзакция должна отразиться в wallet истории, как перевод на адрес blocktrades.
Здесь было бы очень полезно, если бы можно было в этой записи нажать на ссылку и посмотреть детали exchange transaction, чтобы пользователь смог потом перейти на публичные сайты (Bitcoin.com, Etherscan.com), чтобы увидеть статус обработки их транзакции.
Если email адреса еще нет, то пользователь может его просто указать в процессе withdrawal. Однако, если адрес существует, то поменять его можно только через подтверждение со старого адреса.
Тексты диалогов:
Confirmation message:
Blocktrades.us exchange request This transaction must be confirmed by email: Enter your email Legal notice I agree to Blocktrades.us Terms and Conditions of Use (link to https://blocktrades.us/en/terms-and-conditions-of-use). I am at least 18 years of age and do not reside in Prohibited Jurisdictions (New York and Belarus, Burma, Cote D’Ivoire (Ivory Coast), Cuba, Democratic Republic of Congo, Iran, Iraq, Lebanon, Liberia, Libya, North Korea, Sudan, Syria, Somalia, and Zimbabwe). Cancel / Send confirmation
Confirmation email sent Please confirm this transaction from your email (name@domain.com). Ok
Email confirmation:
From: support@waivio.com Subject: Exchange request: #### [User name] (@waivio_[guest username]):
You requested to exchange [amount] HIVE to [amount] [Bitcoin] (estimated amount) via Blocktrades.us and to deposit funds to your account: [deposit address].
To confirm this request, please click the following link: [confirmation link]
If you didn’t initiate this transaction, please, ignore this email.
Please note that:
Sincerely, Waivio Team
Final confirmation: Send [amount] HIVE to Blocktrades.us exchange Receive: [amount] [Bitcoin] (updated estimation) Deposit to: [address] Memo: [memo] Initiate the transfer on the Hive blockchain. Cancel / Confirm
Email change request To change the email address, you must first unlink the existing email address. Unlink request will be sent to: name@domain.com Note: if you no longer have access to this email, unfortunately you will not be able to unlink it from the Waivio_[guest username] account. Cancel / Send request
Email change request sent Please confirm this transaction from your email (name@domain.com). Ok
Email unlink request:
From: do-not-reply@waivio.com Subject: Unlink request for @waivio[guest username] [User name] (@waivio[guest username]):
You requested to unlink email: [name@domain.com] from @waivio_[guest username] user account.
To confirm this request, please click the following link: [confirmation link]
If you didn’t initiate this transaction, please, ignore this email.
Sincerely, Waivio Team
Request confirmed Email address was successfully unlinked from @waivio_[guest username] user account. Ok