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 cho mỗi thanh toán. Mạng thử nghiệm giúp kiểm tra toàn bộ quy trình thanh toán trước khi phát hành.

10 loại tiền mã hóa · 8 mạng 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 Merchant API: ứng dụng và kết nối AI agent
Webhook: hóa đơn đã thanh toán
Mạ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. Kết nối bằng ứng dụng khách AI agent tương thích: AI agent có thể đọc tài liệu, yêu cầu tạo ứng dụng, cấu hình webhook và hỗ trợ viết mã tích hợp. Bạn duyệt ứng dụng trong Telegram, rồi kiểm tra và thử nghiệm kết quả.

  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

    Hoàn tất và thử nghiệm tích hợp

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 MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the 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ạng thử nghiệm

Dùng bot mạng thử nghiệm riêng @tgpaycrypto_testnet_bot để kiểm tra 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.

10 loại tiền mã hóa · 8 mạng 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
Màn hình xác nhận rút
Định dạng địa chỉ hợp lệ
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
  • Địa chỉ, mạng lưới và Memo Trước khi xác nhận, kiểm tra địa chỉ người nhận, mạng lưới và Memo nếu cần. Định dạng hợp lệ không chứng minh địa chỉ thuộc về đúng người bạn muốn gửi.
  • Đị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 rút tiền 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.
Đ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. Khoản nạp dưới mức tối thiểu của mạng lưới không được ghi có. Địa chỉ đầu tiên trên mỗi mạng lưới miễn phí; mỗi địa chỉ thêm có phí 5 USD. 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í Phí đã gồm trong tỷ giá; tỷ giá và số tiền cuối cùng hiển thị 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 định dạng địa chỉ trước khi gửi; địa chỉ, mạng lưới và Memo hiển thị trên màn hình xác nhận Phí rút hiển thị trong ứng dụng

Phí và mức tối thiểu hiện tại được hiển thị trong ứng dụng.

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 loại tiền mã hóa · 8 mạng 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 ứng dụng
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.
Mở ví
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 và nhận thanh toán.

Không. Ví được tạo khi bạn mở @tgpaycryptobot lần đầu, không cần tên đăng nhập riêng hay cụm từ khôi phục. Quyền truy cập gắn với tài khoản Telegram; bạn cần đặt mã PIN trước khi chuyển tiền ra khỏi ví.

Mười loại tiền mã hóa 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 @username hoặc ID Telegram dạng số của người nhận. Tiền được chuyển nội bộ trong ví nên không cần địa chỉ và không mất phí mạng lưới. Nếu người nhận chưa từng mở TgPay Crypto, khoản chuyển sẽ chờ và được cộng vào số dư khi họ mở bot lần đầu. Nếu họ không nhận trong 30 ngày, tiền sẽ được hoàn lại cho bạn. Bạn cũng có thể gửi Lì xì: ai mở liên kết trước sẽ được nhận.

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.

Chưa tìm được câu trả lời? Nhắn cho bộ phận hỗ trợ trong ứng dụng

Bắt đầu dùng ví

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

Mục đích sử dụng: