Chuyển đến nội dung

Tích hợp một lần

Cổng thanh toán tiền mã hóa cho bot Telegram và dịch vụ tiền mã hóa.

Nhận khóa API và prompt tích hợp từ bot Telegram của chúng tôi. Dán prompt vào agent lập trình và bắt đầu nhận thanh toán bằng tiền mã hóa. Không phải đọc tài liệu API.

Kết nối trong 3 bước

  1. Mở bot Telegram của chúng tôi. Trong vài giây bạn có khóa API và prompt tích hợp cho agent lập trình.

  2. Claude Code, Cursor hoặc bất kỳ agent lập trình nào khác sẽ đọc tài liệu của chúng tôi và viết phần tích hợp: liên kết thanh toán, webhook và bước kiểm tra chữ ký.

  3. Chúng tôi kiểm tra thanh toán trên chuỗi, chặn đồng giả, rồi gửi cho máy chủ của bạn một webhook có chữ ký. Giao đơn hàng.

Các đồng

Nhận USDT, USDC, BTC, ETH, GRAM và 8 đồng khác

13 đồng trên 12 mạng

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

Mạng: Tron (TRC-20) · TON · Ethereum (ERC-20) · BNB Chain (BEP-20) · Solana · Polygon · Base · Avalanche C-Chain · Bitcoin · Litecoin · Dogecoin · Monero

Người mua thanh toán từ bất kỳ ví nào

Bạn gửi cho họ liên kết thanh toán. Họ trả đúng số tiền từ bất kỳ ví nào trước thời hạn, và máy chủ của bạn nhận một webhook có chữ ký.

Người mua của tôi thanh toán thế nào?

Chúng tôi theo dõi chuỗi. Bạn giao hàng.

Chúng tôi theo dõi cả 12 mạng và gửi cho máy chủ của bạn một webhook có chữ ký khi thanh toán được xác nhận.

Đọc tài liệu API thanh toán tiền mã hóa

Telegram

Xây dựng cho bot Telegram, Mini App và dịch vụ tiền mã hóa.

Một khóa API dùng cho cả ba. Quy tắc của Telegram quyết định đồng nào được hiển thị ở đâu, và trang thanh toán tuân theo đó.

Bot Telegram

Cả 13 đồng cho hàng hóa vật lý, dịch vụ ngoài đời thực và bán hàng trên website của bạn. Hàng hóa số bán bên trong Telegram vẫn dùng Telegram Stars.

Mini App

Telegram chỉ cho phép các đồng TON trong Mini App, nên trang thanh toán hiển thị GRAM và USDT trên TON, trên tên miền của riêng bạn.

Dịch vụ tiền mã hóa và website

Nhận USDT trên 8 mạng, USDC trên 5 mạng, cùng BTC, ETH, GRAM và 8 đồng khác, với liên kết thanh toán, webhook có chữ ký và chi trả do bạn duyệt, từ một API.

Cách nhận thanh toán tiền mã hóa trong bot Telegram

Một lệnh gọi để nhận tiền. Một webhook để giao hàng.

Tạo liên kết thanh toán tiền mã hóa chỉ với một lệnh gọi API. Máy chủ của bạn nhận tin một lần, qua webhook có chữ ký, khi tiền đã được kiểm tra trên chuỗi. Không cần chạy node, không cần polling, không có biểu mẫu.

Đây là toàn bộ phần tích hợp

  1. Bước 1

    Nhận khóa API

    Mở bot Telegram của chúng tôi. Trong vài giây bạn có khóa API và prompt tích hợp cho agent lập trình. Chế độ thử nghiệm dùng được ngay.

    Nhận khóa API

    Ravelo Bot

    bot

    /start

    Khóa API thử nghiệm của bạn đã sẵn sàng:

    rvk_test_8f3k…x9Kp

  2. Bước 2

    Một lệnh gọi

    Tạo liên kết thanh toán với số tiền và địa chỉ riêng. Gửi trong tin nhắn, email hoặc trên website của bạn.

    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. Bước 3

    Người mua thanh toán

    Từ bất kỳ ví nào: đúng số tiền, trước thời hạn, kèm mã QR.

    Đơn hàng #1042

    14:59

    25.00 USDT

    TQ7a…3fK · TRON (TRC-20)

    Thanh toán trước 12:30

  4. Bước 4

    Một webhook

    Chúng tôi kiểm tra thanh toán trên chuỗi, chặn đồng giả, rồi gửi cho máy chủ của bạn một webhook có chữ ký. Giao đơn hàng.

    webhook
    POST https://your-bot.app/webhook
    ravelo-signature: verified
    
    {
      "type": "payment_intent.succeeded",
      "data": { "order_ref": "1042", … }
    }

    Bạn giao đơn hàng. Vậy là xong.

