跳至主要內容

一次串接

專為 Telegram 機器人與加密貨幣服務打造的支付閘道。

從我們的 Telegram 機器人取得 API 金鑰和串接提示詞,貼到 AI 程式開發助理中,即可開始接收加密貨幣付款,無需閱讀 API 文件。

三步完成串接

  1. 開啟我們的 Telegram 機器人,幾秒鐘內即可取得 API 金鑰和給 AI 程式開發助理使用的串接提示詞。

  2. Claude Code、Cursor 或其他任何 AI 程式開發助理會讀取我們的文件並寫出串接程式碼:收款連結、Webhook 和簽章驗證。

  3. 我們在鏈上核驗付款、攔截假幣,然後向您的伺服器傳送附簽章的 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。

買家如何付款?

我們盯鏈,您出貨。

我們監控全部 12 條網路,付款確認後向您的伺服器傳送附簽章的 Webhook。

閱讀加密貨幣支付 API 文件

Telegram

專為 Telegram 機器人、Mini Apps 和加密貨幣服務打造。

一個 API 金鑰適用於這三種情境。Telegram 的規則決定哪些幣可以在哪裡顯示,結帳頁會遵循這些規則。

Telegram 機器人

實體商品、實體服務和您自己網站的銷售可使用全部 13 種幣。在 Telegram 內銷售的數位商品仍須使用 Telegram Stars。

Mini Apps

Telegram 在 Mini Apps 中只允許 TON 幣種,因此結帳頁會在您自己的網域下顯示 TON 上的 GRAM 和 USDT。

加密貨幣服務和網站

透過一套 API,接收 8 條網路上的 USDT、5 條網路上的 USDC,以及 BTC、ETH、GRAM 等共 13 種幣,提供收款連結、附簽章的 Webhook 和由您核准的出款。

如何在 Telegram 機器人中接收加密貨幣付款

一次呼叫收款,一個 Webhook 出貨。

一次 API 呼叫即可建立加密貨幣收款連結。資金在鏈上核驗後,您的伺服器只會收到一次附簽章的 Webhook。無需自架節點,無需輪詢,無需填表。

整個串接流程就是這些

  1. 第 1 步

    取得 API 金鑰

    開啟我們的 Telegram 機器人,幾秒鐘內即可取得 API 金鑰和給 AI 程式開發助理使用的串接提示詞。測試模式立即可用。

    取得 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 Code。

    訂單 #1042

    14:59

    25.00 USDT

    TQ7a…3fK · TRON (TRC-20)

    請在 12:30 前支付

  4. 第 4 步

    一個 Webhook

    我們在鏈上核驗付款、攔截假幣,然後向您的伺服器傳送附簽章的 Webhook。出貨即可。

    webhook
    POST 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 呼叫都會記錄:使用了哪個金鑰、哪個工具、請求了什麼。

閱讀加密貨幣支付 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

驗證 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.

安全性

我們核驗每一筆付款,讓您不會為假錢出貨。

每筆訂單都有獨立的收款連結和結帳頁面:以加密貨幣或您的法幣計價,包含精確金額、QR Code 和截止時間。

攔截假幣

我們只計入來自已驗證代幣合約的幣。仿冒代幣永遠不會讓訂單變為已支付。

少付、逾期或幣種錯誤

訂單會準確顯示收到了多少、何時到帳。足額到帳前,訂單不會進入可出貨狀態。

先已支付,再可出貨

兩個獨立狀態,確保您的程式碼只在資金最終到帳後才出貨。造訪您的感謝頁面不算付款。

無需自架節點

我們監控全部 12 條網路。只有付款狀態改變時,您的伺服器才會收到通知。

出款

由您核准的出款

只有您點頭,資金才會轉出。

提幣到您已儲存的地址。新地址需等待 24 小時才能接收資金。您的後端或 AI 助理可以準備出款或退款,但在您用指紋、臉部辨識或安全金鑰核准之前,不會有任何資金轉出。

控制台

所有收款、餘額和出款,集中在一處。

透過 API 建立收款連結,或基於 API 打造您自己的結帳頁。所有付款匯入同一個控制台,從已支付到已提幣全程可追蹤。

  • 每筆付款的狀態

    已支付、可出貨、已提幣,以及每一筆到帳轉帳,一目了然。

  • CSV 對帳單

    將收款和出款匯出為 CSV,交給會計對帳。

  • 團隊角色

    邀請共同創辦人或開發者加入。每個人只能檢視和執行其角色允許的操作。

  • 依幣種檢視餘額

    可用、待確認和凍結的餘額一律分開顯示,您隨時清楚能提領多少。

  • 全額或部分退款

    可向已核驗的地址全額或部分退款。退款總額永遠不會超過買家實際支付的金額。

  • 測試與正式金鑰

    先在測試模式下開發,再切換到正式金鑰。測試付款不會動用真實資金。

定價

定價:每筆付款 3%,無開通費和月費

到帳時間

每筆付款 3%

從每筆已確認付款中扣除。沒有額外固定費用,所以小額銷售也划算:一筆 5 美元的訂單手續費只有 15 美分。

取得 API 金鑰
  • 買家支付 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 小時才能接收資金,因此即使登入憑證被盜,也無法清空您的餘額。

今天就開始接收加密貨幣付款。

開啟機器人:取得您的 API 金鑰和串接提示詞。把提示詞貼到 AI 程式開發助理中,或者自己呼叫一次 API。鏈上監控由我們負責。