Không cần xử lý đơn thủ công
Tạo đơn Stars và Premium trực tiếp từ hệ thống của bạn, đồng thời lưu mã định danh duy nhất cho từng giao dịch.
Gramix dành cho đại lý
API tự động mua Telegram Stars và Premium
Tích hợp Telegram Stars và Telegram Premium vào website, ứng dụng hoặc bot của bạn. Tạo đơn bằng chương trình, thanh toán từ số dư đại lý và theo dõi quá trình xử lý qua API hoặc webhook.
Tài liệu API
Xác thực, nạp số dư, phương thức mua Stars và Premium, đơn hàng, webhook, schema và ví dụ mã nguồn.
Đọc tài liệuBảng giá API
Giá đại lý hiện tại cho Telegram Stars, các gói Telegram Premium và những sản phẩm khác có trên API.
Xem bảng giáAPI cho doanh nghiệp
Tự động hóa việc bán Telegram Stars và Premium
Gramix API được xây dựng cho đại lý và dịch vụ số muốn cung cấp Telegram Stars cùng Telegram Premium trên website, ứng dụng, bot hoặc nền tảng nội bộ của riêng mình. Thay vì xử lý thủ công từng giao dịch, hệ thống của bạn gửi yêu cầu API và Gramix tạo một đơn hàng có thể theo dõi.
Tích hợp sử dụng số dư trả trước. Bạn chỉ cần nạp tiền vào số dư API riêng, sau đó chi phí của đơn mới sẽ được tự động khấu trừ. Nhờ vậy, mỗi đơn khách hàng không phải tạo một giao dịch thanh toán riêng và chờ xác nhận.
Đơn được xử lý nhanh chóng
Khoản thanh toán được trừ từ số dư khả dụng, vì vậy yêu cầu API hợp lệ có thể chuyển thẳng sang xử lý.
Tự động cập nhật trạng thái
Nhận kết quả qua webhook hoặc truy vấn trạng thái mới nhất của đơn bằng API bất cứ khi nào cần.
Bắt đầu sử dụng
Từ đăng ký đến đơn API đầu tiên
Một tích hợp cơ bản gồm bốn bước rõ ràng. Tài liệu Gramix API v1 cung cấp đầy đủ tham số yêu cầu, schema phản hồi và ví dụ mã nguồn sẵn dùng.
- 1
Tạo tài khoản và khóa API
Đăng ký Gramix, mở mục API trong tài khoản và tạo khóa cho tích hợp máy chủ của bạn.
- 2
Nạp số dư API
Nạp tiền thủ công từ tài khoản hoặc yêu cầu địa chỉ nạp và memo bằng chương trình thông qua API.
- 3
Gửi yêu cầu mua
Cung cấp username Telegram, sản phẩm đã chọn và khóa idempotency bắt buộc để tránh tạo đơn trùng lặp.
- 4
Theo dõi trạng thái đơn
Lưu ID đơn hàng, kiểm tra qua API hoặc cấu hình webhook để tự động nhận thông báo trạng thái.
Bảng điều khiển đại lý
Số dư, thanh toán và đơn hàng tại một nơi
Bạn có thể vận hành toàn bộ tích hợp qua API, trong khi các chức năng thiết yếu vẫn có sẵn trong tài khoản Gramix. Kiểm tra tiền, tìm đơn hoặc cập nhật quyền truy cập mà không cần nhờ đến lập trình viên.
Số dư hiện tại và nạp tiền thủ công
Kiểm tra tiền khả dụng và nạp số dư API bằng địa chỉ ví cùng memo bắt buộc. Khoản tiền được tự động ghi nhận sau khi thanh toán được xác nhận.
Lịch sử giao dịch
Xem các khoản nạp, khấu trừ mua hàng và hoàn tiền với ngày, chiều giao dịch, số tiền và loại tiền của từng mục.
Lịch sử và trạng thái đơn
Tìm đơn theo ID, xem ngày, sản phẩm, người nhận, giá và trạng thái hiện tại, sau đó mở toàn bộ chi tiết đơn hàng.
Quản lý tích hợp
Tạo hoặc xoay vòng khóa API, lưu URL webhook HTTPS an toàn và truy cập tài liệu hoặc bảng giá hiện tại.
Tốc độ xử lý
Cùng hạ tầng thực hiện, không cần thanh toán riêng từng đơn
Đơn API sử dụng cùng hạ tầng dịch vụ Gramix như giao dịch trên website. Điểm khác biệt với đại lý là tiền đã có sẵn trong số dư API. Khi yêu cầu vượt qua bước xác thực, chi phí được tự động khấu trừ và đơn chuyển sang xử lý mà không phải chờ một giao dịch thanh toán mới.
Thời gian hoàn tất thực tế phụ thuộc vào sản phẩm đã chọn, tính chính xác của thông tin người nhận và khả năng hoạt động của dịch vụ Telegram tương ứng.
- Số dư trả trước cho các đơn thường xuyên
- Khóa idempotency giúp ngăn giao dịch trùng lặp
- Nhận trạng thái completed và failed qua webhook
- Tra cứu từng đơn bằng ID duy nhất
Phù hợp với ai
API cho đại lý, cửa hàng và dịch vụ Telegram
Cửa hàng trực tuyến
Thêm Telegram Stars và Premium vào danh mục, đồng thời tự động gửi các đơn khách đã thanh toán sang Gramix.
Bot và ứng dụng Telegram
Xây dựng trải nghiệm mua riêng và kết nối xử lý đơn phía máy chủ thông qua REST API.
Đại lý có đơn thường xuyên
Làm việc với số dư chung, tự động hóa thao tác lặp lại và theo dõi kết quả của từng đơn khách hàng.
Câu hỏi thường gặp
Câu hỏi về Gramix API
Gramix API phù hợp với ai?
Gramix API phù hợp với đại lý, cửa hàng trực tuyến, bot Telegram, agency và các dịch vụ khác cần tự động mua Telegram Stars cùng Telegram Premium cho khách hàng.
Có thể đặt những sản phẩm Telegram nào qua API?
Gramix API cho phép tạo đơn Telegram Stars và gói đăng ký Telegram Premium. Trang giá API liệt kê các sản phẩm, thời hạn đăng ký và mức giá đại lý hiện có.
Làm thế nào để nạp số dư cho đơn API?
Bạn có thể nạp thủ công trong tài khoản Gramix bằng cách sao chép địa chỉ ví và memo bắt buộc rồi gửi thanh toán. Hệ thống cũng có thể yêu cầu thông tin nạp qua API. Số dư sẽ tự động cập nhật sau khi giao dịch được xác nhận.
Theo dõi đơn hàng và thanh toán ở đâu?
Tài khoản Gramix hiển thị số dư hiện tại, khoản nạp, khấu trừ, hoàn tiền và danh sách đơn với người nhận, số tiền cùng trạng thái. Bạn cũng có thể truy vấn trạng thái qua API hoặc nhận qua webhook.
Vì sao đơn API không cần một khoản thanh toán riêng?
Chi phí đơn hàng được trừ từ số dư API trả trước. Bạn không cần tạo và xác nhận giao dịch thanh toán mới cho từng lần mua, vì vậy yêu cầu hợp lệ có thể được xử lý ngay.
Sẵn sàng tích hợp API Telegram Stars và Premium?
So sánh giá đại lý hiện tại, xem định dạng yêu cầu và tạo tài khoản để phát hành khóa API rồi bắt đầu tích hợp.