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

Введение

Merchant API Volet.com позволяет вашему приложению принимать криптоплатежи, отправлять выплаты и переводы, отслеживать транзакции и получать данные аккаунта, например балансы, тарифы и лимиты.

Пошаговые сценарии — в руководствах: Интеграция по API для приёма платежей и Интеграция по API для массовых выплат.

Базовый URL​

https://api.volet.com

Все эндпоинты указываются относительно этого URL, например https://api.volet.com/api/account/balances.

Перед началом​

У Volet.com нет песочницы. Проверяйте интеграцию на небольших реальных транзакциях.

Аутентификация​

Каждый запрос содержит три заголовка:

ЗаголовокЗначение
Api-NameНазвание API в вашем аккаунте Volet.com
Account-EmailАдрес электронной почты аккаунта Volet.com, которому принадлежит API
Authentication-TokenТокен SHA-256, сгенерированный из пароля API и текущих даты и часа в UTC

Генерация токена аутентификации​

  1. Составьте строку password:YYYYMMDD:HH, где password — пароль API, а дата и час указаны в UTC.
  2. Вычислите хеш SHA-256 этой строки.
  3. Передайте хеш строкой в шестнадцатеричном виде в заголовке Authentication-Token. API не проверяет регистр букв; обычно используют строчные.

Например, для пароля MySecret123 в 14:00 UTC 26 октября 2026 года:

SHA256("MySecret123:20261026:14")

даёт:

c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd

Токен меняется каждый час по UTC. Генерируйте его непосредственно перед каждым запросом. API также принимает токены предыдущего и следующего часа, поэтому запрос, отправленный на стыке часов или с сервера с немного неточными часами, не будет отклонён.

В панели Try it каждого метода можно ввести пароль API и сгенерировать токен в браузере. Пароль никуда не отправляется.

Храните пароль на сервере

В API отправляется только токен, никогда не пароль. Не размещайте пароль API и токены во фронтенд-коде, мобильных приложениях, ботах и других клиентских скриптах.

Формат запросов​

  • Запросы и ответы передаются в формате JSON по HTTPS. С телом запроса отправляйте Content-Type: application/json.
  • Суммы — десятичные числа, например "amount": 100. API также принимает их строками, например "amount": "100.00". Число знаков после запятой зависит от валюты.
  • Коды стейблкоинов содержат сеть там, где средства идут через блокчейн, например USDT_TRC20; валюты кошельков указываются без сети, например USDT. См. Коды валют и суммы.

Пример запроса:

curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Account-Email: [email protected]" \
-H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd"

Ограничение числа запросов​

Для личных аккаунтов и для бизнес-аккаунтов, которые не прошли верификацию, API ограничивает число запросов в час. Когда лимит исчерпан, API возвращает HTTP 401 с ошибкой attemptsHaveEndedException. Подождите и отправьте запрос позже. У верифицированных бизнес-аккаунтов этого часового лимита нет.