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

Интеграция за один шаг

Криптоплатёжный шлюз для Telegram-ботов и крипто-сервисов.

Получите API-ключ и промпт для интеграции в нашем Telegram-боте. Вставьте промпт в своего ИИ-агента и начните принимать криптоплатежи. Читать документацию по API не нужно.

Получить API-ключ

Подключение за 3 шага

  1. Откройте нашего Telegram-бота. За секунды вы получите API-ключ и промпт для интеграции для вашего ИИ-агента.

  2. Claude Code, Cursor или любой другой ИИ-агент для кода читает нашу документацию и пишет интеграцию: платёжную ссылку, вебхук и проверку подписи.

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

Монеты

Приём USDT, USDC, BTC, ETH, GRAM и ещё 8 монет

13 монет в 12 сетях

  • AVAX
  • BNB
  • BTC
  • DOGE
  • ETH
  • GRAM
  • LTC
  • POL
  • SOL
  • TRX
  • USDC
  • USDT
  • XMR

Сети: Tron (TRC-20) · TON · Ethereum (ERC-20) · BNB Chain (BEP-20) · Solana · Polygon · Base · Avalanche C-Chain · Bitcoin · Litecoin · Dogecoin · Monero

Покупатель платит из любого кошелька

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

Как платит покупатель?

Мы следим за блокчейнами. Вы отгружаете.

Мы следим за всеми 12 сетями и отправляем вашему серверу подписанный вебхук, когда платёж подтверждён.

Документация по API для приёма криптоплатежей

Telegram

Создан для Telegram-ботов, мини-приложений и крипто-сервисов.

Один API-ключ работает для всех трёх вариантов. Правила Telegram определяют, какие монеты где можно показывать, и страница оплаты им следует.

Telegram-боты

Все 13 монет для физических товаров, офлайн-услуг и продаж на вашем сайте. Цифровые товары, продаваемые внутри Telegram, остаются на Telegram Stars.

Мини-приложения

Telegram разрешает в мини-приложениях только монеты TON, поэтому страница оплаты показывает GRAM и USDT в сети TON на вашем домене.

Крипто-сервисы и сайты

Принимайте USDT в 8 сетях, USDC в 5, а также BTC, ETH, GRAM и ещё 8 монет: с платёжными ссылками, подписанными вебхуками и выплатами, которые одобряете вы, из одного API.

Как принимать криптоплатежи в Telegram-боте

Один вызов, чтобы получить оплату. Один вебхук, чтобы отгрузить.

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

Вот и вся интеграция

  1. Шаг 1

    Получите API-ключ

    Откройте нашего Telegram-бота. За секунды вы получите API-ключ и промпт для интеграции для вашего ИИ-агента. Тестовый режим работает сразу.

    Получить API-ключ

    Ravelo Bot

    бот

    /start

    Ваш тестовый API-ключ готов:

    rvk_test_8f3k…x9Kp

  2. Шаг 2

    Один вызов

    Создайте платёжную ссылку с собственной суммой и адресом. Отправьте её в чате, по почте или разместите на сайте.

    POST /v1/payment-intents
    POST /v1/payment-intents
{
  "order_ref": "1042",
  "asset_id": "usdt-tron",
  "amount": "25000000"        // 25 USDT
}

201 Created
{
  "status": "requires_payment",
  "instructions": { "address": "TQ7a…3fK" }
}

  3. Шаг 3

    Покупатель платит

    Из любого кошелька: точная сумма, до истечения срока, с QR-кодом.

    Заказ #1042

    14:59

    25.00 USDT

    TQ7a…3fK · TRON (TRC-20)

    Оплатить до 12:30

  4. Шаг 4

    Один вебхук

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

    webhook
    POST https://your-bot.app/webhook
ravelo-signature: verified

{
  "type": "payment_intent.succeeded",
  "data": { "order_ref": "1042", … }
}

    Вы отгружаете заказ. Это всё.

