Tài liệu kết nối api SMM tại dichvure.vn

Thông Tin API SMM V2

API URL: https://dichvure.vn/api/v2

HTTP Method: POST

Content-Type: application/x-www-form-urlencoded

Response: JSON

API Token:

API Token có thể thay đổi trong phần cài đặt tài khoản, vui lòng không chia sẻ cho bất kỳ ai

Thông tin quan trọng:

8 Actions hỗ trợ: services, add, balance, status, cancel, refill, refill_status, update_status
API chỉ nhận Content-Type: application/x-www-form-urlencoded (không phải JSON)
Truyền language: "vi" → VND, language: "en" → USD (mặc định)
Tỷ giá quy đổi: 1 USD = 25000 VND
Các action cancel, refill, status, update_status hỗ trợ xử lý nhiều đơn cùng lúc (tối đa 10)
Bảo hành đơn hàng chỉ được phép sau 24h hoàn thành
Đơn hàng "pending" hủy ngay và thu phí 200đ, đơn "processing" chuyển sang chờ hủy

POST Data

{
    "key": "APIKEY",
    "action": "services",
    "language": "vi"
}

Response

[
    {
        "service": 1,
        "name": "Like việt sale (nhanh)",
        "description": "Tốc độ 1-5k/ngày Lên ngay hoặc sau vài phút!",
        "type": "Default",
        "category": "Like bài viết",
        "platform": "Facebook",
        "rate": 0.0013228,
        "currency": "USD", 
        "min": 100,
        "max": 1000000000,
        "status": true,
        "refill": false,
        "cancel": false,
        "options": {
            "comments": 0,
            "reaction": 0,
            "multi_reaction": 0,
            "quantity": 0,
            "min_buy": 100,
            "max_buy": 1000000000,
            "refill": 0,
            "cancel": 0,
            "minutes": 0,
            "days": 0
        }
    }
]

POST Data

// Tạo đơn cơ bản:
{
    "key": "APIKEY",
    "action": "add",
    "service": 1,
    "link": "564456645645465",
    "quantity": 1000,
    "language": "vi"
}

// Custom Comments (quantity tự động = số dòng comment):
{
    "key": "APIKEY",
    "action": "add", 
    "service": 1,
    "link": "564456645645465", 
    "comments": "Comment 1\nComment 2\nComment 3",
    "language": "vi"
}

// Custom Reactions (chọn 1 loại cảm xúc):
{
    "key": "APIKEY",
    "action": "add",
    "service": 1,
    "link": "564456645645465",
    "quantity": 1000,
    "reaction": "love",
    "language": "vi"
}

// Custom Multi Reactions (chọn nhiều cảm xúc):
{
    "key": "APIKEY",
    "action": "add",
    "service": 1, 
    "link": "564456645645465",
    "quantity": 1000,
    "multi_reaction": ["like", "love", "haha", "care"],
    "language": "vi"
}

// Với Minutes (total_quantity = quantity * minutes):
{
    "key": "APIKEY",
    "action": "add",
    "service": 1,
    "link": "564456645645465",
    "quantity": 100,
    "minutes": 30,
    "language": "vi"
}

// Với Days (total_quantity = quantity * days):
{
    "key": "APIKEY",
    "action": "add", 
    "service": 1,
    "link": "564456645645465",
    "quantity": 100,
    "days": 7,
    "language": "vi"
}

// Đặt lịch chạy đơn hàng:
{
    "key": "APIKEY",
    "action": "add",
    "service": 1,
    "link": "564456645645465",
    "quantity": 1000,
    "scheduled_at": "2024-01-15 14:30",
    "language": "vi"
}

Response

// Thành công:
{
    "status": "success",
    "message": "Tạo đơn hàng thành công",
    "order": 7,
    "total_payment": 0.13228,
    "server_id": "1",
    "server_name": "Like việt sale (nhanh)",
    "order_code": "SMM68072A5376927",
    "currency": "USD"
}

