Перейти до вмісту

Інтеграція за один крок

Криптоплатіжний шлюз для 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-ключПереглянути код