📢

Thông báo hệ thống

Hệ thống VietQR nạp tự động hoạt động 24/7.
Tích Hợp Hệ Thống

Tài Liệu SMM API v2 Protocol

✦ Standard Protocol v2.0 REST & Form-POST

Tài Liệu Tích Hợp API Dành Cho Reseller & Lập Trình Viên

Hệ thống hỗ trợ chuẩn giao thức SMM Panel API v2 tương thích 100% với các mã nguồn SMM, Bot Telegram, Cron job tự động hóa và các hệ thống mở rộng.

Base API URL (POST)
https://trumsmm.io.vn/api/v2
⚡ Giới hạn: 120 req/phút 📦 Format: JSON
Authentication

1. Giao Thức & Cơ Chế Xác Thực

Tất cả các yêu cầu API đều sử dụng phương thức HTTP POST (hoặc RESTful GET/POST tương ứng) gửi tới endpoint duy nhất hoặc REST endpoint. Để xác thực, bạn cần truyền tham số key trong form-data, JSON body hoặc gửi qua Header HTTP:

Form Data Parameter (Chuẩn SMM)
key = YOUR_API_KEY
HTTP Header (X-API-Key)
X-API-Key: YOUR_API_KEY
Bearer Token (REST)
Authorization: Bearer YOUR_API_KEY
Action 01

2. Lấy Danh Sách Dịch Vụ (Action: services)

POST /api/v2

Trả về toàn bộ danh sách dịch vụ mạng xã hội đang mở bán, bao gồm giá bán (Rate), giới hạn Min/Max, Phân loại và Nền tảng.

Tham sốKiểu dữ liệuBắt buộcMô tả
key String Bắt buộc Mã API Key cá nhân của bạn
action String Bắt buộc Giá trị cố định: services
[
  {
    "service": 1,
    "name": "Like Bài Viết Facebook Siêu Tốc (Bảo Hành 30 Ngày)",
    "type": "Default",
    "category": "Facebook Like Post",
    "rate": "15.00",
    "min": 50,
    "max": 50000,
    "refill": true,
    "cancel": false
  },
  {
    "service": 2,
    "name": "Follower TikTok Tài Khoản Thật Việt Nam",
    "type": "Default",
    "category": "TikTok Followers",
    "rate": "45.00",
    "min": 100,
    "max": 100000,
    "refill": true,
    "cancel": true
  }
]
Action 02

3. Tạo Đơn Hàng Mới (Action: add)

POST /api/v2

Khởi tạo đơn hàng tăng tương tác mới. Hệ thống sẽ tự động trừ số dư ví tương ứng và chuyển tới máy chủ xử lý tức thì.

Tham sốKiểu dữ liệuBắt buộcMô tả
key String Bắt buộc Mã API Key cá nhân của bạn
action String Bắt buộc Giá trị cố định: add
service Integer Bắt buộc ID của dịch vụ (Lấy từ action services)
link String Bắt buộc Link bài viết, video hoặc username tài khoản cần tăng
quantity Integer Bắt buộc Số lượng cần tăng (Phải nằm trong khoảng Min - Max)
runs Integer Tùy chọn Số lần lặp lại đơn hàng (Drip-feed runs)
interval Integer Tùy chọn Khoảng cách thời gian giữa các lần chạy (Tính bằng phút)
{
  "order": 104285
}
Action 03

4. Tra Cứu Trạng Thái 1 Đơn Hàng (Action: status)

POST /api/v2

Kiểm tra tiến độ xử lý của một đơn hàng cụ thể thông qua mã đơn order.

Tham sốKiểu dữ liệuBắt buộcMô tả
keyStringBắt buộcAPI Key của bạn
actionStringBắt buộcGiá trị: status
orderIntegerBắt buộcMã ID đơn hàng cần kiểm tra
{
  "charge": "15000.00",
  "start_count": "1250",
  "status": "In progress",
  "remains": "450",
  "currency": "VND"
}
Action 04

5. Tra Cứu Hàng Loạt Đơn Hàng (Action: status với orders)

POST /api/v2

Tra cứu trạng thái của nhiều đơn hàng cùng lúc, cách nhau bởi dấu phẩy (tối đa 100 đơn / lần gọi).

Tham sốKiểu dữ liệuBắt buộcMô tả
keyStringBắt buộcAPI Key của bạn
actionStringBắt buộcGiá trị: status
ordersStringBắt buộcDanh sách ID cách nhau dấu phẩy (ví dụ: 101,102,103)
{
  "101": {
    "charge": "25000.00",
    "start_count": "500",
    "status": "Completed",
    "remains": "0",
    "currency": "VND"
  },
  "102": {
    "charge": "12000.00",
    "start_count": "120",
    "status": "Processing",
    "remains": "880",
    "currency": "VND"
  },
  "103": {
    "error": "Incorrect order ID"
  }
}
Action 05

6. Kiểm Tra Số Dư Tài Khoản (Action: balance)

POST /api/v2

Tra cứu số dư khả dụng và loại tiền tệ đang lưu hành của tài khoản API.

{
  "balance": "850000.00",
  "currency": "VND"
}
Action 06

7. Yêu Cầu Bảo Hành (Refill)

Gửi yêu cầu bảo hành chạy bù cho đơn hàng nếu dịch vụ có hỗ trợ Refill.

Action: refillParam: order (Mã đơn)
Action: refill_statusParam: refill (Mã refill)
{
  "refill": 5821
}
Action 07

8. Yêu Cầu Hủy Đơn (Cancel)

Yêu cầu hủy đơn hàng nếu máy chủ dịch vụ chưa bắt đầu chạy.

Action: cancelParam: orders (Ví dụ: 101,102)
[
  {
    "order": 101,
    "cancel": 1
  }
]
SDK & Code Examples

💻 Mẫu Code Tích Hợp Các Ngôn Ngữ

Tạo đơn hàng mới bằng cURL bash:
# 1. Tạo đơn hàng mới
curl -X POST "https://trumsmm.io.vn/api/v2" \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://www.facebook.com/post/12345" \
  -d "quantity=1000"

# 2. Kiểm tra số dư tài khoản
curl -X POST "https://trumsmm.io.vn/api/v2" \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
Error Handling

⚠️ Bảng Mã Lỗi Phản Hồi (API Error Codes)

Khi yêu cầu không hợp lệ hoặc phát sinh lỗi, hệ thống sẽ trả về JSON chứa trường error hoặc error_code tương ứng:

Mã lỗi (error_code)Nội dung thông báo (error)Nguyên nhân & Cách khắc phục
invalid_key Invalid API key Mã API Key không chính xác hoặc đã bị làm mới / thu hồi.
disabled_account Account is locked or inactive Tài khoản của bạn đang bị tạm khóa hoặc chưa được kích hoạt.
rate_limited Too many requests Đã vượt quá giới hạn request/phút. Vui lòng giảm tần suất gửi request.
incorrect_action Incorrect action Tham số action không đúng trong danh sách cho phép.
incorrect_service Incorrect service ID ID dịch vụ không tồn tại hoặc đã tạm đóng bán.
incorrect_quantity Incorrect quantity (Min: x, Max: y) Số lượng đặt nằm ngoài khoảng tối thiểu / tối đa của dịch vụ.
insufficient_balance Not enough funds on balance Số dư ví tài khoản không đủ để thanh toán đơn hàng này.
incorrect_order Incorrect order ID Mã đơn hàng không tồn tại hoặc không thuộc quyền sở hữu của bạn.