Merchant API

Nhận thanh toán trong bot riêng

Lấy token, tạo hóa đơn từ mã và xử lý webhook thanh toán. Token thử nghiệm giúp kiểm tra toàn bộ quy trình trước khi phát hành.

8 đồng coin · 16 cặp tài sản và mạng lưới trên cùng số dư Máy chủ MCP giúp AI agent chuẩn bị tích hợp →
Màn hình token API và webhook
Đã gửi webhook
Môi trường thử nghiệm
Bắt đầu

Cách kết nối Merchant API

Từ token đến webhook đầu tiên trong bốn bước. Tìm hiểu Merchant API →

Bước 1

Lấy token

Tạo ứng dụng trong bot và lấy token Merchant API.

Bước 2

Tạo hóa đơn

Gọi API với số tiền, crypto và mô tả. URL webhook được đặt trong cài đặt ứng dụng.

Bước 3

Hiển thị liên kết thanh toán

Cung cấp liên kết hoặc nút. Người dùng thanh toán trong Telegram.

Bước 4

Xử lý webhook

Xác thực sự kiện thanh toán rồi giao hàng hoặc cấp quyền sử dụng dịch vụ.

AI agent

AI agent có thể chuẩn bị tích hợp

Merchant API có máy chủ MCP. Gửi URL cho AI agent để đọc tài liệu, tạo ứng dụng khi bạn duyệt, đặt webhook và viết mã. Không cần sao chép token thủ công.

  1. Bước 1

    Gửi yêu cầu cho AI agent

  2. Bước 2

    Duyệt ứng dụng trong Telegram

  3. Bước 3

    AI agent hoàn tất cài đặt

Cách hoạt động, yêu cầu theo ứng dụng khách và quyền của AI agent →
Yêu cầu để gửi cho AI agent
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Tính năng

Tích hợp thanh toán vào sản phẩm

Tạo hóa đơn qua yêu cầu, nhận trạng thái qua webhook và xây dựng phần còn lại theo sản phẩm.

Token và môi trường thử nghiệm

Dùng token riêng để thử quy trình thanh toán trước khi mở cho người dùng thật.

Hóa đơn từ mã

Tạo, hủy và kiểm tra hóa đơn bằng yêu cầu HTTP, không bắt buộc dùng SDK.

Thu tiền định kỳ

Người dùng đồng ý một lần, sau đó Merchant API thu tiền gói đăng ký theo lịch.

Webhook thanh toán

Sự kiện được gửi sau thanh toán và thử lại khi thất bại. Bên nhận cần xác thực chữ ký và tránh xử lý trùng.

Tài liệu và ví dụ

Tham khảo phương thức, mã lỗi và yêu cầu mẫu tại trung tâm trợ giúp.

Xem hướng dẫn chi tiết tại trung tâm trợ giúp

8 đồng coin · 16 cặp tài sản và mạng lưới trên cùng số dư

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Bạn quản lý kênh hoặc bán hàng trên Telegram?

Chọn mục đích sử dụng để xem các tính năng phù hợp.

Dành cho nhà sáng tạo Dành cho người bán Dành cho nhà phát triển
Earn

Lợi nhuận được tính tự động

Thêm một phần số dư vào Earn. Lợi nhuận được tính tự động và cộng vào ví. Bạn có thể thêm hoặc rút bất cứ lúc nào.

Lãi suất năm Tính mỗi giờ
USDT 4% 500 USDT đầu tiên 1% phần trên 500
GRAM 6% 300 GRAM đầu tiên 3% phần trên 300
Cộng vào ví hằng ngày lúc 00:30 UTC Không phí thêm và rút
Màn hình Earn
Màn hình xác nhận rút
Địa chỉ khớp
Bảo mật

Kiểm tra trước khi gửi

Lệnh rút chuyển tài sản đến địa chỉ ngoài. Các bước kiểm tra và bảo vệ sau áp dụng quanh thời điểm xác nhận.

  • Trước khi xác nhận
  • Hiển thị đầy đủ địa chỉ, mạng lưới và Memo Bạn thấy toàn bộ địa chỉ và mạng lưới nhận, không chỉ dạng rút gọn như "4f3a…9c2b".
  • Địa chỉ đã lưu Bạn có thể chỉ cho phép rút đến các địa chỉ đã lưu trước đó.
  • Mã PIN hoặc Face ID Mỗi lệnh rút cần mã PIN hoặc sinh trắc học đã đăng ký bằng mã PIN trên thiết bị. Xác nhận một lần cho cả phiên là chưa đủ.
  • Xác nhận lệnh rút
  • Sau khi xác nhận
  • Chờ an toàn với lệnh rút lớn Khi bật tính năng này, lệnh rút thuộc phạm vi áp dụng sẽ chờ trước khi gửi. Bạn vẫn có thể hủy trong thời gian đó.
  • Kiểm tra AML cho giao dịch Giao dịch được kiểm tra trước khi chuyển tiền đến người nhận.
  • Thông báo giao dịch Nhận thông báo theo cài đặt. Cảnh báo bảo mật quan trọng luôn được gửi.

