recv Developer

ИдемпотентныйWeb3PaymentAPI

Ультимативный REST API для автоматизированного криптобиллинга. Интегрируйте webhook-уведомления в реальном времени, единый мультичейн мониторинг и пуленепробиваемую идемпотентность в бэкенд вашего SaaS, игры или системы автоматизации.

Протокол

Возможности API и Архитектура

recv работает как прозрачный программный слой (middleware). Транзакции идут напрямую от клиента к вам, минуя промежуточные счета. Мы лишь автоматизируем мониторинг через сеть высокопроизводительных нод.

Единый мультичейн шлюз

Хватит поддерживать кастомные RPC ноды и хрупкие слушатели блокчейнов. Одна стандартная интеграция REST API покрывает GRAM, USDT в TON, TRON, Base и BSC.

Криптографические вебхуки

Изменения статуса могут вызывать POST-вебхуки на ваш сервер. HMAC-SHA256 подпись и timestamp позволяют backend проверить источник и применить защиту от повторов.

Нативная идемпотентность

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

Testnet и Sandbox режим

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

Requests/mo50k
Seats3
Workspaces3
SupportStandard
Интеграция

Бесшовный сценарий

Шаг 01

API Key Provisioning

Генерация ключей live_. Управление правами доступа для интеграции в ваш бэкенд.

1
Шаг 02

Webhook Config

Настройка коллбэков с подписью HMAC-SHA256 для мгновенных уведомлений.

2
Шаг 03

Automated Processing

Наши вотчеры отслеживают транзакции 24/7, подтверждая платежи автоматически.

3
Пример реализации

Готов к продакшену за считанные минуты.

Бесшовная интеграция нашего протокола в ваш существующий рабочий процесс.

// Create Invoice via recv API
const res = await fetch("https://api.recv.money/v1/invoices", {
  method: "POST",
  headers: { "X-API-Key": "live_..." },
  body: JSON.stringify({
    title: "Order #99",
    base_amount_usd: "29.00",
    payable_network: "TON"
  })
});
const inv = await res.json();
Architecture

Технические характеристики Developer

Высокопроизводительные примитивы для бэкенд интеграции.

Протокол API
RESTful JSON over HTTPS
Аутентификация
Bearer Token (API Keys)
Безопасность вебхуков
Подписи HMAC-SHA256
Лимиты (Rate Limits)
До 50,000 запросов в месяц
Security & Compliance

Безопасность API и Надежность

Безопасность реализована на транспортном и прикладном уровнях. API credentials хранятся как хэши. Неуспешные вебхуки ставятся в очередь повторов согласно активному тарифу, а интеграция должна быть идемпотентной, поскольку доставка может повторяться.

Target Audience

Создано для инженеров автоматизации

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

  • Основатели SaaS, внедряющие автоматический рекуррентный криптобиллинг без фиатных процессоров.
  • Разработчики Web3 игр, которым нужны мгновенные, надежные пополнения внутриигровой валюты через TON, Base или BSC.
  • Создатели ботов для Discord и Telegram, выстраивающие платные, автоматизированные уровни доступа к сообществам.
  • Дистрибьюторы цифровых товаров, которым нужна выдача по подписанным вебхукам.
FAQ

Часто задаваемые вопросы

Когда клиент инициирует перевод, наши вотчеры мониторят соответствующий блокчейн. Как только транзакция достигает нужных подтверждений, recv отправляет JSON payload через HTTP POST на ваш endpoint с ID счета, суммой и TX hash.

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

Идемпотентность гарантирует, что независимо от того, сколько раз повторяется конкретный API запрос или вебхук (из-за сбоев сети или ошибок клиента), конечный результат остается неизменным. В крипте это жизненно важно для предотвращения 'двойных трат' или двойного предоставления пользователю премиум-подписки за одну блокчейн-транзакцию.

API recv использует протокол умного сопоставления (smart-matching) вместо генерации уникальных адресов кошельков для каждого счета (что дорого и сложно сводить/свипать). Мы используем математически уникальные десятичные окончания (например, 100.000123 USDT) или нативные memo сети (на TON), чтобы мгновенно связать одну входящую транзакцию на вашем мастер-кошельке с конкретным счетом пользователя.

В настоящее время мы предоставляем подробно задокументированный RESTful API, не зависящий от языка, который может использоваться любым современным HTTP-клиентом (Axios, Fetch, Requests). Официальные SDK для TypeScript/Node.js и Go находятся в активной разработке.

Каждый вебхук включает заголовок 'X-recv-Signature'. Вы должны использовать ваш секретный ключ вебхука (Webhook Key), чтобы вычислить хэш HMAC-SHA256 сырого тела запроса (raw request body). Если ваш вычисленный хэш совпадает с нашим заголовком, payload является подлинным и не был подделан.

Мы не устанавливаем жесткую блокировку вашего API, если у вас произошел всплеск (spike). Вы получите автоматическое уведомление по email и Telegram при приближении к лимиту (80% и 100%). Перерасход может быть оплачен по номинальной ставке, или вы можете бесшовно перейти на тариф Business.

Да. Подписчики тарифа Developer имеют доступ к приоритетной email-поддержке и выделенному каналу комьюнити разработчиков, где наши core-инженеры активно помогают с проектированием архитектуры и отладкой.

DEVELOPER PLAN
Доступ

29$

в месяц

Неограниченный оборот. Фиксированная цена.

0% TURNOVER FEESNON-CUSTODIALINSTANT PAYOUTS