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
Kết nối AI agent lập trình có hỗ trợ máy chủ MCP từ xa với https://app.tgpaycrypto.com/mcp. Agent có thể đọc tài liệu API, yêu cầu tạo ứng dụng Merchant API, cấu hình webhook và hỗ trợ viết phần tích hợp. Bạn duyệt việc tạo ứng dụng trong bot; agent nhận token giới hạn quyền mà bạn không cần sao chép thủ công. Hãy kiểm tra và thử nghiệm phần tích hợp trước khi nhận thanh toán thật.
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; khi thanh toán thành công, số dư ứng dụng được cộng tiền sau khi trừ phí dành cho người bá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, cấu trúc phản hồi, 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 vào ví của một người dùng Telegram hoặc tạm giữ tiền cho đến khi người nhận mới mở bot. Một Lì xì là liên kết nhận tiền, với số tiền được tạm giữ trước trên số dư ứng dụng. Các quy ước chung (xác thực, cấu trúc phản hồi, 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 sau khi chúng xảy ra. Hãy đặt Webhook URL (không bắt buộc) 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ý.
Điều khoản Merchant API
Các điều khoản này điều chỉnh việc sử dụng Merchant API — ứng dụng, token API, hóa đơn, gói đăng ký, chuyển tiền, Lì xì, webhook và kết nối AI agent. Điều khoản này được áp dụng song song với điều khoản sử dụng chung và chính sách AML của ứng dụng. Việc tạo một ứng dụng đồng nghĩa với việc bạn chấp nhận các điều khoản này; nếu tiếp tục sử dụng một ứng dụng đã tạo trước ngày 7 tháng 9 năm 2026, bạn cũng được xem là đã chấp nhận.