Moove API
Один запрос. Вся сумма — вам.
Создайте платёжную ссылку из своего кода. Клиент платит любым токеном, а вы получаете всю сумму в своём.
От ключа до первого платежа.
Создайте API-ключ
В Moove Business создайте ключ для Moove Receive Agent. Он показывается один раз, поэтому сразу добавьте его в своё окружение.Создайте платёжную ссылку
Один POST-запрос возвращает URL страницы оплаты. Клиент платит там любым токеном в любой сети.Узнайте об оплате
Зарегистрируйте HTTPS-эндпоинт, и Moove отправит на него подписанное событие, как только ссылка будет оплачена.
Компактный API. Надёжные гарантии.
Платят любым токеном — получаете свой
Клиенты платят тем, что у них есть, в 30+ блокчейн-сетях. Каждый платёж зачисляется на ваш кошелёк — в выбранном вами токене и сети.Контракт, на который можно опереться
Версия в пути URL, в v1 только добавления, актуальная схема OpenAPI.Понятные лимиты и ошибки
Лимиты на ключ и на IP, понятный 429 и единый формат ошибок со стабильными кодами.Сам API бесплатен.
Без подписки и без платы за вызов. Клиент, который платит другим токеном или в другой сети, сам покрывает 0,02 %, поэтому вы получаете всю сумму.- Доступ к API
- Бесплатно
- Тот же токен, та же сеть
- Бесплатно
- Между токенами или сетями
- 0,02 %
Moove или собственная разработка.
| Moove или собственная разработка. | Moove | Своими силами |
|---|---|---|
| Поддерживаемые сети | Moove: 30+ через один эндпоинт | Своими силами: Отдельная интеграция для каждой сети |
| Конвертация в ваш токен | Moove: Встроена в каждый платёж | Своими силами: Собственная маршрутизация свопов и бриджей |
| Подтверждение оплаты | Moove: Подписанные вебхуки и эндпоинт списка | Своими силами: Свой мониторинг для каждой сети |
| Страница оплаты | Moove: Готовая ссылка, которой можно сразу поделиться | Своими силами: Дизайн, разработка и хостинг — на вас |
| Если ключ утечёт | Moove: Он может лишь запрашивать оплату в вашу пользу | Своими силами: Всё, что лежит на горячем кошельке |
Часто задаваемые вопросы.
Как получить API-ключ?
Войдите в консоль Moove Business и откройте раздел «API-ключи». Задайте имя ключа и выберите Moove Receive Agent — он даёт право создавать и просматривать платёжные ссылки. Полный ключ показывается один раз, при создании, и больше никогда, поэтому храните его в менеджере секретов. Эндпоинта для создания ключей нет, так что один ключ никогда не сможет выпустить другой.
Куда поступают деньги, когда клиент платит?
На основной кошелёк владельца ключа — в сети и токене расчёта этого кошелька. Вызывающая сторона не может указать другого получателя. Поэтому до первого вызова у аккаунта должны быть свой Moove handle и основной кошелёк с токеном расчёта; если чего-то из этого нет, создание ссылки вернёт 409 с сообщением, что аккаунт не готов принимать платежи.
Есть ли API для выплат?
Пока нет. API принимает платежи, но не отправляет их. Чтобы уже сейчас платить поставщикам или подрядчикам, используйте раздел «Отправить» в консоли Moove Business. Moove Send Agent уже анонсирован и появится в документации после запуска.
Как работают вебхуки Moove?
Зарегистрируйте в консоли до пяти HTTPS-эндпоинтов. Каждый получает два события: одно — когда платёж по ссылке проходит расчёт, другое — когда ссылка завершена. Доставки подписываются HMAC-SHA256 секретом, который показывается один раз. Доставка выполняется как минимум один раз, поэтому устраняйте дубликаты по id события. Неудачная доставка повторяется до шести раз.
Есть ли ограничения частоты запросов?
Да. Запросы ограничены по API-ключу и по IP-адресу источника — срабатывает тот лимит, который достигнут первым, — а превышение возвращает 429. Вместо немедленного повтора используйте экспоненциальную задержку с небольшим джиттером: отклонённые запросы тоже учитываются. Получайте статус платежей через вебхуки, а не опрашивайте одну ссылку, и учитывайте лимит по IP, если несколько интеграций работают на одном хосте.
Как устроено версионирование API?
В пути URL. Сейчас есть одна публичная версия — v1. Изменения внутри версии только добавляют: новые эндпоинты, новые необязательные поля, новые поля ответа. Всё, что может сломать клиент, например удаление поля или смена типа, выходит в новой версии пути. Пишите клиент так, чтобы он игнорировал неизвестные поля и ветвился по кодам ошибок, а не по сообщениям.
