Введение

Основная цель этой статьи — сделать подробный обзор платежного сервиса UseGateway, чтобы у вас сложилось четкое понимание его возможностей для решения бизнес-задач.

UseGateway позволяет удовлетворить две основные потребности бизнеса: получать платежи от клиентов за товары или услуги и пополнять клиентский счет (например, если у вас развлекательный сервис или казино).

UseGateway отличается от обычных сервисов приема платежей, так как работа с криптовалютами отличается от работы с фиатными валютами (такими как доллары, евро, тенге, манаты, гривны, рубли и т. д.).

Первое отличие – это время между началом и завершением перевода. В случае с криптовалютами длительность оплаты может колебаться от нескольких минут до нескольких часов в зависимости от выбранной криптовалюты, комиссии исполнителя платежа (майнера) и загрузки сети. На эти условия UseGateway не может повлиять.

Второе отличие – нестабильный обменный курс.
Обычно бизнес осуществляет операции с использованием фиатных валют, поскольку курс криптовалют может сильно колебаться даже на горизонте нескольких часов.

Третье отличие заключается во внутренних различиях используемых криптовалют. Несмотря на то, что в этом обзоре мы для простоты называем все криптоактивы криптовалютами, на самом деле архитектурно они сильно различаются. У каждого инструмента свои уникальные характеристики: скорость выполнения операций, стабильность обменного курса, размер комиссии за операцию, способ оплаты комиссии и т. д.

Криптоактивы, принимаемые с помощью UseGateway

Сервис позволяет получать платежи от пользователей в следующих криптоактивах: BTC, ETH, LTC, TRON (TRX) и Tether (USDT TRC20).

Tether (USDT TRC20) — так называемая стейблкоин, поскольку ее обменный курс обычно близок к курсу доллара и долго остается стабильным.

Комиссии и сборы

Криптосеть удерживает комиссию, которая зависит исключительно от криптовалюты и условий ее использования. UseGateway также удерживает комиссию за свои услуги.

Комиссия взимается в момент вывода средств или проведения платежа.

Комиссия сервиса UseGateway не может быть меньше минимальной суммы перевода, разрешенной в выбранной сети.

Минимальные суммы, принимаемые к переводу:
0.0001 Bitcoin
0.0001 Litecoin
0.000001 TRON

Комиссия за переводы с использованием USDT TRC20 удерживается в криптовалюте TRON (TRX). Если у вас недостаточно средств на балансе счета в TRX, вы можете вручную создать платеж для оплаты с использованием TRX. Выберите опцию «Создать платеж» на вкладке «Операции», а затем используйте сгенерированную ссылку для проведения платежа.

Баланс и кошелек

Мы будем использовать следующие термины в документации:

Баланс – это сумма всех операций, которую можно вывести. Баланс отображается в личном кабинете на сайте UseGateway. Обратите внимание, что отображаемая сумма не учитывает комиссию за вывод.

Кошелек – условное название адреса, который создается внутри выбранной криптосети (блокчейна) — например, Bitcoin или Litecoin — для проведения платежей и пополнения депозита. Для каждого платежа создается уникальный адрес, который в дальнейшем не используется ни для каких других целей. В случае депозита для каждого клиента создаются индивидуальные адреса.

Общий баланс - это сумма средств, хранящихся на всех кошельках, пересчитанная по курсу фиатной валюты, указанной в настройках личного кабинета.

В дальнейшем средства, поступившие на все кошельки, переводятся на общий кошелек в этом блокчейне и выводятся на указанный клиентом кошелек с удержанием комиссии UseGateway.

Обмен данными и уведомления

Мы используем программный интерфейс (API) для получения и передачи данных. Управлять платежами можно через личный кабинет UseGateway.

Уведомления можно получать через вебхук или по электронной почте, которую можно настроить в вашем личном кабинете UseGateway.

Начало работы