Lập trình viên

Một API thanh toán tiền mã hóa, SDK và webhook bạn có thể xác minh.

API REST với SDK TypeScript và Python, tài liệu bắt đầu nhanh và chế độ thử nghiệm. Mọi webhook đều có chữ ký, để máy chủ của bạn chứng minh được nó đến từ chúng tôi. Khóa có thể tạo thanh toán và chuẩn bị chi trả. Chỉ bạn mới duyệt được việc chuyển tiền ra.

  • Khóa không thể rút cạn tiền của bạn

    Khóa API có thể tạo thanh toán và chuẩn bị chi trả. Không khóa nào có thể chuyển tiền ra. Việc đó cần sự duyệt của bạn.

  • Thử lại an toàn

    Gửi cùng một yêu cầu hai lần với cùng một khóa idempotency, bạn chỉ có một khoản thanh toán, không phải hai.

  • Mọi lệnh gọi đều được ghi lại

    Mỗi lệnh gọi API và MCP đều được ghi nhật ký: khóa nào, công cụ nào, yêu cầu gì.

Đọc tài liệu API thanh toán tiền mã hóa

Tạo liên kết thanh toán

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

Xác minh 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);
}

Agent lập trình

Hoặc tích hợp chỉ với một prompt.

Dán prompt tích hợp từ bot của chúng tôi vào agent lập trình của bạn.

Claude Code, Cursor hoặc bất kỳ agent lập trình nào khác sẽ đọc tài liệu của chúng tôi và viết phần tích hợp: liên kết thanh toán, webhook và bước kiểm tra chữ ký. Kết nối máy chủ MCP của chúng tôi để trợ lý của bạn cũng có thể tạo liên kết thanh toán và kiểm tra thanh toán. Nó không bao giờ tự duyệt chi trả. Bạn duyệt.

Nội dung bot gửi cho bạn, sẵn sàng dán vào agent lập trình:
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.

Bảo mật

Chúng tôi kiểm tra từng khoản thanh toán, để bạn không bao giờ giao hàng vì tiền giả.

Mỗi đơn hàng có liên kết thanh toán và trang thanh toán riêng: định giá bằng tiền mã hóa hoặc tiền tệ của bạn, với số tiền chính xác, mã QR và thời hạn.

Chặn đồng giả

Chúng tôi chỉ tính các đồng từ hợp đồng token đã được xác minh. Token giả mạo giống thật không bao giờ đánh dấu đơn hàng là đã thanh toán.

Thiếu tiền, trễ hạn hoặc sai đồng

Đơn hàng hiển thị chính xác số tiền đã đến và thời điểm. Chưa có gì sẵn sàng giao cho đến khi đủ toàn bộ số tiền.

Đã thanh toán, rồi sẵn sàng giao

Hai trạng thái tách biệt, để mã của bạn chỉ giao hàng khi tiền đã chắc chắn. Việc khách truy cập trang cảm ơn của bạn không bao giờ được tính.

Không cần chạy node

Chúng tôi theo dõi cả 12 mạng. Máy chủ của bạn chỉ nhận tin từ chúng tôi khi một khoản thanh toán thay đổi.

Chi trả

Chi trả do bạn duyệt

Tiền chỉ rời đi khi bạn cho phép.

Rút tiền về các địa chỉ đã lưu của bạn. Địa chỉ mới phải chờ 24 giờ mới nhận được tiền. Backend hoặc trợ lý AI của bạn có thể chuẩn bị chi trả hoặc hoàn tiền, nhưng không có gì được chuyển cho đến khi bạn duyệt bằng vân tay, khuôn mặt hoặc khóa bảo mật.

Bảng điều khiển

Mọi khoản thanh toán, số dư và chi trả ở một nơi.

Tạo liên kết thanh toán qua API, hoặc xây trang thanh toán riêng trên đó. Mọi khoản thanh toán đều về một bảng điều khiển, được theo dõi từ lúc thanh toán đến lúc rút.

  • Trạng thái mọi khoản thanh toán

    Đã thanh toán, sẵn sàng giao và đã rút, cùng mọi giao dịch đã đến.

  • Sao kê CSV

    Xuất thanh toán và chi trả dưới dạng CSV cho kế toán của bạn.

  • Vai trò trong nhóm

    Mời đồng sáng lập hoặc lập trình viên. Mỗi người chỉ thấy và làm những gì vai trò của họ cho phép.

  • Số dư theo đồng

    Khả dụng, đang chờ và bị giữ luôn được hiển thị riêng. Bạn luôn biết mình có thể rút bao nhiêu.

  • Hoàn tiền toàn bộ hoặc một phần

    Hoàn tiền toàn bộ hoặc một phần đơn hàng đến địa chỉ đã kiểm tra. Tổng hoàn tiền không bao giờ vượt quá số người mua đã trả.

  • Khóa thử nghiệm và thực tế

    Xây dựng trên chế độ thử nghiệm, rồi chuyển sang khóa thực tế. Thanh toán thử nghiệm không bao giờ chuyển tiền thật.

