Merchant API (Nhà phát triển)
API cho đối tác: ứng dụng, hóa đơn, chuyển tiền và webhook.
Merchant API là gì?
Merchant API là API thanh toán của ứng dụng, dành cho doanh nghiệp và bot. Bạn tạo một ứng dụng, lấy token API, rồi dùng token đó để thu tiền người dùng Telegram, chi trả cho họ và xem số dư — tất cả từ code của chính bạn.
Bắt đầu dành cho lập trình viên
Tạo một ứng dụng trong Mini App, sao chép token API của nó một lần, rồi bắt đầu gọi API. Toàn bộ phần thiết lập nằm ở Thêm → Merchant API.
Kết nối AI agent
Đưa cho AI agent lập trình của bạn một URL — https://app.tgcryptopay.com/mcp — và nó dựng luôn phần tích hợp thanh toán: đọc tài liệu API, tạo ứng dụng Merchant API, thiết lập webhook và viết code. Bạn chỉ duyệt ứng dụng mới một lần, bằng một nút bấm trong bot. Không cần terminal, cũng không phải tự tay sao chép token API.
Nhận thanh toán bằng hóa đơn
Hóa đơn là cách bạn thu tiền một người dùng Telegram. Bạn tạo hóa đơn qua API, gửi liên kết cho người thanh toán, và số dư ứng dụng của bạn được cộng tiền ngay lúc họ xác nhận.
Phí và hạn mức Merchant API
Hóa đơn chịu một khoản phí dịch vụ trừ vào phần bạn nhận được; chuyển tiền và Lì xì thì có hạn mức số tiền. Các con số dưới đây là thiết lập hiện hành, không phải điều khoản hợp đồng — khi chúng lệch với những gì bạn thấy thì ứng dụng mới đúng, và nguồn đáng tin nhất luôn là chính các hóa đơn đã thanh toán của bạn.
Tài liệu Merchant API
Các quy ước chung của mọi phương thức, cùng các phương thức tra cứu chỉ đọc. Trang chi tiết từng nhóm: hóa đơn và hoàn tiền, chuyển tiền và Lì xì, gói đăng ký, webhook.
Tài liệu API: hóa đơn và hoàn tiền
Các phương thức về hóa đơn: createInvoice, getInvoices, deleteInvoice, refundInvoice. Các quy ước chung (xác thực, envelope, số tiền, spend_id) nằm ở trang tài liệu Merchant API; phần hướng dẫn từng bước là Nhận thanh toán bằng hóa đơn.
Tài liệu API: chuyển tiền và Lì xì
Các phương thức chi trả. Một lệnh chuyển đưa tiền từ số dư ứng dụng của bạn thẳng vào ví của một người dùng Telegram; một Lì xì là liên kết nhận tiền mà bạn nạp sẵn tiền vào. Các quy ước chung (xác thực, envelope, số tiền, spend_id) nằm ở trang tài liệu Merchant API.
Tài liệu API: gói đăng ký
Thu phí định kỳ — một phần mở rộng so với Crypto Bot. Bạn tạo một gói (số tiền + chu kỳ), gửi cho người dùng liên kết đăng ký, rồi nền tảng tự trừ tiền từ số dư ví của họ mỗi kỳ và cộng vào số dư ứng dụng của bạn phần đã trừ phí. Các quy ước chung nằm ở trang tài liệu Merchant API.
Tài liệu API: webhook
Webhook đẩy sự kiện về máy chủ của bạn ngay lúc chúng xảy ra. Hãy đặt Webhook URL cho ứng dụng của bạn ở Thêm → Merchant API; từ đó nền tảng POST một JSON body có chữ ký cho mỗi sự kiện bạn đã đăng ký.