Telegramボット
物販、現実世界のサービス、自社サイトでの販売で、13コインすべてを利用できます。Telegram内で販売するデジタル商品は、引き続きTelegram Starsを使用します。
ワンショット連携
Telegramボットと暗号資産サービスのための暗号資産決済ゲートウェイ
TelegramボットからAPIキーと連携プロンプトを取得し、プロンプトをコーディングエージェントに貼り付ければ、暗号資産決済の受け付けを開始できます。APIドキュメントを読む必要はありません。
3ステップで接続
Telegramボットを開くと、数秒でAPIキーと、コーディングエージェント向けの連携プロンプトが届きます。
Claude Code、Cursor、その他のコーディングエージェントが当社のドキュメントを読み、決済リンク、Webhook、署名検証の連携コードを書きます。
オンチェーンで決済を確認し、偽コインをブロックしたうえで、署名付きWebhookをお客様のサーバーに送信します。あとは注文を出荷するだけです。
対応コイン
USDT、USDC、BTC、ETH、GRAMなど13コインで暗号資産決済を受け付け
12ネットワーク・13コインに対応
- 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
購入者は好きなウォレットから支払い
購入者に決済リンクを送るだけです。購入者は期限内に任意のウォレットから正確な金額を支払い、お客様のサーバーには署名付きWebhookが届きます。
購入者はどう支払うのですか？Telegram
Telegramボット、Mini Apps、暗号資産サービスのために。
APIキー1つで3つすべてに対応します。どこにどのコインを表示できるかはTelegramのルールで決まり、チェックアウトはそれに従います。
Mini Apps
TelegramがMini Appsで認めているのはTONのコインのみのため、チェックアウトには、お客様のドメイン上でTON上のGRAMとUSDTが表示されます。
暗号資産サービスとウェブサイト
8つのネットワークのUSDT、5つのネットワークのUSDC、さらにBTC、ETH、GRAMなど13コインを、決済リンク、署名付きWebhook、承認制の出金とあわせて、1つのAPIで受け付けられます。
Telegramボットで暗号資産決済を受け付ける方法
受け取りはAPI1回、出荷はWebhook1つ。
API呼び出し1回で暗号資産の決済リンクを作成できます。オンチェーンで入金が確認されると、署名付きWebhookでサーバーに1度だけ通知されます。ノードの運用も、ポーリングも、フォームも不要です。
連携はこれですべてです
Ravelo Bot
ボット
/startテスト用APIキーの準備ができました：
rvk_test_8f3k…x9Kp
ステップ2
呼び出しは1回
金額とアドレスが個別に割り当てられた決済リンクを作成します。チャット、メール、自社サイトで送付できます。
POST /v1/payment-intentsPOST /v1/payment-intents { "order_ref": "1042", "asset_id": "usdt-tron", "amount": "25000000" // 25 USDT } 201 Created { "status": "requires_payment", "instructions": { "address": "TQ7a…3fK" } }ステップ3
購入者が支払う
任意のウォレットから、期限内に正確な金額を、QRコードで支払えます。
注文 #1042
14:5925.00 USDT
TQ7a…3fK · TRON (TRC-20)
12:30までにお支払いください
ステップ4
Webhookは1つ
オンチェーンで決済を確認し、偽コインをブロックしたうえで、署名付きWebhookをサーバーに送信します。あとは注文を出荷するだけです。
webhookPOST https://your-bot.app/webhook ravelo-signature: verified { "type": "payment_intent.succeeded", "data": { "order_ref": "1042", … } }あとは出荷するだけです。
開発者向け
暗号資産決済API、SDK、検証できるWebhookを1つに。
REST APIに加え、TypeScript・Python SDK、クイックスタートドキュメント、テストモードを用意しています。すべてのWebhookに署名が付くため、当社から送信されたものであることをサーバー側で検証できます。キーで可能なのは決済の作成と出金の準備のみです。資金の送金を承認できるのはあなただけです。
資金を抜き取れないキー
APIキーでは、決済の作成と出金の準備ができます。資金を送金することはできません。送金にはあなたの承認が必要です。
安全に再試行できる
同じ冪等性キーで同じリクエストを2回送っても、決済は2件ではなく1件だけ作成されます。
すべての呼び出しを記録
APIとMCPの呼び出しはすべて記録されます。どのキーが、どのツールで、何をリクエストしたかを確認できます。
決済リンクを作成
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
Webhookを検証
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);
}
AIコーディングエージェント
プロンプト1つで連携も完了。
ボットから受け取った連携プロンプトを、AIコーディングエージェントに貼り付けるだけです。
Claude Code、Cursor、その他のAIコーディングエージェントが当社のドキュメントを読み、決済リンク、Webhook、署名検証までの連携コードを書きます。MCPサーバーを接続すれば、AIアシスタントが決済リンクの作成や決済状況の確認も行えます。出金を承認することはありません。承認するのはあなたです。
ボットから届く、コーディングエージェントにそのまま貼り付けられるプロンプト：
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コード、期限を表示します。
偽コインをブロック
検証済みのトークンコントラクトのコインだけを入金として計上します。偽トークンで注文が支払い済みになることはありません。
不足額、遅延、別コインの入金にも対応
何がいつ届いたかを、注文画面で正確に確認できます。全額が入金されるまで、出荷可能にはなりません。
支払い済み、そして出荷可能
状態を2つに分けているため、資金が確定してからのみコードが出荷処理を行います。サンクスページを開いただけでは入金扱いになりません。
ノードの運用は不要
12ネットワークすべてを当社が監視します。決済に変化があったときだけ、お客様のサーバーに通知します。
出金
あなたが承認する出金
資金が動くのは、あなたが指示したときだけです。
出金は、保存済みのアドレスに行います。新しいアドレスは、入金を受け付けられるようになるまで24時間待機します。バックエンドやAIアシスタントが出金や返金を準備することはできますが、指紋、顔、またはセキュリティキーであなたが承認するまで、資金は動きません。
ダッシュボード
すべての決済、残高、出金を1か所で管理。
APIで決済リンクを作成することも、それをベースに独自のチェックアウトを構築することもできます。すべての決済は1つのダッシュボードに集約され、支払いから出金まで追跡できます。
Ravelo/ウォレットと決済リアルタイム残高
合計額
$9,640.62
USD換算、1時間ごとの価格
利用可能
$9,315.62
出金可能
保留中
$250.00
オンチェーンで検証中
ホールド中
$75.00
24時間のアドレス待機
最近の決済と出金ステータス
- ✓ 出荷可能
+25.00 USDT
注文 #1042 · TRON (TRC-20)
- ✓ 出荷可能
+140.00 USDT
注文 #1041 · TON
- 出金済み
−450.00 USDT
出金 · 保存済みウォレット
- ✓ 出荷可能
+0.42 ETH
注文 #1039 · Ethereum
決済ごとのステータス
支払い済み、出荷可能、出金済みを、着金した送金ごとに確認できます。
CSV明細
決済と出金をCSVでエクスポートして、会計担当者に渡せます。
チームの役割
共同創業者や開発者を招待できます。各メンバーは、役割で許可された内容だけを表示・操作できます。
コインごとの残高
利用可能、保留中、ホールド中の残高を分けて表示します。出金できる金額がいつでも分かります。
全額返金・一部返金
注文の全額または一部を、確認済みのアドレスに返金できます。返金額の合計が購入者の支払額を超えることはありません。
テストキーと本番キー
テストモードで開発してから、本番キーに切り替えます。テスト決済で実際のお金が動くことはありません。
料金
料金：決済ごとに3%、初期費用・月額費用なし
- 購入者が100 USDT支払うと、受取額は97 USDT
- 初期費用も月額費用もなし
- テストモードは無料
- 出金のたびにネットワーク手数料を事前に表示
よくある質問
暗号資産決済ゲートウェイのよくある質問
導入前に開発者からよくいただくご質問です。ここにない内容は、Telegramでお問い合わせください。
Telegramボットから数秒でAPIキーを取得でき、コーディングエージェント向けの連携プロンプトも届きます。API呼び出し1回で、テストモードの最初の決済リンクを作成できます。本番の決済は、アカウントが有効になり次第開始できます。
Claude CodeやCursorなどのコーディングエージェント向けに用意した、すぐに使える指示文です。ボットがAPIキーと一緒に送ります。貼り付けると、エージェントがプロジェクトに決済リンクと検証付きWebhookを追加します。あとはテスト決済を行うだけです。
Tron (TRC-20)・TON・Ethereum (ERC-20)・BNB Chain (BEP-20)・Solana (SPL)・Polygon・Base・Avalanche C-ChainのUSDT。Ethereum (ERC-20)・Solana (SPL)・Polygon・Base・Avalanche C-ChainのUSDC。EthereumとBaseのETH。さらにBTC、GRAM、SOL、TRX、BNB、POL、AVAX、LTC、DOGE、XMRに、それぞれのネットワークで対応しています。GRAMはTON独自のコインで、以前はToncoinと呼ばれていました。
購入者に決済リンクを送るだけです。購入者は期限内に任意のウォレットから正確な金額を支払い、お客様のサーバーには署名付きWebhookが届きます。
はい、Telegramのルールの範囲内で可能です。物販、現実世界のサービス、自社サイトでの販売であれば通常のボットで13コインすべてに対応し、Mini AppsではTON上のGRAMとUSDTに対応します。
Telegram内で販売するデジタル商品とサービスのみ必要です。それらにはTelegramがStarsの利用を義務付けています。物販、現実世界のサービス、自社サイトでの販売では、Raveloで暗号資産を受け付けられます。
オンチェーンの記録と、検証済みのコインコントラクトに照らして確認してから計上します。偽トークンで注文が支払い済みになることはありません。
いいえ。12ネットワークすべてを当社が監視し、決済が確認されると署名付きWebhookをお客様のサーバーに送信します。
いいえ。決済リンクの作成と、返金や出金の準備はできますが、承認できるのはあなただけです。承認にはパスキーを使います。
確認済みの各決済につき3%です。初期費用も月額費用もありません。ネットワーク手数料は、購入者が支払う前と、出金を承認する前に表示されます。
はい、お客様ご自身で設定できます。出金1回あたり、1日あたり、1か月あたりの上限です。新しい出金先アドレスは、入金を受け付けられるようになるまで24時間待機するため、ログイン情報が盗まれても残高を空にされることはありません。