// Lỗi:
{
    "error": "Số dư không đủ để thanh toán đơn hàng này",
    "status": "error",
    "message": "Số dư không đủ để thanh toán đơn hàng này"
}

Lưu ý:

Thời gian đặt lịch phải sau hiện tại ít nhất 5 phút
Với Custom Comments: quantity = số dòng comment
Với Minutes/Days: total_quantity = quantity × minutes/days
Reaction hỗ trợ: like, love, care, haha, angry, sad, wow

POST Data

{
    "key": "APIKEY",
    "action": "balance", 
    "language": "en"
}

Response

{
    "balance": 191.26472,
    "total_balance": 191.26472,
    "currency": "USD"
}

POST Data

// Kiểm tra một đơn hàng:
{
    "key": "APIKEY",
    "action": "status",
    "order": 196454546,
    "language": "vi"
}

// Kiểm tra nhiều đơn cùng lúc:
{
    "key": "APIKEY", 
    "action": "status",
    "orders": "1,2,3,4,5",
    "language": "vi"
}

Response

// Phản hồi đơn lẻ:
{
    "charge": "10000",
    "start_count": "10000", 
    "status": "Completed",
    "status_order": "completed",
    "remains": "569",
    "currency": "VND",
    "total_refund": "0",
    "success_count": "10431"
}

// Phản hồi nhiều đơn:
{
    "7": {
        "charge": 0.13228,
        "start_count": "0",
        "status": "Processing", 
        "status_order": "processing",
        "remains": 100,
        "currency": "USD",
        "total_refund": "0",
        "success_count": "0"
    },
    "666": {
        "order": 666,
        "error": "Incorrect order ID",
        "status": "error",
        "message": "Incorrect order ID"
    }
}

POST Data

// Hủy nhiều đơn cùng lúc:
{
    "key": "APIKEY", 
    "action": "cancel",
    "orders": "1,2,3,4,5",
    "language": "vi"
}

Response

// Response array cho nhiều đơn:
[
    {
        "order": 1,
        "cancel": 1,
        "status": "success",
        "message": "Hủy đơn thành công"
    },
    {
        "cancel": {
            "error": "Đơn hàng không thể hủy"
        },
        "status": "error",
        "message": "Đơn hàng không thể hủy"
    },
    {
        "cancel": {
            "error": "Dịch vụ không hỗ trợ hủy đơn"
        },
        "status": "error",
        "message": "Dịch vụ không hỗ trợ hủy đơn"
    }
]

Lưu ý:

Đơn hàng trạng thái "pending" sẽ hủy ngay và thu phí 200đ
Đơn "processing" sẽ chuyển sang chờ hủy (status_cancel = pending)
Chỉ hỗ trợ hủy nhiều đơn cùng lúc (orders parameter)

POST Data

// Bảo hành một đơn:
{
    "key": "APIKEY",
    "action": "refill",
    "order": 196454546,
    "language": "vi"
}

// Bảo hành nhiều đơn cùng lúc:
{
    "key": "APIKEY", 
    "action": "refill",
    "orders": "1,2,3,4,5",
    "language": "vi"
}

Response

// Đơn lẻ - Thành công:
{
    "status": "success",
    "message": "Đã nhận được yêu cầu bảo hành, nếu bảo hành hoàn tất status đơn hàng sẽ được cập nhật",
    "order": 196454546,
    "order_code": "SMM68072A5376927",
    "refill": 196454546
}

// Đơn lẻ - Lỗi:
{
    "refill": {
        "error": "Đơn hàng phải hoàn thành đủ 24 giờ mới có thể bảo hành"
    },
    "status": "error",
    "message": "Đơn hàng phải hoàn thành đủ 24 giờ mới có thể bảo hành"
}

// Nhiều đơn - Response:
[
    {
        "order": 1,
        "order_code": "SMM123",
        "refill": 1,
        "status": "success",
        "message": "Đã nhận được yêu cầu bảo hành"
    }
]

Điều kiện bảo hành:

Đơn hàng phải hoàn thành (status = completed)
Dịch vụ phải hỗ trợ bảo hành (can_refill = true)
Đã đủ 24 giờ từ khi hoàn thành

POST Data

// Kiểm tra một đơn:
{
    "key": "APIKEY",
    "action": "refill_status",
    "refill": 196454546,
    "language": "vi"
}

// Kiểm tra nhiều đơn cùng lúc:
{
    "key": "APIKEY", 
    "action": "refill_status",
    "orders": "1,2,3,4,5",
    "language": "vi"
}

Response

// Đơn lẻ - Các trạng thái:
{
    "refill": 196454546,
    "status": "Pending",
    "message": "Lấy trạng thái bảo hành thành công"
}

{
    "refill": 196454546,
    "status": "Processing",
    "message": "Lấy trạng thái bảo hành thành công"
}

{
    "refill": 196454546,
    "status": "Completed",
    "message": "Lấy trạng thái bảo hành thành công"
}

// Nhiều đơn - Response:
[
    {
        "refill": 1,
        "status": "Pending",
        "message": "Lấy trạng thái bảo hành thành công"
    }
]

Trạng thái bảo hành: none → pending → processing → completed

POST Data

// Cập nhật nhiều đơn cùng lúc:
{
    "key": "APIKEY", 
    "action": "update_status",
    "orders": "1,2,3,4,5",
    "language": "vi"
}

Response

// Response array cho nhiều đơn:
[
    {
        "status": "success",
        "message": "Đã cập nhật trạng thái đơn hàng"
    },
    {
        "status": "error",
        "message": "Đơn hàng không tồn tại"
    },
    {
        "status": "error",
        "message": "Trạng thái đơn hàng không thể cập nhật"
    }
]

Lưu ý:

Chỉ đơn hàng trạng thái "processing" mới có thể cập nhật trạng thái
Chỉ hỗ trợ cập nhật nhiều đơn cùng lúc (orders parameter)
API sẽ gọi provider để kiểm tra trạng thái mới nhất

PHP Example


$url = 'https://dichvure.vn/api/v2';

// POST data as form-encoded (not JSON!)
$data = [
    "key" => 'APIKEY',
    "action" => 'add', // services, balance, status, add, cancel, refill, refill_status, update_status
    "language" => 'vi', // vi=VND, en=USD (default)
    "service" => 1, // ID server từ API services
    "link" => "564456645645465", // URL hoặc ID
    "quantity" => 100, // Số lượng
    
    // Optional - tùy theo loại service:
    "comments" => "Comment 1\nComment 2\nComment 3", // Custom Comments
    "reaction" => "love", // Custom Reactions: like,love,care,haha,angry,sad,wow
    "multi_reaction" => ["like", "love", "haha"], // Custom Multi Reactions (array)
    "minutes" => 30, // Với service có minutes option
    "days" => 7, // Với service có days option
    "scheduled_at" => "2024-01-15 14:30", // Đặt lịch chạy đơn
    
    // Cho actions khác:
    "orders" => "1,2,3,4,5", // Multi orders cho status, cancel, refill, update_status
    "refill" => 123456, // Cho refill_status
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data)); // Form-encoded!
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/x-www-form-urlencoded']);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Lỗi cURL: ' . curl_error($ch);
} else {
    $result = json_decode($response, true);
    echo 'Response: ' . print_r($result, true);
}
curl_close($ch);

Response

// Thành công:
{
    "status": "success",
    "message": "Tạo đơn hàng thành công",
    "order": 7,
    "total_payment": 0.13228,
    "server_id": "1",
    "server_name": "Like việt sale (nhanh)",
    "order_code": "SMM68072A5376927",
    "currency": "USD"
}

// Lỗi:
{
    "error": "Số dư không đủ để thanh toán đơn hàng này"
}

Đã copy thành công!

Switcher

Valex Video call

Daneil Scott

Calling...

Valex Voice call

Daneil Scott

Calling...

API SMM V2

Thông Tin API SMM V2