UseGateway работает как некастодиальный кошелек, который позволяет вам полностью контролировать все свои криптоактивы. Пожалуйста, сохраните сид-фразу в надежном месте — в случае ее потери доступ к вашим средствам будет безвозвратно утерян.

Мы настоятельно рекомендуем вывести средства после нескольких первых платежей, чтобы подтвердить сид-фразу.

1. Создайте ключ API.
   Откройте Настройки > Безопасность > Создать новый ключ API.
2. Создайте вебхук.
   Откройте Настройки > Уведомления > Добавить эндпоинт.

Платежи

Платеж это инструмент, который подходит для интернет-магазинов, где товары и услуги продаются по фиксированной стоимости. Его также можно использовать для пополнения баланса на фиксированные суммы (например, 50/100/500 долларов).

Счет на оплату выставляется клиенту в процессе создания платежа. Курс обмена фиксируется на 60 минут с момента создания, в течение которых клиент должен произвести оплату. Обратите внимание на то, что 60 минут — это значение по умолчанию, его можно изменить в разделе настроек личного кабинета UseGateway.

Клиент может выбрать любую криптовалюту из указанных вами подходящими для оплаты из всех вариантов, поддерживаемых UseGateway (BTC, ETH, LTC, TRON (TRX), USDT TRC20).

Информацию о статусе платежа и его исполнении вы можете получить через вебхук или личный кабинет на сайте UseGateway.

Если клиент проведет платеж после истечения его срока действия, то платежу присвоится статус «Просрочен».

В этом случае вам нужно будет принять или вернуть платеж через личный кабинет или API. Оплаченная сумма не будет зачислена на ваш баланс до тех пор, пока вы не примете платеж.

По факту у UseGateway нет крайнего срока для платежей, и платеж будет доставлен вам со статусом «Просрочен» даже через год с даты его создания.

Если клиент заплатит меньше указанной суммы, то платеж придет со статусом «Недоплата».

В этом случае вам нужно будет принять или вернуть платеж через личный кабинет или API. Оплаченная сумма не будет зачислена на ваш баланс до тех пор, пока вы не примете платеж.

Если клиент заплатит больше нужной суммы, то платеж зачислится на ваш баланс со статусом «Переплата». В случае оплаты ровно на указанную сумму статус платежа будет В случае оплаты ровно на указанную сумму статус платежа будет«Выполнен». Платежи со статусами «Переплата» и «Выполнен» автоматически зачисляются на ваш счет без дополнительных действий.

Повторно оплаченному платежу присваивается статус «Множественный».

Любая операция в UseGateway может быть возвращена, независимо от статуса платежа. Комиссию блокчейна за обратный перевод оплачивает пользователь. Она может быть удержана из суммы, возвращаемой клиенту. Комиссия UseGateway также будет удерживаться за обратную операцию.

Перед выполнением процедуры возврата рекомендуется согласовать с клиентом его готовность принять перевод на адрес кошелька, с которого был произведен первоначальный платеж — иногда это бывает невозможно.

Депозиты

В отличие от платежей, с депозитами автоматически создается новый кошелек для каждого вашего клиента, который он может пополнить в любой момент на любую сумму больше установленной вами как минимальной.

Установка минимальной суммы пополнения не только поможет выполнить ваш бизнес-план, но и исключит ситуации, когда вам приходится отдавать значительную часть платежа клиента в качестве комиссии сети.

К примеру, на момент написания этой статьи минимальная сумма комиссии сети за перевод USDT TRC20 составляла около 1 USD. Если для клиента создан кошелек USDT, в который клиент за время его существования внес всего 1 USD, то при попытке вывода средств комиссия за вывод будет примерно равна балансу кошелька. Мы настоятельно рекомендуем устанавливать минимальную сумму пополнения эквивалентной 3 USD или выше.

Вебхуки помогут вам получать уведомления о переводах на кошелек и пополнять депозит клиента в своем сервисе на соответствующую сумму. Вы получите информацию об операции в выбранной вами фиатной валюте по курсу, зафиксированному на момент фактического зачисления средств на кошелек.

