Перейти к основному содержимому

Создание платёжного шлюза

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

Для некастодиальных платёжных интеграций аккаунт Volet.com не нужен. За подробностями интеграции свяжитесь с нашей командой.

Выбор способа интеграции​

  • Выбирайте Hosted Checkout, если нужна самая быстрая интеграция с готовой страницей оплаты, размещённой на стороне Volet.com. Это также единственный способ интеграции, который поддерживает оплату с баланса аккаунта Volet.com.
  • Выбирайте API, если хотите построить собственный платёжный сценарий и полностью контролировать опыт клиента.

Сравните API, Hosted Checkout и Smart Contracts, чтобы выбрать способ интеграции, подходящий вашему бизнесу.

примечание

Эти настройки можно изменить в любой момент после создания шлюза.

Вариант 1. Создание шлюза Hosted Checkout​

Шаг 1. Создайте Hosted Checkout​

Войдите в личный кабинет Volet.com, откройте раздел «Платёжные инструменты» и нажмите «Создать» в блоке Hosted Checkout.

Шаг 2. Настройте платёжные методы​

На первой вкладке включите платёжные методы, которые хотите принимать:

МетодОписание
Пользователи Volet.comКлиенты платят со своего аккаунта Volet.com.
КриптокошелькиКлиенты платят в BTC, ETH, USDT, USDC и других поддерживаемых токенах с любого криптокошелька.

Подробнее о каждом методе:

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

Шаг 3. Настройте параметры​

Настройте страницу Hosted Checkout и URL для уведомлений.

Параметры обработки платежей​

  1. Использовать цифровую подпись в запросах Hosted Checkout.

    Подписывает платёжные запросы и уведомления паролем Hosted Checkout. Это помогает убедиться, что запросы исходят от Volet.com и не были изменены при передаче.

    Рекомендуем не отключать этот параметр в рабочей среде.

  2. Принимать недоплату.

    Позволяет завершать заказ, если клиент отправил меньше запрошенной суммы.

    Это полезно для криптоплатежей, где из-за комиссий сети, ручного расчёта или колебаний курса платёж может оказаться немного меньше ожидаемого.

  3. Принимать переплату.

    Позволяет завершать заказ, если клиент отправил больше запрошенной суммы.

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

Настройки Hosted Checkout​

  1. Название Hosted Checkout. Название, по которому этот Hosted Checkout определяется внутри аккаунта Volet.com.

  2. URL сайта, мобильного приложения, бота или ИИ-агента. Укажите публичный URL, связанный с этим платёжным шлюзом. Этот URL также показывается клиентам во время оплаты.

Примеры:

  1. Email для уведомлений. Необязательный адрес, на который приходят уведомления о транзакциях через эту конфигурацию Hosted Checkout.

  2. Email, отображаемый в Hosted Checkout. Зарезервировано для будущего использования.

  3. Пароль Hosted Checkout. Секретный ключ для подписи платёжных запросов и проверки уведомлений. Храните его в тайне и не размещайте в клиентском коде.

Настройка URL статусов​

Затем настройте URL для уведомлений и перенаправления. Эти параметры можно не задавать и/или передавать в форме платёжного запроса.

  1. Success URL. URL, на который клиент перенаправляется после успешного платежа.

  2. Failed URL. URL, на который клиент перенаправляется, если платёж не прошёл или отменён.

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

Для Success URL, Failed URL и Status URL можно выбрать HTTP-метод:

  • GET — параметры передаются в строке запроса.
  • POST — параметры передаются в теле запроса.

Шаг 4. Настройте внешний вид (необязательно)​

Необязательный шаг, его можно выполнить позже.

Страницу Hosted Checkout можно оформить своим логотипом и фирменными цветами.

Шаг 5. Одобрение​

Новые шлюзы перед приёмом реальных платежей должны быть одобрены администратором.

Одобрение обычно занимает несколько часов.

Когда шлюз будет одобрен и готов к работе, вы получите уведомление по email.

примечание

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

Шаг 6. Интегрируйте Hosted Checkout​

После одобрения можно интегрировать Hosted Checkout в сайт, приложение, бот или ИИ-агента.

См.: Интеграция Hosted Checkout

Вариант 2. Создание API-шлюза​

Шаг 1. Создайте API-шлюз​

Войдите в личный кабинет Volet.com, откройте раздел Платёжные инструменты и нажмите Создать в блоке API.

Шаг 2. Настройте параметры API​

Настройте основные параметры API.

  1. Название API. Внутреннее название API-шлюза. Используется только внутри аккаунта Volet.com.

  2. Белый список IP. Список IP-адресов, которым разрешён доступ к API.

    Можно:

    • Ввести один или несколько IP-адресов вручную.
    • Нажать Добавить текущий IP, чтобы автоматически добавить ваш текущий IP-адрес.
    • Включить Разрешить все IP, чтобы снять ограничения по IP (не рекомендуется для рабочей среды).

  3. Пароль API. Секретный ключ для аутентификации запросов к API. Храните его в тайне и не размещайте в клиентском коде.

  4. URL сайта, мобильного приложения, бота или ИИ-агента. Укажите публичный URL, связанный с этой API-интеграцией.

Примеры:

  1. Email для уведомлений. Необязательный адрес, на который приходят уведомления о транзакциях через этот API-шлюз.

Шаг 3. Настройте права API​

Выберите, какие права будут доступны этому API-шлюзу.

Для интеграций по приёму платежей включите:

  • Совершать транзакции
    • Принимать криптоплатежи — позволяет приложению создавать платёжные инвойсы и принимать криптоплатежи с криптокошельков.
  • Поиск транзакции — позволяет приложению получать статус платежа и детали транзакции после создания инвойса.

API-интеграции не используют URL для уведомлений. После создания инвойса приложение должно проверять текущий статус платежа через Поиск транзакции.

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

Шаг 4. Одобрение​

Новые API-шлюзы перед проведением реальных транзакций должны быть одобрены администратором.

Одобрение обычно занимает несколько часов.

Когда API-шлюз будет одобрен и готов к работе, вы получите уведомление по email.

примечание

Пока API-шлюз не одобрен, реальные транзакции проводить нельзя.

Шаг 5. Интеграция​

После одобрения можно начинать принимать платежи через API.

См.:

  • Интеграция по API — инструкция по интеграции платёжного шлюза через API.
  • Справочник API — полное описание методов, параметров и ответов.