Разработчикам

Один API для криптоплатежей, SDK и вебхуки, которые можно проверить.

REST API с SDK для TypeScript и Python, документация по быстрому старту и тестовый режим. Каждый вебхук подписан, поэтому ваш сервер может доказать, что он пришёл от нас. Ключи могут создавать платежи и готовить выплаты. Одобрить вывод денег можете только вы.

  • Ключи, которые не опустошат ваш баланс

    API-ключи могут создавать платежи и готовить выплаты. Ни один из них не может отправить деньги. Для этого нужно ваше одобрение.

  • Безопасные повторы

    Отправьте один и тот же запрос дважды с одним ключом идемпотентности, и получится один платёж, а не два.

  • Каждый вызов в журнале

    Каждый вызов API и MCP журналируется: какой ключ, какой инструмент, что запрошено.

Документация по API для приёма криптоплатежей

Создать платёжную ссылку

import { Ravelo } from "@ravelo/sdk";

const ravelo = new Ravelo({
  apiKey: process.env.RAVELO_TEST_KEY,
  baseUrl: process.env.RAVELO_API,
});

// 25 USDT on TRON, in base units (6 decimals)
const intent = await ravelo.paymentIntents.create({
  order_ref: "1042",
  asset_id: "usdt-tron",
  amount: "25000000",
});

console.log(intent.instructions.address); // send your buyer here

Проверить вебхук

import { verifyWebhook } from "@ravelo/sdk";

// Verify the raw bytes exactly as they arrived
const event = await verifyWebhook(
  rawBody,
  req.headers["ravelo-signature"],
  process.env.RAVELO_WEBHOOK_SECRET,
); // throws if the body or signature was forged

if (event.type === "payment_intent.succeeded") {
  ship(event.data.order_ref);
}

ИИ-агенты для кода

Или интегрируйте одним промптом.

Вставьте промпт для интеграции из нашего бота в своего ИИ-агента.

Claude Code, Cursor или любой другой ИИ-агент для кода читает нашу документацию и пишет интеграцию: платёжную ссылку, вебхук и проверку подписи. Подключите наш MCP-сервер, и ИИ-ассистент сможет также создавать платёжные ссылки и проверять платежи. Выплату он никогда не одобряет. Это делаете вы.

Получить API-ключ
Что бот отправляет вам, готово для вставки в ИИ-агента:
Integrate Ravelo crypto payments
into this project.
API key (test): rvk_test_••••
1. Read the docs: https://ravelopay.app/llms.txt
2. Add a /buy command that creates a
   payment link with one API call.
3. Add a webhook that checks the
   signature and ships the order.
4. Run one test payment.

Безопасность

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

У каждого заказа своя платёжная ссылка и страница оплаты: цена в крипте или в вашей валюте, точная сумма, QR-код и срок оплаты.

Поддельные монеты блокируются

Мы засчитываем только монеты с проверенных контрактов токенов. Токен-двойник никогда не отметит заказ оплаченным.

Недоплата, опоздание или не та монета

В заказе видно, что именно пришло и когда. К отгрузке ничего не готово, пока не поступит вся сумма.

Оплачено, затем готово к отгрузке

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

Не нужно запускать ноду

Мы следим за всеми 12 сетями. Ваш сервер получает весть от нас только при изменении платежа.

Выплаты

Выплаты, которые одобряете вы

Деньги уходят только по вашей команде.

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

Личный кабинет

Все платежи, балансы и выплаты в одном месте.

