Руководство по подготовке к запуску и пошаговый видеоразбор
Вопрос {{n}} из {{t}}
Готовы к запуску
У вашей команды есть ответы на ключевые вопросы. До запуска осталось немного: перед ним проведите тесты с реальными платежами.
Почти готовы
Осталось уточнить несколько вопросов. Разберитесь с ними до запуска: каждому посвящён раздел этой статьи.
Пока не готовы
Несколько ключевых вопросов пока не решены. Hosted Checkout снимает с вашей команды большую часть работы. Чтобы заранее увидеть, как проходит оплата, запросите демонстрацию у отдела продаж Volet.com.
Чек-лист перед запуском интеграции через API
Девять вопросов, на которые нужно ответить до запуска. Выберите ответ, который подходит вашей команде: каждый вариант открывает краткое пояснение и указывает на раздел статьи с подробностями.
Вопрос 1 из 9
1. Нужен ли продукту собственный платежный интерфейс?
Да, нам нужен собственный интерфейс
Нет, подойдёт страница на стороне Volet.com
Пока не решили
Если да, нужна интеграция только через API: ваша команда будет разрабатывать и поддерживать страницы оплаты. Если нет, Hosted Checkout потребует меньше усилий, а также позволит принимать платежи с баланса аккаунта Volet.com.
→ См. ниже: «API или Hosted Checkout: практическое сравнение»
2. Нужно ли нам контролировать каждый этап оплаты или допустимо перенаправление?
Нужен контроль над каждым этапом
Перенаправление подходит
Пока не решили
При перенаправлении в Hosted Checkout платформа Volet.com отправляет уведомления о статусе на ваш Status URL. Если вы используете собственный платежный интерфейс на базе API, ваш бэкенд должен сам проверять статус платежа.
→ См. ниже: «API или Hosted Checkout: практическое сравнение»
3. Есть ли у нас ресурсы на разработку и поддержку платежного интерфейса, обработку истечения срока действия счетов и проверку статусов?
Да, ресурсы есть
Нет, нам больше подходит Hosted Checkout
Пока не уверены
При интеграции только через API ваша команда отвечает за страницы оплаты, обработку истечения срока действия счетов (курс в счёте действует 60 или 15 минут) и регулярную проверку статусов.
→ См. ниже: «Что вашей команде предстоит разработать»
4. Определили ли мы, как связывать внутренние заказы с попытками оплаты и предотвращать повторное выполнение заказов?
Да, определили
Пока нет
Храните каждый заказ отдельно от попыток его оплаты, используйте уникальный orderId для каждой попытки и выполняйте каждый заказ только один раз.
→ См. ниже: «Модель заказов и платежей на бэкенде»
5. Решили ли мы, как сверять транзакции на стороне провайдера, полученные суммы, комиссии и валюту расчётов?
Да, процесс определен
Пока нет
Сохраняйте для каждого заказа идентификатор транзакции Volet.com, полученную сумму и валюту расчётов, чтобы каждый платёж можно было сопоставить со счётом.
→ См. ниже: «Модель заказов и платежей на бэкенде»
6. Заложили ли мы ресурсы на обработку сбоев, сквозное тестирование и мониторинг в рабочей среде?
Да, это в плане
Пока нет
Отдельно оцените трудозатраты на успешный сценарий и сценарии сбоев: тайм-ауты, просроченные счета и повторные попытки требуют времени разработчиков.
→ См. ниже: «Как реалистично оценить объём работ»
7. Решили ли мы, как обрабатывать недоплаты, переплаты, просроченные платежи и платежи не в той сети?
Да, правила определены
Пока нет
В настройках шлюза вы определяете, принимать ли недоплаты и переплаты. Средства, отправленные не через ту сеть, могут быть потеряны. Закрепите свои правила и политику возвратов в условиях продажи.
→ См. ниже: «Чем криптоплатежи отличаются от платежей по картам»
8. Знает ли финансовый отдел, в какой валюте зачисляются платежи и сколько стоит конвертация?
Да, финансовый отдел в курсе
Пока нет
Полученную криптовалюту можно хранить без конвертации или конвертировать автоматически. Конвертация между USD, USDT и USDC проходит по фиксированному курсу 1:1; другие конвертации оплачиваются отдельно.
→ См. ниже: «Сколько это стоит в Volet.com»
9. Запланировали ли мы тестирование с реальными платежами с учетом того, что тестовой среды нет?
Да, план тестирования есть
Пока нет
В Volet.com нет тестовой среды. Запросите демонстрацию, заранее создайте шлюз и до запуска проведите тесты с реальными платежами.
→ См. ниже: «Тестирование без песочницы»
Ваш результат
Ответьте на все девять вопросов, чтобы увидеть результат.
Еще не решено:
Чем криптоплатежи отличаются от платежей по картам
Если ваша команда уже интегрировала платежи по картам, не все привычные подходы подойдут для криптоплатежей. При оплате картой продавец списывает деньги у клиента. При оплате криптовалютой клиент сам отправляет средства из своего кошелька, а ваша система должна обрабатывать фактически поступившую сумму. Поэтому требования к интеграции будут другими.
Сумма может отличаться от указанной в счете. Клиент может отправить чуть меньше или больше, например из-за комиссии сети или разницы курсов. Заранее решите, будете ли вы принимать недоплаты и переплаты.
Например, вы можете допускать небольшие расхождения, связываться с клиентом или оформлять возврат. Какое бы решение вы ни приняли, закрепите его в условиях продажи вместе с правилами возврата и укажите, кто оплачивает комиссию сети при возврате.
Сеть имеет значение. Один и тот же токен существует в нескольких блокчейнах. Средства, отправленные через неверную сеть или на неверный адрес, могут быть потеряны.
Срок действия курса ограничен. Курс в счете действует 60 минут, если средства зачисляются в той же валюте, и 15 минут, если требуется конвертация. Клиенту, который платит позже, может понадобиться новый запрос на оплату.
Подтверждение требует времени. Средства зачисляются только после подтверждения платежа в блокчейне, поэтому интерфейс и логика обработки заказов должны учитывать это ожидание.
Нет чарджбэков и автоматической отмены платежей. Подтвержденную транзакцию в блокчейне отменить нельзя. Возврат — это отдельный платеж, который проводится по вашим правилам и с учетом применимых норм защиты прав потребителей.
Валюта зачисления — выбор бизнеса. После завершения платежа средства зачисляются на ваш аккаунт Volet.com. Вы можете оставить полученную криптовалюту или автоматически конвертировать её в стейблкоины или фиат, чтобы финансовый отдел мог проводить сверку в одной валюте и избегать курсовых колебаний.
Подтверждения сети — без вашего участия. Volet.com отслеживает блокчейн, дожидается нужного числа подтверждений и зачисляет средства, поэтому вашему бэкенду не нужно отслеживать блоки или количество подтверждений.
Единый баланс стейблкоина в разных сетях. Стейблкоин, полученный в одной сети, можно вывести через другую поддерживаемую сеть без отдельного сервиса кроссчейн-мостов.
Без скользящего резерва. Volet.com не удерживает часть средств по завершённым платежам в качестве скользящего резерва.
Ваши правила для недоплат и переплат. В настройках шлюза вы решаете, принимать ли платежи на сумму меньше или больше указанной в счёте. Например, если клиенты пополняют баланс в вашем сервисе, вы можете принимать недоплаты и зачислять ровно столько, сколько поступило. При переплате на ваш аккаунт зачисляется только сумма заказа.
Обработка просроченных платежей. Если платёж поступает после истечения срока действия счёта, Volet.com возвращает его клиенту или, в некоторых случаях, зачисляет на ваш аккаунт.
Приём и отправка средств. Средства с того же баланса Volet.com можно использовать для исходящих платежей: массовых выплат подрядчикам, авторам или партнёрам, а также для вывода средств вашими пользователями. Например, биржа может принимать пополнения пользователей в криптовалюте и обрабатывать вывод криптовалюты с того же баланса Volet.com через API.
Volet.com поможет выстроить платежи по всему миру
В фиате, криптовалюте и стейблкоинах. Через API, Hosted Checkout или готовые плагины. Принимайте, отправляйте средства и управляйте ими — прямо из кода.
Главное — решить, какую часть процесса оплаты ваш продукт должен контролировать и сколько ресурсов вы готовы вложить в разработку.
Выбирайте интеграцию только через API, если вам нужен собственный платёжный интерфейс и контроль над всем процессом оплаты. Ваше приложение отвечает за каждый этап взаимодействия с клиентом: от показа инструкций по оплате до информирования о статусе платежа, пока он не будет подтверждён или срок оплаты не истечёт. Всё это вашей команде предстоит разработать и поддерживать.
Выбирайте Hosted Checkout, если вам не нужны собственный платёжный интерфейс и полный контроль над каждым этапом оплаты. Платёжная страница размещается на стороне Volet.com, поэтому такой вариант обычно проще и требует меньше усилий. Он также работает в Telegram-ботах и мини-приложениях: платёжная страница открывается во встроенном браузере (webview).
Вот как может выглядеть Hosted Checkout от Volet.com
Hosted Checkout также можно использовать вместе с API для поиска заказов и сверки платежей. В любом случае для Hosted Checkout нужна доработка бэкенда. Ваше приложение ведёт собственный учёт заказов и сопоставляет их со статусами платежей на стороне Volet.com. Бэкенд также подписывает запросы, отправляемые в Hosted Checkout. Это помогает защититься от подмены запросов, из-за которой платёж клиента мог бы уйти не в ваш магазин.
Критерий выбора
Только API
Hosted Checkout
Платёжный интерфейс для клиента
Разрабатывает и поддерживает ваша команда
Размещён на стороне Volet.com
Контроль над процессом оплаты
Высокий: ваше приложение управляет всем процессом
Более ограниченный: клиент платит на странице Volet.com
Затраты на разработку
Выше: интерфейс, проверка статусов, обработка истечения срока действия счетов и нестандартных ситуаций
Ниже в части платёжного интерфейса; бэкенд по-прежнему подписывает платёжные запросы, обрабатывает уведомления и обновляет заказы
Для каких задач подходит
Собственный процесс оплаты на сайте, в приложении, боте или на платформе
Стандартный процесс оплаты, в котором допустим переход на внешнюю платёжную страницу, в том числе в ботах и мини-приложениях Telegram
Обработка статусов
Бэкенд проверяет статус платежа через API
Уведомления на Status URL и при необходимости запросы через API для сверки
Оплата с баланса аккаунта Volet.com
Недоступна: при интеграции только через API принимается криптовалюта из внешних кошельков
Доступна: клиенты могут платить с баланса аккаунта Volet.com, комиссия — 0,25%
В фиате, криптовалюте и стейблкоинах. Через API, Hosted Checkout или готовые плагины. Принимайте, отправляйте средства и управляйте ими — прямо из кода.
Эндпоинты для работы со счетами на оплату — лишь часть интеграции только через API. Прежде чем выбрать этот вариант, учтите перечисленные ниже задачи по разработке и эксплуатации.
Как проходит оплата при интеграции только через API:
Создайте заказ в своей системе.
Создайте счёт на оплату в криптовалюте через API.
Покажите клиенту адрес, сумму, валюту, сеть и срок действия счёта, полученные через API.
Клиент отправляет платёж из своего кошелька.
Ваш бэкенд проверяет статус платежа через API.
После подтверждения платежа отметьте заказ как оплаченный и выполните его.
Как проходит оплата с Hosted Checkout и API:
Создайте заказ в своей системе и перенаправьте клиента в Hosted Checkout, передав ваш orderId.
Клиент оплачивает заказ на странице Hosted Checkout.
Volet.com отправляет уведомление на ваш Status URL — эндпоинт на вашем сервере, который получает обновления статуса платежа.
Ваш бэкенд проверяет подпись и при необходимости подтверждает заказ через API.
Отметьте заказ как оплаченный и выполните его.
Платёжный интерфейс и жизненный цикл счёта. Ваше приложение должно точно отображать платёжные реквизиты, полученные через API: сумму к отправке, валюту, сеть блокчейна, адрес, тег назначения или memo, если они есть, и срок действия счёта. Оно должно предупреждать клиентов, что отправлять средства нужно только через указанную сеть. Ошибки в платёжных инструкциях могут привести к потере средств, поэтому речь идёт о функциональном требовании, а не о детали оформления.
Не сообщайте клиенту, что платёж не прошёл или завершён, пока это не подтверждено статусом платежа.
Модель заказов и платежей на бэкенде. Храните внутренний заказ отдельно от попытки оплаты или счёта. Это упростит обработку незавершённых оплат, счетов с истёкшим сроком действия, повторных попыток клиента и обновлений статуса, поступивших после того, как пользователь покинул страницу.
Используйте уникальный orderId для каждой попытки оплаты, как описано в документации API. Определите в своей базе данных, как каждая попытка связана с заказом. Сохраняйте вместе с каждым заказом ID транзакции Volet.com, полученную сумму и валюту расчётов, чтобы финансовый отдел мог сопоставить каждый платёж со счётом без ручного ведения таблиц. Налогообложение поступлений в криптовалюте зависит от вашей юрисдикции — согласуйте порядок их учёта с бухгалтером.
Выберите модель расчёта суммы счёта. Решите, будет ли стоимость заказа указана в валюте, которую вы ожидаете получить, или клиент должен отправить фиксированную сумму в определённой криптовалюте. От этого зависит отображение цены, сверка платежей и то, как вы объясните клиенту сумму к оплате. Согласуйте этот выбор с моделью ценообразования и учёта и проверьте рассчитанные значения, прежде чем создавать счета для реальных платежей. Настройка каждого варианта описана в документации API.
Допустим, клиент оформляет заказ на €120 и оплачивает его криптовалютой. Бэкенд должен хранить достаточно данных, чтобы сопоставить завершённый платёж с исходным заказом. Для этого платежа он сохранит следующие данные:
Идентификатор заказа (ORD-10482) определяет покупку в вашей системе.
Идентификатор транзакции Volet.com (VLT-839201) связывает платёж с транзакцией на стороне Volet.com.
Полученная сумма (около 139 USDT) показывает, сколько клиент фактически отправил.
Валюта расчётов (EUR) указывает валюту, в которой ваш финансовый отдел ведёт учёт.
Статус платежа (окончательный, подтверждённый через API) позволяет определить, можно ли считать платёж завершённым.
Для сверки сопоставьте транзакцию Volet.com с попыткой оплаты и заказом, затем сравните идентификатор транзакции, ожидаемую и полученную суммы, валюту и окончательный статус платежа. Если платёж не поступил, пришёл с опозданием или его сумма отличается от ожидаемой, отметьте его для проверки, а не помечайте заказ как оплаченный автоматически.
Клиент создаёт заказ, открывает страницу оплаты и отправляет нужную сумму в криптовалюте. Не дожидаясь подтверждения транзакции в блокчейне, он закрывает вкладку браузера и покидает ваш сайт.
Ваш бэкенд продолжает отслеживать платёж:
Заказ клиента остаётся в статусе ожидания в вашей системе.
Попытка оплаты продолжается независимо от действий клиента. При интеграции только через API ваш бэкенд проверяет её статус через API. При использовании Hosted Checkout платформа Volet.com отправляет уведомление на ваш Status URL.
Ваш бэкенд проверяет статус платежа через API.
После подтверждения завершения платежа ваша система отмечает заказ как оплаченный и запускает его выполнение.
Если клиент возвращается на ваш сайт, он видит обновлённый статус заказа.
Важно: закрытие страницы оплаты не отменяет и не подтверждает платёж. Именно ваш бэкенд, а не перенаправление в браузере, определяет, когда можно выполнять заказ.
Обработка статусов и восстановление после сбоев. При работе только через API вашей команде нужно выбрать стратегию опроса (как часто бэкенд проверяет статус), избегать лишних запросов и обрабатывать временные сбои проверки, не допуская ошибочного изменения статуса заказа.
Считайте уведомление сигналом, а не подтверждением оплаты: проверьте его подпись и запросите данные заказа через API, прежде чем выполнять заказ. Обрабатывайте каждый заказ только один раз, используя собственный orderId, чтобы повторное уведомление или повторная проверка статуса не привели к повторному выполнению заказа.
Выполняйте заказ только после того, как API подтвердит завершение платежа, а не после успешного создания счёта или перенаправления в браузере. Точные значения статусов и порядок обработки каждого из них описаны в документации API.
Время ожидания ответа на запрос может истечь, даже если удалённая система уже обработала его. Не пытайтесь повторно создать счёт вслепую, если результат запроса неизвестен. Прежде чем решать, что делать дальше, сохраните в журнале полученный от API errorId, проверьте текущее состояние заказа и платежа и следуйте порядку обработки ошибок из документации. Никогда не создавайте дубликат заказа автоматически и повторяйте запрос только тогда, когда это безопасно.
Безопасность и готовность к эксплуатации. Храните секретные ключи API и данные аутентификации на сервере. Никогда не размещайте их в коде фронтенда, мобильных приложениях, ботах или клиентских скриптах. Выдавайте только те разрешения, которые нужны для интеграции, и ограничьте доступ к API IP-адресами ваших серверов: в рабочей среде не рекомендуется разрешать доступ со всех IP-адресов.
Как спроектировать надёжный процесс оплаты
Процесс оплаты должен учитывать не только успешный сценарий.
Определите, как должен работать продукт, если:
время ожидания при создании счёта истекло, а результат неизвестен;
при проверке статуса возникает временный сбой;
срок действия счёта истёк до того, как клиент оплатил его;
клиент покинул страницу оплаты, а затем вернулся;
клиент предпринимает ещё одну попытку оплаты;
уведомление о статусе задерживается или приходит несколько раз.
Цель — избежать повторного выполнения заказа, сохранить согласованность его состояния во внутренней системе и объяснить клиенту, что делать дальше.
У Volet.com нет песочницы или тестовой среды. Учтите это заранее, а не в момент запуска:
Запросите демонстрацию у отдела продаж Volet.com, чтобы до начала разработки увидеть, как проходит оплата и работают API и Hosted Checkout.
Создайте шлюз заранее. Новый кастодиальный шлюз (в котором Volet.com хранит полученные средства на вашем аккаунте) проходит комплаенс-проверку, которая обычно занимает несколько часов. За это время вы можете завершить интеграцию.
Проведите тесты с реальными платежами в рабочей среде: проверьте успешную оплату, сбой, истечение срока действия счёта, недоплату и переплату. Каждый тестовый криптоплатёж — это реальная транзакция в блокчейне с комиссией сети.
Для Hosted Checkout также проверьте доставку уведомлений на Status URL, корректность проверки подписи и перенаправления при успешной и неуспешной оплате.
Помечайте тестовые заказы в базе данных, чтобы при сверке они не смешивались с реальной выручкой.
Как реалистично оценить объём работ
Фактические трудозатраты зависят от существующей архитектуры оплаты, требований к пользовательскому опыту, опыта работы ваших разработчиков с платёжными API и объёма тестирования (QA).
Направление работ
Только API
Hosted Checkout
Настройка аккаунта и шлюза
Верификация аккаунта, настройка API, разрешений и получение одобрения
Верификация аккаунта, настройка Hosted Checkout и получение необходимых одобрений
Основная разработка
Создание счетов, платёжный интерфейс, проверка статусов и обновление заказов
Перенаправление на страницу оплаты, обработка уведомлений на Status URL и обновление заказов на бэкенде
Нестандартные ситуации
Истечение срока действия счетов, тайм-ауты с неопределённым результатом, повторные запросы, дублирующие попытки оплаты и инструкции по выбору сети
Проверка уведомлений, нестандартные ситуации при перенаправлении и сверка платежей
Тестирование
Отображение платёжных реквизитов, проверка статусов, истечение срока действия счетов, сбои и восстановление
Перенаправления, доставка уведомлений, проверка подписей и сверка платежей
Дальнейшее сопровождение
Поддержка интерфейса, мониторинг, диагностика проблем для службы поддержки и обработка статусов
Мониторинг бэкенда, сверка заказов и обработка обратных вызовов
Оценивайте трудозатраты на успешный сценарий и сценарии сбоев отдельно. Заложите время на сквозное тестирование и мониторинг в рабочей среде.
Сколько это стоит в Volet.com
От 0,25% за платежи в стейблкоинах и криптовалютах. Конвертация между USD, USDT и USDC — по фиксированному курсу 1:1; тарифы на другие конвертации рассчитываются отдельно. Комиссию сети блокчейна оплачивает клиент. Нет платы за подключение и ежемесячной платы. Вы выбираете, кто оплачивает комиссию за обработку платежа. При больших объёмах можно согласовать индивидуальные тарифы с отделом продаж.
Принимайте USDT, USDC и другие популярные токены по всему миру
Начните с криптоплатёжного шлюза — зачисление сразу, комиссия от 0,25%
Нет. У Volet.com нет тестовой среды. Вы можете запросить демонстрацию у отдела продаж. Перед запуском проверьте на своей стороне успешные и неуспешные платежи, истечение срока действия счёта, недоплату и переплату.
Новые кастодиальные шлюзы сначала проходят комплаенс-проверку. Обычно это занимает несколько часов. Перед созданием шлюза ваш аккаунт должен пройти верификацию. Пока идёт проверка, завершите интеграцию.
Нет. При интеграции только через API ваш бэкенд самостоятельно проверяет статус платежа. Если вам нужны уведомления, используйте Hosted Checkout вместе с API.
В настройках шлюза вы определяете, принимать ли недоплату и переплату. Если платёж поступает после истечения срока действия счёта, Volet.com либо возвращает его клиенту, либо в некоторых случаях зачисляет средства на ваш аккаунт. Если клиент всё ещё хочет оплатить заказ, может потребоваться новый запрос на оплату.
Прежде чем отвечать, проверьте заказ через API по вашему orderId.
Перевод может отображаться в блокчейне, но не соответствовать счёту: сумма может быть меньше требуемой, платёж может поступить позже срока или через другую сеть.
Предоставьте своей службе поддержки доступ к данным платежей и заранее определите, в каких случаях следует передавать обращение в поддержку Volet.com.
Нет. Подтверждённую транзакцию в блокчейне нельзя отменить, а чарджбэков через карточные платёжные системы здесь нет. Возврат — это отдельный платёж в соответствии с вашей политикой возвратов и применимыми нормами защиты прав потребителей.
Нет. Volet.com не предоставляет карточный эквайринг. Для прямого приёма платежей по картам продолжайте пользоваться услугами своего эквайера.