Telegram 机器人
实物商品、线下服务和您自己网站的销售可使用全部 13 种币。在 Telegram 内销售的数字商品仍需使用 Telegram Stars。
一次接入
面向 Telegram 机器人和加密货币服务的支付网关。
从我们的 Telegram 机器人获取 API 密钥和接入提示词，粘贴到 AI 编程助手中，即可开始接收加密货币付款，无需阅读 API 文档。
三步完成接入
打开我们的 Telegram 机器人，几秒钟内即可获得 API 密钥和给 AI 编程助手使用的接入提示词。
Claude Code、Cursor 或其他任何 AI 编程助手会读取我们的文档并写出接入代码：收款链接、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
Telegram
专为 Telegram 机器人、Mini Apps 和加密货币服务打造。
一个 API 密钥适用于这三种场景。Telegram 的规则决定哪些币可以在哪里显示，结账页会遵循这些规则。
Mini Apps
Telegram 在 Mini Apps 中只允许 TON 币种，因此结账页会在您自己的域名下显示 TON 上的 GRAM 和 USDT。
加密货币服务和网站
通过一套 API，接收 8 条网络上的 USDT、5 条网络上的 USDC，以及 BTC、ETH、GRAM 等共 13 种币，提供收款链接、带签名的 Webhook 和由您批准的出款。
如何在 Telegram 机器人中接收加密货币付款
一次调用收款，一个 Webhook 发货。
一次 API 调用即可创建加密货币收款链接。资金在链上核验后，您的服务器只会收到一次带签名的 Webhook。无需运行节点，无需轮询，无需填表。
整个接入流程就是这些
Ravelo Bot
机器人
/start您的测试 API 密钥已就绪：
rvk_test_8f3k…x9Kp
第 2 步
一次调用
创建带有独立金额和地址的收款链接，可通过聊天、邮件或您的网站发送。
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 步
买家付款
使用任意钱包，在截止时间前支付精确金额，并支持二维码。
订单 #1042
14:5925.00 USDT
TQ7a…3fK · TRON (TRC-20)
请在 12:30 前支付
第 4 步
一个 Webhook
我们在链上核验付款、拦截假币，然后向您的服务器发送带签名的 Webhook。发货即可。
webhookPOST https://your-bot.app/webhook ravelo-signature: verified { "type": "payment_intent.succeeded", "data": { "order_ref": "1042", … } }您发货即可，就这么简单。
开发者
一套加密货币支付 API，附带 SDK 和可验证的 Webhook。
REST API，提供 TypeScript 和 Python SDK、快速上手文档和测试模式。每个 Webhook 都带签名，您的服务器可以验证它确实来自我们。密钥可以创建付款和准备出款，只有您能批准资金转出。
无法掏空您账户的密钥
API 密钥可以创建付款和准备出款，但都无法将资金转出，转出需要您的批准。
可安全重试
用同一个幂等键重复发送相同的请求，只会产生一笔付款，而不是两笔。
每次调用都有记录
每次 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 编程助手
或者，一条提示词完成接入。
把我们机器人发给您的接入提示词粘贴到 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.
安全
我们核验每一笔付款，让您不会为假钱发货。
每个订单都有独立的收款链接和结账页面：以加密货币或您的法币计价，包含精确金额、二维码和截止时间。
拦截假币
我们只计入来自已验证代币合约的币。仿冒代币永远不会让订单变为已支付。
少付、逾期或币种错误
订单会准确显示收到了多少、何时到账。足额到账前，订单不会进入可发货状态。
先已支付，再可发货
两个独立状态，确保您的代码只在资金最终到账后才发货。访问您的感谢页面不算付款。
无需运行节点
我们监控全部 12 条网络。只有付款状态变化时，您的服务器才会收到通知。
出款
由您批准的出款
只有您点头，资金才会转出。
提币到您已保存的地址。新地址需等待 24 小时才能接收资金。您的后端或 AI 助手可以准备出款或退款，但在您用指纹、面容或安全密钥批准之前，不会有任何资金转出。
控制台
所有收款、余额和出款，集中在一处。
通过 API 创建收款链接，或基于 API 搭建您自己的结账页。所有付款汇入同一个控制台，从已支付到已提币全程可追踪。
Ravelo/钱包与收款实时余额
总价值
US$9,640.62
以美元计，按每小时价格
可用
US$9,315.62
可随时提币
待确认
US$250.00
链上核验中
冻结中
US$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 密钥，并附带给 AI 编程助手使用的接入提示词。一次 API 调用即可在测试模式下创建第一个收款链接。您的账户开通后即可开始正式收款。
这是给 AI 编程助手（如 Claude Code 或 Cursor）使用的现成指令。机器人会连同您的 API 密钥一起发给您。粘贴进去后，助手会在您的项目中加入收款链接和经过验证的 Webhook，然后您运行一笔测试付款即可。
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。
您把收款链接发给买家，买家在截止时间前用任意钱包支付精确金额，您的服务器会收到带签名的 Webhook。
可以，需遵守 Telegram 的规则：在普通机器人中，实物商品、线下服务和您自己网站的销售可使用全部 13 种币；在 Mini Apps 中可使用 TON 上的 GRAM 和 USDT。
仅限在 Telegram 内销售的数字商品和服务：Telegram 要求这类交易使用 Stars。实物商品、线下服务以及在您自己网站上的销售，可以使用 Ravelo 收取加密货币。
我们会在链上并对照已验证的币种合约进行核验，通过后才会计入。仿冒代币永远不会让订单变为已支付。
不需要。我们监控全部 12 条网络，付款确认后向您的服务器发送带签名的 Webhook。
不能。它可以创建收款链接，并准备退款或出款，但只有您能用通行密钥批准。
每笔已确认付款收取 3%。无开通费，无月费。买家付款前和您批准出款前，都会显示网络费用。
有，由您自己设定：单笔出款、每日和每月限额。新的提币地址需等待 24 小时才能接收资金，因此即使登录凭据被盗，也无法清空您的余额。