Создавайте платёжные ссылки через API или стройте на нём собственную страницу оплаты. Все платежи попадают в один кабинет и отслеживаются от оплаты до вывода.

  • Статус каждого платежа

    Оплачено, готово к отгрузке и выведено, со всеми пришедшими переводами.

  • Выписки в CSV

    Выгружайте платежи и выплаты в CSV для бухгалтера.

  • Роли в команде

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

  • Балансы по монетам

    Доступные, ожидающие и удержанные средства всегда показаны отдельно. Вы всегда знаете, сколько можно вывести.

  • Полный и частичный возврат

    Возвращайте заказ целиком или частично на проверенный адрес. Сумма возвратов никогда не превысит оплаченное покупателем.

  • Тестовые и рабочие ключи

    Разрабатывайте в тестовом режиме, затем переключитесь на рабочий ключ. Тестовые платежи никогда не двигают реальные деньги.

Тарифы

Тарифы: 3% с платежа, без платы за подключение и ежемесячной платы

Когда вам платят

3% с платежа

Удерживается с каждого подтверждённого платежа. Без фиксированной комиссии сверху, поэтому мелкие продажи остаются выгодными: продажа на $5 стоит 15¢.

Получить API-ключ
  • Покупатель платит 100 USDT, вы получаете 97 USDT
  • Без платы за подключение и ежемесячной платы
  • Тестовый режим бесплатный
  • Стоимость сети показывается перед каждой выплатой

Вопросы и ответы

Криптоплатёжный шлюз: вопросы и ответы

О чём спрашивают разработчики перед подключением. Не нашли ответ? Спросите нас в Telegram.

  • API-ключ вы получаете за секунды в нашем Telegram-боте, вместе с промптом для интеграции для вашего ИИ-агента. Один вызов API создаёт первую платёжную ссылку в тестовом режиме. Рабочие платежи начинаются, как только ваш аккаунт включён.

  • Готовая инструкция для вашего ИИ-агента, например Claude Code или Cursor. Бот присылает её вместе с API-ключом. Вставьте её, и агент добавит в проект платёжную ссылку и проверяемый вебхук. Затем вы запускаете тестовый платёж.

  • USDT в сетях Tron (TRC-20), TON, Ethereum (ERC-20), BNB Chain (BEP-20), Solana (SPL), Polygon, Base и Avalanche C-Chain. USDC в сетях Ethereum (ERC-20), Solana (SPL), Polygon, Base и Avalanche C-Chain. ETH в сетях Ethereum и Base. Плюс BTC, GRAM, SOL, TRX, BNB, POL, AVAX, LTC, DOGE и XMR, каждая в своей сети. GRAM — собственная монета TON, ранее называлась Toncoin.

  • Вы отправляете покупателю платёжную ссылку. Он платит точную сумму из любого кошелька до истечения срока, а ваш сервер получает подписанный вебхук.

  • Да, в рамках правил Telegram: все 13 монет в обычных ботах для физических товаров, офлайн-услуг и вашего сайта, а GRAM и USDT в сети TON в мини-приложениях.

  • Только для цифровых товаров и услуг, продаваемых внутри Telegram: для них Telegram требует Stars. Для физических товаров, офлайн-услуг и продаж на вашем сайте можно принимать крипту через Ravelo.

  • Мы проверяем платёж в блокчейне и по проверенным контрактам монет, прежде чем засчитать его. Токен-двойник никогда не отметит заказ оплаченным.

  • Нет. Мы следим за всеми 12 сетями и отправляем вашему серверу подписанный вебхук, когда платёж подтверждён.

  • Нет. Он может создавать платёжные ссылки и готовить возврат или выплату. Одобряете их только вы, с помощью passkey.

  • 3% с каждого подтверждённого платежа. Без платы за подключение и ежемесячной платы. Расходы сети показываются до оплаты покупателем и до одобрения выплаты.

  • Да, и вы задаёте их сами: на выплату, на день и на месяц. Новый адрес для вывода ждёт 24 часа, прежде чем сможет получать деньги, поэтому украденный вход не опустошит ваш баланс.

Начните принимать криптоплатежи сегодня.

Откройте бота: вы получите API-ключ и промпт для интеграции. Вставьте промпт в своего ИИ-агента или сделайте один вызов API сами. Блокчейн мы берём на себя.

Получить API-ключПосмотреть код