Если клиент отправит меньше суммы, указанной как минимальной, то пополнение депозита придет со статусом «Недоплата». В этом случае вам нужно будет принять или вернуть пополнение через личный кабинет или API. Оплаченная сумма не будет зачислена на ваш баланс до тех пор, пока вы не примете пополнение.

Платежи, зачисленные на баланс вашего счета, будут иметь статус «Пополнен».

Для создания депозита UseGateway требуется получить от клиента название сайта или сервиса и идентификатор пользователя. Сайт нужен, чтобы избежать путаницы, если у вас будет несколько связанных проектов и идентификаторы пользователей в них совпадут. Вы можете указать любое значение в поле адреса сайта, по которому UseGateway будет различать ваши проекты.

В качестве идентификатора пользователя можно использовать любой уникальный идентификатор клиента, имеющийся в вашем сервисе. Мы не рекомендуем использовать персональные данные клиента, такие как адрес электронной почты или номер телефона. Во-первых, такие идентификаторы могут измениться, а в UseGateway новый идентификатор пользователя означает создание новых кошельков. Во-вторых, существует дополнительный риск утечки персональных данных, чего можно легко избежать, используя замаскированный идентификатор пользователя и его уникальное имя.

Депозит — это решение, которое лучше всего подходит для благотворительности, игровых сервисов, покер-румов и казино.

Интеграция

Обменные курсы

API UseGateway позволяет получать текущие обменные курсы для пар криптовалюта/фиатная валюта и наоборот.

Поддерживаемые криптовалюты: BTC, ETH, LTC, TRX и USDT_TRC20.

Поддерживаемые фиатные валюты: USD, EUR, UAH, RUB, KZT, AZN и TRY.

Обратите внимание на то, что обменные курсы всех криптовалют не регулируются никаким центральным регулирующим органом. Применяемый курс может немного различаться между криптобиржами. Эти различия обычно нивелируются со временем физическими или юридическими лицами, занимающимися арбитражем криптовалют и зарабатывающими на разнице обменных курсов на разных платформах.

Таким образом, курсы, используемые UseGateway, могут незначительно отличаться от курсов из других источников.

Вывод средств

Вы можете вывести заработанные средства на любой кошелек в той же криптосети: например, можете вывести свои биткоины на адреса в сети Bitcoin.

В момент вывода с вас будет удержана комиссия UseGateway, а также комиссия криптосети. Можно вывести любую сумму, но для выполнения запросов она должна быть доступна на вашем счете вместе с нужными суммами комиссии и сборов.

Для создания запроса на вывод требуется верная сид-фраза. После выполнения запроса средства будут отправлены на указанный адрес в криптосети. Зачисление на ваш адрес зависит от скорости работы выбранной сети и обычно занимает от 1 до 15 минут.

История запросов на вывод средств находится в разделе «Кошелек» в личном кабинете. У запроса могут быть следующие статусы:

В процессе – запрос на вывод успешно создан.

Выполнен - запрос на вывод успешно выполнен.

Отклонен – запрос на вывод отклонен системой.

Ошибка – произошла ошибка в процессе вывода.

Вывод средств через API (Запрос на вывод)

Вы также можете создавать запросы на вывод средств автоматически. Затем их нужно будет лишь подтвердить в личном кабинете UseGateway, введя сид-фразу. При отправке запроса вы можете указать требуемую криптовалюту, кошелек и комментарий.

Новые запросы появятся в разделе «Запросы» в личном кабинете. Пользователь сможет выполнить запрос (опция «Выплатить») – в этом случае будет предложен перевод с баланса кошелька UseGateway, отметить запросы как выплаченные, не выполняя платеж (опция «Одобрить») или отклонить запрос ( опция «Отклонить»).

Соответственно, у запроса может быть один из следующих статусов: Получен (ожидает решения), Одобрен (после применения опций «Выплатить» или «Одобрить») и Отклонен (в случае отклонения опцией «Отклонить»).