Bảng giá

Bảng giá: 3% mỗi khoản thanh toán, không phí thiết lập hay phí hàng tháng

Khi nào bạn được trả tiền

3% mỗi khoản thanh toán

Được trừ từ mỗi khoản thanh toán đã xác nhận. Không có phí cố định cộng thêm, nên đơn nhỏ vẫn rẻ: đơn $5 chỉ tốn 15¢.

Nhận khóa API
  • Người mua trả 100 USDT, bạn nhận 97 USDT
  • Không phí thiết lập, không phí hàng tháng
  • Chế độ thử nghiệm miễn phí
  • Chi phí mạng được hiển thị trước mỗi lần chi trả

Câu hỏi thường gặp

Câu hỏi thường gặp về cổng thanh toán tiền mã hóa

Những điều lập trình viên hỏi trước khi tích hợp. Còn thiếu gì? Hãy hỏi chúng tôi trên Telegram.

  • Nhận khóa API từ bot Telegram của chúng tôi trong vài giây, kèm prompt tích hợp cho agent lập trình của bạn. Một lệnh gọi API tạo liên kết thanh toán đầu tiên ở chế độ thử nghiệm. Thanh toán thực tế bắt đầu ngay khi tài khoản của bạn được kích hoạt.

  • Hướng dẫn sẵn cho agent lập trình của bạn, như Claude Code hoặc Cursor. Bot gửi chúng cùng khóa API. Dán vào, và agent sẽ thêm liên kết thanh toán và webhook đã xác minh vào dự án của bạn. Sau đó bạn chạy một khoản thanh toán thử.

  • USDT trên Tron (TRC-20), TON, Ethereum (ERC-20), BNB Chain (BEP-20), Solana (SPL), Polygon, Base và Avalanche C-Chain. USDC trên Ethereum (ERC-20), Solana (SPL), Polygon, Base và Avalanche C-Chain. ETH trên Ethereum và Base. Cùng BTC, GRAM, SOL, TRX, BNB, POL, AVAX, LTC, DOGE và XMR, mỗi đồng trên mạng riêng của nó. GRAM là đồng gốc của TON, trước đây gọi là Toncoin.

  • Bạn gửi cho họ liên kết thanh toán. Họ trả đúng số tiền từ bất kỳ ví nào trước thời hạn, và máy chủ của bạn nhận một webhook có chữ ký.

  • Có, trong khuôn khổ quy tắc của Telegram: cả 13 đồng trong bot thông thường cho hàng hóa vật lý, dịch vụ ngoài đời thực và website của bạn, còn GRAM và USDT trên TON trong Mini App.

  • Chỉ với hàng hóa và dịch vụ số bán bên trong Telegram: Telegram yêu cầu dùng Stars cho chúng. Với hàng hóa vật lý, dịch vụ ngoài đời thực và bán hàng trên website của bạn, bạn có thể nhận tiền mã hóa với Ravelo.

  • Chúng tôi kiểm tra trên chuỗi và đối chiếu với hợp đồng đồng đã xác minh trước khi tính. Token giả mạo giống thật không bao giờ đánh dấu đơn hàng là đã thanh toán.

  • Không. Chúng tôi theo dõi cả 12 mạng và gửi cho máy chủ của bạn một webhook có chữ ký khi thanh toán được xác nhận.

  • Không. Nó có thể tạo liên kết thanh toán và chuẩn bị hoàn tiền hoặc chi trả. Chỉ bạn mới duyệt được, bằng passkey.

  • 3% mỗi khoản thanh toán đã xác nhận. Không phí thiết lập, không phí hàng tháng. Chi phí mạng được hiển thị trước khi người mua thanh toán và trước khi bạn duyệt chi trả.

  • Có, do bạn đặt: theo từng lần chi trả, theo ngày và theo tháng. Địa chỉ rút tiền mới phải chờ 24 giờ mới nhận được tiền, nên tài khoản bị đánh cắp cũng không thể rút cạn số dư của bạn.

Bắt đầu nhận thanh toán tiền mã hóa ngay hôm nay.

Mở bot: bạn nhận khóa API và prompt tích hợp. Dán prompt vào agent lập trình, hoặc tự thực hiện một lệnh gọi API. Chúng tôi theo dõi chuỗi.