Hướng dẫn bảo mật tại trung tâm trợ giúp

Điều kiện

Điều kiện rõ ràng trước khi xác nhận

Số tiền sẽ trừ, bao gồm phí, luôn hiển thị trước khi xác nhận.

Nạp vào ví Ghi có sau các xác nhận mạng lưới
Không mất phí
Chuyển qua tên người dùng trong Telegram Xử lý nội bộ, không gửi lên blockchain và không có phí mạng lưới
Không mất phí
Quy đổi trong ví Tỷ giá, phí và số tiền cuối cùng trên màn hình quy đổi
Hiển thị trước khi xác nhận
Rút qua blockchain Kiểm tra địa chỉ, mạng lưới và Memo cần thiết trước khi gửi
Phí rút hiển thị trong ứng dụng
Thêm và rút tiền từ Earn Không có thời hạn khóa bắt buộc
Không mất phí

Phí và mức tối thiểu hiện hành có trong ứng dụng. Xem danh sách đầy đủ tại trung tâm trợ giúp.

USDT GRAM BTC ETH SOL BNB LTC DOGE
8 đồng coin · 16 cặp tài sản và mạng lưới cùng một số dư

Không cần tạo ví riêng cho từng mạng lưới. Chọn mạng phù hợp để nạp và rút.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

trực tuyến Hỗ trợ trong Telegram
Lệnh rút TRC-20 chưa đến nơi. Tôi cần làm gì? Chúng tôi đang kiểm tra giao dịch và sẽ trả lời ngay trong cuộc trò chuyện này.
@tgpayhelpbot
Câu hỏi thường gặp

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

Thông tin cơ bản về ví, chuyển tiền, Earn và nhận thanh toán.

Ví được tạo khi bạn mở @tgpaycryptobot lần đầu. Không có tài khoản đăng nhập riêng, mật khẩu hay cụm từ khôi phục. Quyền truy cập gắn với tài khoản Telegram.

Tám đồng coin và mười sáu cặp tài sản, mạng lưới: GRAM, BTC, ETH, SOL, BNB, LTC, DOGE, TRX; thêm USDT trên năm mạng và USDC trên ba mạng. Chọn mạng khi nạp hoặc rút và dùng đúng địa chỉ tương ứng.

Nhập tên người dùng của người nhận. Tiền được chuyển nội bộ nên không cần địa chỉ hay phí mạng lưới. Nếu họ chưa có ví, bạn có thể gửi Lì xì để họ tự nhận.

Thêm một phần số dư vào Earn để tính lợi nhuận tự động. USDT có lãi suất năm 4% cho 500 USDT đầu tiên, 1% cho phần còn lại; GRAM là 6% cho 300 GRAM đầu tiên, 3% cho phần còn lại. Lợi nhuận tính mỗi giờ và cộng vào ví hằng ngày lúc 00:30 UTC. Có thể thêm hoặc rút bất cứ lúc nào, không mất phí.

Lì xì là crypto qua liên kết hoặc mã QR, dành cho một hoặc nhiều lượt nhận. Bạn có thể đặt mật khẩu, hạn dùng, giới hạn cho người theo dõi kênh hoặc người dùng Telegram Premium. Sau khi tạo, có thể tạm dừng, sửa số tiền và số lượt nhận hoặc xóa. Phần còn lại được hoàn về số dư.

Chuyển qua tên người dùng không có phí mạng lưới. Lệnh rút áp dụng phí hiển thị trong ứng dụng. Phí quy đổi và số tiền cuối cùng hiển thị trước khi xác nhận. Xem mức hiện hành và số tiền tối thiểu trong ứng dụng hoặc trung tâm trợ giúp.

Tạo hóa đơn trong bot hoặc tự động hóa bằng Merchant API. Một yêu cầu tạo hóa đơn, webhook báo khi đã thanh toán. Tài liệu phương thức có tại trung tâm trợ giúp.

Tất cả câu trả lời có tại trung tâm trợ giúp Nếu cần thêm hỗ trợ, liên hệ @tgpayhelpbot

Bắt đầu dùng ví

Mở @tgpaycryptobot trong Telegram. Ví đã sẵn sàng nhận crypto.

Mục đích sử dụng:
Cá nhân Dành cho nhà sáng tạo Dành cho người bán Dành cho nhà phát triển